| Name | dotenvhub JSON |
| Version |
0.4.0
JSON |
| download |
| home_page | None |
| Summary | Terminal App to manage .env files written in Python powered by Textual |
| upload_time | 2025-01-11 18:43:56 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | MIT |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
|
<!-- These are examples of badges you might want to add to your README:
please update the URLs accordingly
[](https://cirrus-ci.com/github/<USER>/dotenvhub)
[](https://dotenvhub.readthedocs.io/en/stable/)
[](https://coveralls.io/r/<USER>/dotenvhub)
[](https://pypi.org/project/dotenvhub/)
[](https://anaconda.org/conda-forge/dotenvhub)
[](https://pepy.tech/project/dotenvhub)
[](https://twitter.com/dotenvhub)
-->
[](https://pyscaffold.org/)
# dotenvhub
> Your Terminal App to manage your .env files
# Introduction
DotEnvHub helps storing and accessing your project specific .env files from a central place to setup your environment variables.
Supporting you to follow the [12-factor] principles when developing applications.
# Features
- Organizes files centrally under `user_data_dir` following the [XDG] Basedir Spec
- Saves your last selected shell automatically via a config file under `user_config_dir`
- Supports Creating/Editing/Deleting files in your dotenvhub
- Currently provides 3 ways to set your environment variables:
1. Copy the Shell specific command to set the environment variables into your clipboard
2. Create a Copy of the selected file into your current working directory
3. Copy the path of the selected file to be used with e.g. [python-dotenv] \
without creating a copy in the project
# Installation
You can install `dotenvhub` with one of the following options:
```bash
# not recommended
python -m pip install dotenvhub
```
```bash
pipx install dotenvhub
```
```bash
rye install dotenvhub
```
```bash
uv tool install dotenvhub
```
I recommend using [pipx], [rye] or [uv] to install CLI Tools into an isolated environment.
# Usage
## Using the Graphical UI
After Installation the Interface can be opened with:
```bash
dot
```
Use `Ctrl+q` to close the interface.
## Using the CLI
The Creation of a Copy in the CWD and copying the Shell String
to set the environment variables can also be done directly in the CLI:
To create a copy of `FOLDER/FILE` from DotEnvHub and save it as `SAVENAME` in your CWD:
```bash
dot copy <FOLDER/FILE> -N <SAVENAME>
```
To copy the string to clipboard to set `FOLDER/FILE` from DotEnvHub in your `Shell` of Choice:
```bash
dot shell <FOLDER/FILE> -S <SHELL>
```
# Feedback and/or Issues
If you have feedback or find bugs, feel free to open an Issue.
:warning: DotEnvHub uses `pyperclip` to handle copy/paste actions.
Based on the pyperclips documentation, you might need additional packages installed
on linux systems like `xclip` or `xsel` which can be installed with:
```bash
sudo apt-get install xclip
sudo apt-get install xsel
```
like mentioned [here](https://pyperclip.readthedocs.io/en/latest/)
[XDG]: https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html
[platformdirs]: https://platformdirs.readthedocs.io/en/latest/
[python-dotenv]: https://github.com/theskumar/python-dotenv
[pipx]: https://github.com/pypa/pipx
[12-factor]: https://12factor.net
[rye]: https://rye.astral.sh
[uv]: https://docs.astral.sh/uv
Raw data
{
"_id": null,
"home_page": null,
"name": "dotenvhub",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": "Zaloog <gramslars@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/56/ca/c15bb2fafb515a8ffacd9e19eece53fdb7752fc60eff67532f33a4dec980/dotenvhub-0.4.0.tar.gz",
"platform": null,
"description": "<!-- These are examples of badges you might want to add to your README:\n please update the URLs accordingly\n\n[](https://cirrus-ci.com/github/<USER>/dotenvhub)\n[](https://dotenvhub.readthedocs.io/en/stable/)\n[](https://coveralls.io/r/<USER>/dotenvhub)\n[](https://pypi.org/project/dotenvhub/)\n[](https://anaconda.org/conda-forge/dotenvhub)\n[](https://pepy.tech/project/dotenvhub)\n[](https://twitter.com/dotenvhub)\n-->\n\n[](https://pyscaffold.org/)\n\n# dotenvhub\n\n> Your Terminal App to manage your .env files\n\n# Introduction\n\n\nDotEnvHub helps storing and accessing your project specific .env files from a central place to setup your environment variables.\nSupporting you to follow the [12-factor] principles when developing applications.\n\n# Features\n- Organizes files centrally under `user_data_dir` following the [XDG] Basedir Spec\n- Saves your last selected shell automatically via a config file under `user_config_dir`\n- Supports Creating/Editing/Deleting files in your dotenvhub\n- Currently provides 3 ways to set your environment variables:\n 1. Copy the Shell specific command to set the environment variables into your clipboard\n 2. Create a Copy of the selected file into your current working directory\n 3. Copy the path of the selected file to be used with e.g. [python-dotenv] \\\n without creating a copy in the project\n\n# Installation\nYou can install `dotenvhub` with one of the following options:\n\n```bash\n# not recommended\npython -m pip install dotenvhub\n```\n```bash\npipx install dotenvhub\n```\n\n```bash\nrye install dotenvhub\n```\n\n```bash\nuv tool install dotenvhub\n```\nI recommend using [pipx], [rye] or [uv] to install CLI Tools into an isolated environment.\n\n# Usage\n## Using the Graphical UI\n\nAfter Installation the Interface can be opened with:\n```bash\ndot\n```\nUse `Ctrl+q` to close the interface.\n\n## Using the CLI\nThe Creation of a Copy in the CWD and copying the Shell String\nto set the environment variables can also be done directly in the CLI:\n\nTo create a copy of `FOLDER/FILE` from DotEnvHub and save it as `SAVENAME` in your CWD:\n```bash\ndot copy <FOLDER/FILE> -N <SAVENAME>\n```\n\nTo copy the string to clipboard to set `FOLDER/FILE` from DotEnvHub in your `Shell` of Choice:\n```bash\ndot shell <FOLDER/FILE> -S <SHELL>\n```\n\n# Feedback and/or Issues\nIf you have feedback or find bugs, feel free to open an Issue.\n\n:warning: DotEnvHub uses `pyperclip` to handle copy/paste actions.\nBased on the pyperclips documentation, you might need additional packages installed\non linux systems like `xclip` or `xsel` which can be installed with:\n\n```bash\nsudo apt-get install xclip\nsudo apt-get install xsel\n```\n\nlike mentioned [here](https://pyperclip.readthedocs.io/en/latest/)\n\n\n[XDG]: https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html\n[platformdirs]: https://platformdirs.readthedocs.io/en/latest/\n[python-dotenv]: https://github.com/theskumar/python-dotenv\n[pipx]: https://github.com/pypa/pipx\n[12-factor]: https://12factor.net\n[rye]: https://rye.astral.sh\n[uv]: https://docs.astral.sh/uv\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Terminal App to manage .env files written in Python powered by Textual",
"version": "0.4.0",
"project_urls": {
"Changelog": "https://github.com/Zaloog/dotenvhub/blob/main/CHANGELOG.md",
"Repository": "https://github.com/Zaloog/dotenvhub"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "b1aadd90dc6af8808832f7d9dab14ca94e483a02212af6e695178816c2756997",
"md5": "f2221c98f9a15411b5f314e2b8e3a387",
"sha256": "44494af7457cb2b8599523bd4cc7679a6c4fc14b7c1d47705bbff6041ac8a7eb"
},
"downloads": -1,
"filename": "dotenvhub-0.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f2221c98f9a15411b5f314e2b8e3a387",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 16656,
"upload_time": "2025-01-11T18:43:54",
"upload_time_iso_8601": "2025-01-11T18:43:54.067350Z",
"url": "https://files.pythonhosted.org/packages/b1/aa/dd90dc6af8808832f7d9dab14ca94e483a02212af6e695178816c2756997/dotenvhub-0.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "56cac15bb2fafb515a8ffacd9e19eece53fdb7752fc60eff67532f33a4dec980",
"md5": "ae2be188e3883dade6feb057847ed72e",
"sha256": "191e4a4a7180be8f393e3cde2fe2a44a138db4ce7d6bba3f999529236b9ac544"
},
"downloads": -1,
"filename": "dotenvhub-0.4.0.tar.gz",
"has_sig": false,
"md5_digest": "ae2be188e3883dade6feb057847ed72e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 132448,
"upload_time": "2025-01-11T18:43:56",
"upload_time_iso_8601": "2025-01-11T18:43:56.385507Z",
"url": "https://files.pythonhosted.org/packages/56/ca/c15bb2fafb515a8ffacd9e19eece53fdb7752fc60eff67532f33a4dec980/dotenvhub-0.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-11 18:43:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Zaloog",
"github_project": "dotenvhub",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "dotenvhub"
}
