Управление конфигурацией приложений на Python

Как получить настройки из системных переменных окружения без внешних библиотек?

Модуль os предоставляет простой способ: функции os.environ.get() или os.getenv().

import os

app_name = os.getenv('APP_NAME', 'DefaultApp')
debug = os.getenv('DEBUG', 'false').lower() == 'true'
database_url = os.environ.get('DATABASE_URL')
if not database_url:
    raise ValueError('DATABASE_URL must be set')

Path python (путь к python)

Этот подход не требует установки дополнительных библиотек, но все значения являются строками, и требуется ручное преобразование типов.

Как использовать стандартный модуль configparser для ini-файлов?

ConfigParser удобен для конфигурационных файлов в стиле INI, популярных в Windows.

import configparser

config = configparser.ConfigParser()
config.read('config.ini')

app_name = config.get('DEFAULT', 'AppName', fallback='MyApp')
debug = config.getboolean('DEFAULT', 'Debug', fallback=False)
database_url = config.get('Database', 'url')

Python environment path (путь к окружению python)

Файл config.ini:

[DEFAULT]
AppName = MyApp
Debug = false

[Database]
url = sqlite:///db.sqlite3

Python windows paths (работа с путями в python на windows)

Плюсы: встроенный модуль, поддержка секций, автоматическое преобразование boolean. Минусы: только строки и числа, нет поддержки вложенных структур.

Как организовать конфигурацию в формате YAML?

Библиотека PyYAML позволяет загружать настройки из YAML-файлов, поддерживающих списки, словари и комментарии.

import yaml

with open('config.yaml', 'r') as f:
    config = yaml.safe_load(f)

app_name = config.get('app', {}).get('name', 'MyApp')
debug = config.get('app', {}).get('debug', False)
database_url = config.get('database', {}).get('url')
print(config)

Python файлы настроек (файлы конфигурации в python)

Файл config.yaml:

app:
  name: MyApp
  debug: false
database:
  url: postgresql://localhost/db

Open python 2 (запуск python 2)

Важно использовать safe_load для предотвращения выполнения произвольного кода.

Как хранить настройки в JSON?

JSON - простой и распространённый формат. Чтение через стандартный модуль json.

import json

with open('config.json', 'r') as f:
    config = json.load(f)

app_name = config.get('app_name', 'MyApp')
debug = config.get('debug', False)
database_url = config.get('database_url')
print(config)

Python online interpreter (онлайн интерпретатор python)

Файл config.json:

{
  "app_name": "MyApp",
  "debug": false,
  "database_url": "sqlite:///db.sqlite3"
}

Using python pip (установка пакетов через pip в python)

JSON не поддерживает комментарии и не допускает лишних запятых.

Как использовать TOML для конфигурации Python приложений?

TOML - формат, используемый в экосистеме Python (pyproject.toml). Для чтения применяется модуль tomllib (Python 3.11+) или сторонняя библиотека tomli.

import tomllib  # или import tomli для старых версий

with open('config.toml', 'rb') as f:
    config = tomllib.load(f)

app_name = config.get('app', {}).get('name', 'MyApp')
debug = config.get('app', {}).get('debug', False)
database_url = config.get('database', {}).get('url')
print(config)

Python interpreter (интерпретатор python)

Файл config.toml:

[app]
name = "MyApp"
debug = false

[database]
url = "sqlite:///db.sqlite3"

Python добавить путь (добавление пути в sys.path в python)

TOML поддерживает типы: строки, числа, даты, вложенные таблицы.

Как передавать настройки через аргументы командной строки?

Модуль argparse позволяет определить параметры запуска, которые переопределяют настройки из файлов или окружения.

import argparse

parser = argparse.ArgumentParser()
parser.add_argument('--app-name', default='MyApp')
parser.add_argument('--debug', action='store_true')
parser.add_argument('--database-url', required=True)

args = parser.parse_args()

app_name = args.app_name
debug = args.debug
database_url = args.database_url
print(f"{app_name=}, {debug=}, {database_url=}")

Вызов: python app.py --app-name Demo --database-url postgres://...

Аргументы полезны для временных изменений, не требующих редактирования файлов.