{"id":13578519,"url":"https://github.com/hynek/environ-config","last_synced_at":"2026-04-02T02:17:33.445Z","repository":{"id":15657537,"uuid":"78542157","full_name":"hynek/environ-config","owner":"hynek","description":"Python Application Configuration With Environment Variables","archived":false,"fork":false,"pushed_at":"2026-03-01T15:01:20.000Z","size":439,"stargazers_count":463,"open_issues_count":3,"forks_count":26,"subscribers_count":8,"default_branch":"main","last_synced_at":"2026-03-01T18:22:11.693Z","etag":null,"topics":["12-factor","config","configuration","env","environment","environment-variables","environment-vars","python"],"latest_commit_sha":null,"homepage":"https://environ-config.readthedocs.io/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hynek.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"hynek","tidelift":"pypi/environ-config"}},"created_at":"2017-01-10T14:41:13.000Z","updated_at":"2026-03-01T15:01:21.000Z","dependencies_parsed_at":"2023-09-28T03:58:12.943Z","dependency_job_id":"37c44835-45ab-4281-b3e5-d5ace39fe699","html_url":"https://github.com/hynek/environ-config","commit_stats":{"total_commits":311,"total_committers":16,"mean_commits":19.4375,"dds":0.2572347266881029,"last_synced_commit":"ab93161b9a3d624712e87ce41d9b54039a9746ff"},"previous_names":["hynek/environ_config"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/hynek/environ-config","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hynek%2Fenviron-config","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hynek%2Fenviron-config/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hynek%2Fenviron-config/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hynek%2Fenviron-config/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hynek","download_url":"https://codeload.github.com/hynek/environ-config/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hynek%2Fenviron-config/sbom","scorecard":{"id":475121,"data":{"date":"2025-08-11","repo":{"name":"github.com/hynek/environ-config","commit":"4f0fcd20024b36be528723f804a988dde664a9af"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":7.3,"checks":[{"name":"Maintained","score":10,"reason":"14 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Code-Review","score":0,"reason":"Found 2/21 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Security-Policy","score":10,"reason":"security policy file detected","details":["Info: security policy file detected: .github/SECURITY.md:1","Info: Found linked content: .github/SECURITY.md:1","Info: Found disclosure, vulnerability, and/or timelines in security policy: .github/SECURITY.md:1","Info: Found text in security policy: .github/SECURITY.md:1"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":9,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Info: jobLevel 'actions' permission set to 'read': .github/workflows/codeql-analysis.yml:16","Info: jobLevel 'contents' permission set to 'read': .github/workflows/codeql-analysis.yml:17","Info: found token with 'none' permissions: .github/workflows/ci.yml:1","Info: topLevel 'contents' permission set to 'read': .github/workflows/codeql-analysis.yml:9","Warn: no topLevel permission defined: .github/workflows/pypi-package.yml:1","Info: topLevel 'contents' permission set to 'read': .github/workflows/zizmor.yml:11","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:102: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:107: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/ci.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:110: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:112: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:131: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:149: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:154: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/ci.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:158: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:169: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:174: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/ci.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:184: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:196: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:199: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/ci.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:220: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:23: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:26: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/ci.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:29: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:38: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/ci.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:43: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:64: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:71: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/ci.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:75: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:87: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/ci.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/codeql-analysis.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:32: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/codeql-analysis.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:37: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/codeql-analysis.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql-analysis.yml:40: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/codeql-analysis.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pypi-package.yml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/pypi-package.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/pypi-package.yml:29: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/pypi-package.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pypi-package.yml:47: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/pypi-package.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/pypi-package.yml:53: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/pypi-package.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pypi-package.yml:72: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/pypi-package.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/pypi-package.yml:78: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/pypi-package.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/zizmor.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/zizmor.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/zizmor.yml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/zizmor.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/zizmor.yml:33: update your workflow using https://app.stepsecurity.io/secureworkflow/hynek/environ-config/zizmor.yml/main?enable=pin","Info:   0 out of  25 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of  11 third-party GitHubAction dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: Apache License 2.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Packaging","score":10,"reason":"packaging workflow detected","details":["Info: Project packages its releases by way of GitHub Actions.: .github/workflows/pypi-package.yml:35"],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"SAST","score":9,"reason":"SAST tool detected but not run on all commits","details":["Info: SAST configuration detected: CodeQL","Warn: 11 commits out of 14 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-19T15:05:42.443Z","repository_id":15657537,"created_at":"2025-08-19T15:05:42.443Z","updated_at":"2025-08-19T15:05:42.443Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31294501,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T01:43:37.129Z","status":"online","status_checked_at":"2026-04-02T02:00:08.535Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["12-factor","config","configuration","env","environment","environment-variables","environment-vars","python"],"created_at":"2024-08-01T15:01:31.377Z","updated_at":"2026-04-02T02:17:33.437Z","avatar_url":"https://github.com/hynek.png","language":"Python","funding_links":["https://github.com/sponsors/hynek","https://tidelift.com/funding/github/pypi/environ-config","https://tidelift.com/?utm_source=lifter\u0026utm_medium=referral\u0026utm_campaign=hynek"],"categories":["Python"],"sub_categories":[],"readme":"# *environ-config*: Application Configuration With Env Variables\n\n[![Documentation](https://img.shields.io/badge/Docs-Read%20The%20Docs-black)](https://environ-config.readthedocs.io/)\n[![License: Apache 2.0](https://img.shields.io/badge/license-Apache--2.0-C06524)](https://github.com/hynek/environ-config/blob/main/LICENSE)\n[![PyPI version](https://img.shields.io/pypi/v/environ-config)](https://pypi.org/project/environ-config/)\n[![Downloads / Month](https://static.pepy.tech/personalized-badge/environ-config?period=month\u0026units=international_system\u0026left_color=grey\u0026right_color=blue\u0026left_text=Downloads%20/%20Month)](https://pepy.tech/project/environ-config)\n\n\u003c!-- teaser-begin --\u003e\n\n*environ-config* allows you to load your application's configuration from environment variables – as recommended in [*The Twelve-Factor App*](https://12factor.net/config) methodology – with elegant, boilerplate-free, and declarative code:\n\n```pycon\n\u003e\u003e\u003e import environ\n\u003e\u003e\u003e # Extracts secrets from Vault-via-envconsul: 'secret/your-app':\n\u003e\u003e\u003e vault = environ.secrets.VaultEnvSecrets(vault_prefix=\"SECRET_YOUR_APP\")\n\u003e\u003e\u003e @environ.config(prefix=\"APP\")\n... class AppConfig:\n...    @environ.config\n...    class DB:\n...        name = environ.var(\"default_db\")\n...        host = environ.var(\"default.host\")\n...        port = environ.var(5432, converter=int)  # Use attrs's converters and validators!\n...        user = environ.var(\"default_user\")\n...        password = vault.secret()\n...\n...    env = environ.var()\n...    lang = environ.var(name=\"LANG\")  # It's possible to overwrite the names of variables.\n...    db = environ.group(DB)\n...    awesome = environ.bool_var()\n\u003e\u003e\u003e cfg = environ.to_config(\n...     AppConfig,\n...     environ={\n...         \"APP_ENV\": \"dev\",\n...         \"APP_DB_HOST\": \"localhost\",\n...         \"LANG\": \"C\",\n...         \"APP_AWESOME\": \"yes\",  # true and 1 work too, everything else is False\n...         # Vault-via-envconsul-style var name:\n...         \"SECRET_YOUR_APP_DB_PASSWORD\": \"s3kr3t\",\n... })  # Uses os.environ by default.\n\u003e\u003e\u003e cfg\nAppConfig(env='dev', lang='C', db=AppConfig.DB(name='default_db', host='localhost', port=5432, user='default_user', password=\u003cSECRET\u003e), awesome=True)\n\u003e\u003e\u003e cfg.db.password\n's3kr3t'\n\n```\n\n`AppConfig.from_environ({...})` is equivalent to the code above, depending on your taste.\n\n\n## Features\n\n- Declarative \u0026 boilerplate-free.\n\n- Nested configuration from flat environment variable names.\n\n- Default \u0026 mandatory values: enforce configuration structure without writing a line of code.\n\n- Built on top of [*attrs*](https://www.attrs.org/) which gives you data validation and conversion for free.\n\n- Pluggable secrets extraction.\n  Ships with:\n\n  - [HashiCorp Vault](https://www.vaultproject.io) support via [*envconsul*](https://github.com/hashicorp/envconsul).\n  - [AWS Secrets Manager](https://aws.amazon.com/secrets-manager/) (needs [*boto3*](https://pypi.org/project/boto3/))\n  - INI files, because secrets in env variables are [icky](https://blog.diogomonica.com/2017/03/27/why-you-shouldnt-use-env-variables-for-secret-data/).\n\n- Helpful debug logging that will tell you which variables are present and what *environ-config* is looking for.\n\n- Built-in dynamic help documentation generation.\n\n\u003c!-- teaser-end --\u003e\n\nYou can find the full documentation including a step-by-step tutorial on [Read the Docs](https://environ-config.readthedocs.io/).\n\n\n## Project Information\n\n*environ-config* is maintained by [Hynek Schlawack](https://hynek.me/) and is released under the [Apache License 2.0](https://github.com/hynek/environ-config/blob/main/LICENSE) license.\nDevelopment takes place on [GitHub](https://github.com/hynek/environ-config).\n\nThe development is kindly supported by [Variomedia AG](https://www.variomedia.de/) and all my amazing [GitHub Sponsors](https://github.com/sponsors/hynek).\n\n*environ-config* wouldn't be possible without the [*attrs* project](https://www.attrs.org).\n\n\n## *environ-config* for Enterprise\n\nAvailable as part of the [Tidelift Subscription](https://tidelift.com/?utm_source=lifter\u0026utm_medium=referral\u0026utm_campaign=hynek).\n\nThe maintainers of *environ-config* and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source packages you use to build your applications.\nSave time, reduce risk, and improve code health, while paying the maintainers of the exact packages you use.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhynek%2Fenviron-config","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhynek%2Fenviron-config","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhynek%2Fenviron-config/lists"}