{"library":"pyaml-env","title":"Pyaml-env: YAML with Environment Variable Resolution","description":"Pyaml-env provides a straightforward way to parse YAML configuration files, automatically resolving environment variables denoted by the `!ENV` tag. It's built on top of PyYAML and is currently at version 1.2.2. The library maintains an active release cadence, with updates typically addressing bug fixes, dependency compatibility, and feature enhancements a few times a year.","language":"python","status":"active","last_verified":"Sun May 17","install":{"commands":["pip install pyaml-env"],"cli":null},"imports":["from pyaml_env import parse_config"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import os\nfrom pyaml_env import parse_config\n\n# Simulate setting environment variables\nos.environ['API_KEY'] = 'your_secret_api_key'\nos.environ['DEBUG_MODE'] = 'true'\nos.environ['DB_PORT'] = '5432'\n\n# Create a dummy YAML file for demonstration\nconfig_content = \"\"\"\napi_config:\n  key: !ENV API_KEY\n  endpoint: https://api.example.com/v1\ndebug:\n  enabled: !ENV DEBUG_MODE:false # 'false' is default if DEBUG_MODE is not set\ndatabase:\n  host: localhost\n  port: !ENV DB_PORT:3306 # '3306' is default if DB_PORT is not set\n  user: !ENV DB_USER:default_user # 'default_user' is default if DB_USER is not set\nlogging:\n  level: INFO\n\"\"\"\nwith open('config.yaml', 'w') as f:\n    f.write(config_content)\n\n# Parse the configuration file\nconfig = parse_config('config.yaml')\n\n# Access resolved configuration values\nprint(f\"API Key: {config['api_config']['key']}\")\nprint(f\"Debug Enabled: {config['debug']['enabled']} (type: {type(config['debug']['enabled'])})\")\nprint(f\"Database Port: {config['database']['port']} (type: {type(config['database']['port'])})\")\nprint(f\"Database User: {config['database']['user']}\")\n\n# Clean up the dummy file and environment variables\nos.remove('config.yaml')\ndel os.environ['API_KEY']\ndel os.environ['DEBUG_MODE']\ndel os.environ['DB_PORT']\nif 'DB_USER' in os.environ: # Only delete if it was actually set by this script or existed before\n    del os.environ['DB_USER']\n","lang":"python","description":"This quickstart demonstrates how to load a YAML configuration file with embedded `!ENV` tags. It shows how environment variables are resolved and how to provide default values using a colon (`:`) separator. It also illustrates accessing the parsed configuration and cleans up after execution.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-17","installed_version":"1.2.2","pypi_latest":"1.2.2","is_stale":false,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":1.8,"avg_import_s":0.15,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"pyaml-env","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.09,"mem_mb":1.4,"disk_size":"20.0M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"pyaml-env","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.7,"import_time_s":0.06,"mem_mb":1.4,"disk_size":"21M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"pyaml-env","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.27,"mem_mb":1.7,"disk_size":"22.0M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"pyaml-env","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":2,"import_time_s":0.26,"mem_mb":1.7,"disk_size":"23M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"pyaml-env","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.16,"mem_mb":1.4,"disk_size":"13.9M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"pyaml-env","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.6,"import_time_s":0.18,"mem_mb":1.4,"disk_size":"15M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"pyaml-env","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.15,"mem_mb":1.5,"disk_size":"13.7M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"pyaml-env","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.6,"import_time_s":0.17,"mem_mb":1.3,"disk_size":"15M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"pyaml-env","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.08,"mem_mb":1.4,"disk_size":"19.5M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"pyaml-env","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.9,"import_time_s":0.08,"mem_mb":1.4,"disk_size":"21M"}]}}