تنزيل dynaconf - تنزيل كود مصدر dynaconf

dynaconf

بايثون

3.2.6

تنزيل

سمات

مستوحاة من دليل التطبيق المكون من 12 عاملًا
إدارة الإعدادات (القيم الافتراضية، والتحقق من الصحة، والتحليل، والقوالب)
حماية المعلومات الحساسة (كلمات المرور/الرموز المميزة)
تنسيقات ملفات متعددة toml|yaml|json|ini|py وأيضًا أدوات تحميل قابلة للتخصيص.
الدعم الكامل لمتغيرات البيئة لتجاوز الإعدادات الموجودة (يتضمن دعم dotenv).
نظام متعدد الطبقات اختياري لبيئات متعددة [default, development, testing, production]
دعم مدمج لـ Hashicorp Vault وRedis كإعدادات وتخزين أسرار.
ملحقات مدمجة لأطر الويب Django و Flask .
واجهة سطر الأوامر (CLI) للعمليات الشائعة مثل init, list, write, validate, export .
المستندات الكاملة على https://dynaconf.com

ثَبَّتَ

$ pip install dynaconf

تهيئة Dynaconf على الدليل الجذر للمشروع

 $ cd path/to/your/project/

$ dynaconf init -f toml

  Configuring your Dynaconf environment
------------------------------------------
? The file `config.py` was generated.

?️  settings.toml created to hold your settings.

? .secrets.toml created to hold your secrets.

? the .secrets.* is also included in `.gitignore`
  beware to not push your secrets to a public repo.

? Dynaconf is configured! read more on https://dynaconf.com

تلميح: يمكنك تحديد toml|yaml|json|ini|py على dynaconf init -f <fileformat> toml هو التنسيق الافتراضي وهو أيضًا التنسيق الموصى به للتكوين.

يقوم Dynaconf init بإنشاء الملفات التالية

 .
├── config.py       # This is from where you import your settings object (required)
├── .secrets.toml   # This is to hold sensitive data like passwords and tokens (optional)
└── settings.toml   # This is to hold your application settings (optional)

في الملف config.py Dynaconf init، يُنشئ النموذج المعياري التالي

 from dynaconf import Dynaconf

settings = Dynaconf (
    envvar_prefix = "DYNACONF" ,  # export envvars with `export DYNACONF_FOO=bar`.
    settings_files = [ 'settings.yaml' , '.secrets.yaml' ],  # Load files in the given order.
)

نصيحة: يمكنك إنشاء الملفات بنفسك بدلاً من استخدام الأمر init كما هو موضح أعلاه ويمكنك إعطاء أي اسم تريده بدلاً من config.py الافتراضي (يجب أن يكون الملف في مسار python القابل للاستيراد) - شاهد المزيد من الخيارات التي يمكنك القيام بها انتقل إلى مُهيئ فئة Dynaconf على https://dynaconf.com

باستخدام Dynaconf

ضع إعداداتك على settings.{toml|yaml|ini|json|py}

 username = " admin "
port = 5555
database = { name = ' mydb ' , schema = ' main ' }

ضع معلومات حساسة على .secrets.{toml|yaml|ini|json|py}

 password = " secret123 "

هام: يضع أمر dynaconf init ملف .secrets.* في .gitignore الخاص بك لتجنب كشفه في عمليات إعادة الشراء العامة ولكن تقع على عاتقك مسؤولية الحفاظ عليه آمنًا في بيئتك المحلية، كما أن التوصية لبيئات الإنتاج هي استخدام المدمج- لدعم خدمة Hashicorp Vault لكلمات المرور والرموز المميزة.

اختياريًا، يمكنك الآن استخدام متغيرات البيئة لتجاوز القيم لكل تنفيذ أو لكل بيئة.

 # override `port` from settings.toml file and automatically casts as `int` value.
export DYNACONF_PORT=9900

في التعليمات البرمجية الخاصة بك، قم باستيراد كائن settings

 from path . to . project . config import settings

# Reading the settings

settings . username == "admin"  # dot notation with multi nesting support
settings . PORT == 9900  # case insensitive
settings [ 'password' ] == "secret123"  # dict like access
settings . get ( "nonexisting" , "default value" )  # Default values just like a dict
settings . databases . name == "mydb"  # Nested key traversing
settings [ 'databases.schema' ] == "main"  # Nested key traversing