{"id":20618184,"url":"https://github.com/tddschn/envchain-shellenv","last_synced_at":"2025-04-15T11:37:32.835Z","repository":{"id":65420171,"uuid":"496434427","full_name":"tddschn/envchain-shellenv","owner":"tddschn","description":"envchain-shellenv - prints export statements for your secrets in the keychain","archived":false,"fork":false,"pushed_at":"2024-08-03T23:11:13.000Z","size":124,"stargazers_count":6,"open_issues_count":2,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-23T18:47:20.543Z","etag":null,"topics":["envchain","environment-variables","keychain","keyring","secrets","shell"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/envchain-shellenv","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tddschn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-05-26T00:48:06.000Z","updated_at":"2025-02-18T14:58:35.000Z","dependencies_parsed_at":"2024-08-04T00:32:56.168Z","dependency_job_id":null,"html_url":"https://github.com/tddschn/envchain-shellenv","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tddschn%2Fenvchain-shellenv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tddschn%2Fenvchain-shellenv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tddschn%2Fenvchain-shellenv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tddschn%2Fenvchain-shellenv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tddschn","download_url":"https://codeload.github.com/tddschn/envchain-shellenv/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249061814,"owners_count":21206568,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["envchain","environment-variables","keychain","keyring","secrets","shell"],"created_at":"2024-11-16T12:07:30.185Z","updated_at":"2025-04-15T11:37:32.765Z","avatar_url":"https://github.com/tddschn.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# envchain shellenv\n\nInjecting secrets from envchain / keychain into your shell as environment variables, in batch.\n\n`envchain-shellenv` - prints export statements for your secrets in the keychain\n\nso that you can do `eval \"$(envchain-shellenv)\"`.\n\nUse with [`envchain`](https://github.com/sorah/envchain) for maximum convenience.\n\n- [envchain shellenv](#envchain-shellenv)\n  - [Quick Start](#quick-start)\n  - [Installation](#installation)\n    - [Prerequisites](#prerequisites)\n    - [pipx](#pipx)\n    - [pip](#pip)\n  - [Usage:](#usage)\n  - [Example](#example)\n    - [Example config file](#example-config-file)\n  - [Develop](#develop)\n  - [See Also](#see-also)\n\n## Quick Start\n```bash\n# install envchain first, and add your secrets to your keychain app via envchain\n# for macOS with Homebrew, run `brew install envchain'.\n# see https://github.com/sorah/envchain for more details.\n\n# install envchain-shellenv\npipx install envchain-shellenv || pip install envchain-shellenv\n\n# creates an example config at ~/.config/envchain-shellenv/keychain.ini\nenvchain-shellenv --create-example-config\n# edit config file with your favorite editor\nvim ~/.config/envchain-shellenv/keychain.ini\n\n# export your envchain secrets in the current shell\neval \"$(envchain-shellenv)\"\n# optionally add this line to your shell startup file\n```\n\n## Installation\n\n### Prerequisites\n- Required:\n  - [`envchain`](https://github.com/sorah/envchain)\n- Optional:\n  - [`keyring`](https://github.com/jaraco/keyring)\n\n    `keyring` is installed by default if you install `envchain-shellenv` with pipx.\n\n    To use keyring when installing with `pip`, do `pip install 'envchain-shellenv[keyring]'`.\n\n### pipx\n\nThis is the recommended installation method.\n\n```\n$ pipx install envchain-shellenv\n```\n\n### [pip](https://pypi.org/project/envchain-shellenv/)\n\n```\n$ pip install envchain-shellenv\n```\n\n## Usage:\n\n`envchain-shellenv` prints export statements for your secrets in the keychain,\n\nwhen you need your secrets in your shell env, just do `eval \"$(envchain-shellenv)\"`.\n\n```\n$ eesh -h # `eesh' is just an alias for `envchain-shellenv', you can use either.\n\nusage: envchain-shellenv [-h] [-c CONFIG] [--create-example-config] [-u {envchain,keyring}] [--version]\n\nenvchain shellenv - prints export statements for your secrets in the keychain\n\noptions:\n  -h, --help            show this help message and exit\n  -c CONFIG, --config CONFIG\n                        config file (default: /Users/tscp/.config/envchain-shellenv/keychain.ini)\n  --create-example-config\n                        create example config file (default: False)\n  -u {envchain,keyring}, --use {envchain,keyring}\n                        What to use to extract secrets (default: envchain)\n  --version, -V         show program's version number and exit\n\nCreated by Teddy Xinyuan Chen || Homepage: https://github.com/tddschn/envchain-shellenv\n```\n\n## Example\n\n### Example config file\n\n```yaml\ntest:\n  TEST: TEST_SEC\n  MULTILINE:\naws: # the envchain namespace\n  AWS_SECRET_KEY:\n  AWS_ROOT_PW: envchain-aws-root-pw\n  # sets AWS_ROOT_PW env var to envchain-aws-root-pw in the aws namespace of envchain\nno-item:\n  # this will be skipped\n\n```\n\n\n## Develop\n\nSee [`core.py`](envchain_shellenv/core.py) for the main logic.\n\n```\n$ git clone https://github.com/tddschn/envchain-shellenv.git\n$ cd envchain-shellenv\n$ poetry install\n```\n\n## See Also\n\nhttps://teddysc.me/blog/list/tech-migrations#secretops-envchain---doppler--infisical","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftddschn%2Fenvchain-shellenv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftddschn%2Fenvchain-shellenv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftddschn%2Fenvchain-shellenv/lists"}