کتابخانه‌ی استاندارد · کدگذاری و داده

پرونده محیط `encoding/envfile`

خواندن و نوشتن پرونده‌های .env با جایگذاری متغیرها.

واردسازی کدگذاری.پرونده محیط

در این صفحه

گونه‌ها
روال‌ها

پرونده‌ی .env متغیرهای محیطی برنامه را، هر کدام در یک خط KEY=value، نگه می‌دارد. این بسته خط‌های خالی و توضیح‌های # را رد می‌کند، export پیش از کلید را می‌پذیرد، نقل‌قول‌ها را برمی‌دارد و ترتیب کلیدها را حفظ می‌کند.

تجزیه ارجاع‌هایی مثل ${HOST} را با مقدار همان پرونده جایگذاری می‌کند؛ تجزیه خام آن‌ها را دست‌نخورده نگه می‌دارد. متغیرهای محیطی سیستم‌عامل خوانده نمی‌شوند؛ برای آن‌ها بسته‌ی محیط را ببینید.

گونه‌ها

سند `Doc`

ساختار سند

محتوای یک پرونده‌ی محیط.

نام	انگلیسی	گونه	توضیح
m	`m`	`collections.OrderedMap`	کلیدها و مقدارها به ترتیب.
flags	`flags`	`وکتور<صحیح>`	برای هر کلید، آیا مقدارش جایگذاری‌پذیر است (نقل‌قول تکی جایگذاری را غیرفعال می‌کند).

encoding-envfile-Parse.salam

واردسازی کدگذاری.پرونده محیط
واردسازی کدگذاری.خطای کدگذاری

روال ریشه:
    متن := "# تنظیمات\nHOST=localhost\nPORT=8080\nexport NAME=\"سلام دنیا\"\nURL=http://${HOST}:${PORT}/\n"
    ناپایا س := پرونده محیط.تجزیه(متن)
    سرچاپ پرونده محیط.طول(س)، پرونده محیط.کلیدها(س)
    سرچاپ پرونده محیط.دریافت(س، "NAME")، پرونده محیط.دارد(س، "DEBUG")، پرونده محیط.دریافت با پیش فرض(س، "DEBUG"، "false")
    سرچاپ پرونده محیط.کلید در(س، ۰)، پرونده محیط.مقدار در(س، ۱)
    سرچاپ پرونده محیط.دریافت(س، "URL")
    خام := پرونده محیط.تجزیه خام(متن)
    سرچاپ پرونده محیط.دریافت(خام، "URL")، پرونده محیط.نام‌های ارجاع(خام)
    ناپایا پایه := پرونده محیط.جدید()
    گسترده := پرونده محیط.گسترش سند(خام، پایه)
    سرچاپ پرونده محیط.دریافت(گسترده، "URL")
    سرچاپ پرونده محیط.گسترش("${HOST}/api"، س، پایه)، پرونده محیط.نام‌های ارجاع در("$A و ${B}")
    پرونده محیط.تنظیم(س، "DEBUG"، "true")
    سرچاپ پرونده محیط.حذف(س، "URL")
    سرچاپ پرونده محیط.قالب(س)
    سرچاپ پرونده محیط.قالب صادراتی(پایه) == ""، پرونده محیط.نقل قول("a b")
    ناپایا دیگر := پرونده محیط.تجزیه("PORT=9090\nMODE=prod\n")
    پرونده محیط.ادغام در(س، دیگر)
    سرچاپ پرونده محیط.دریافت(س، "PORT")، پرونده محیط.دریافت(س، "MODE")
    ناپایا خ := خطای کدگذاری.بدون خطا()
    _ := پرونده محیط.تجزیه سخت گیرانه("=بی‌کلید\n"، خ)
    سرچاپ خطای کدگذاری.خطا است(خ)، پرونده محیط.معتبر("A=1\n")
    سرچاپ پرونده محیط.تجزیه مقدار(`"a\tb"`)، پرونده محیط.تجزیه مقدار گسترده("x ; comment"، درست)
    پرونده محیط.آزادسازی(س)
    پرونده محیط.آزادسازی(خام)
    پرونده محیط.آزادسازی(پایه)
    پرونده محیط.آزادسازی(گسترده)
    پرونده محیط.آزادسازی(دیگر)
پایان

خروجی4 ["HOST", "PORT", "NAME", "URL"] سلام دنیا false false HOST 8080 http://localhost:8080/ http://${HOST}:${PORT}/ ["HOST", "PORT"] http://localhost:8080/ localhost/api ["A", "B"] true HOST=localhost PORT=8080 NAME="سلام دنیا" DEBUG=true true "a b" 9090 prod true true a b x