Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zaloog/dotenvhub
Terminal App to centrally manage .env files. Written in Python powered by Textual
https://github.com/zaloog/dotenvhub
dotenv dotenv-files environment-variables textual tui
Last synced: about 13 hours ago
JSON representation
Terminal App to centrally manage .env files. Written in Python powered by Textual
- Host: GitHub
- URL: https://github.com/zaloog/dotenvhub
- Owner: Zaloog
- License: mit
- Created: 2024-01-10T12:42:05.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-04-02T20:23:21.000Z (11 months ago)
- Last Synced: 2024-05-06T00:40:56.883Z (10 months ago)
- Topics: dotenv, dotenv-files, environment-variables, textual, tui
- Language: Python
- Homepage:
- Size: 241 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
README
[](https://github.com/astral-sh/ruff)
[](https://pypi.org/project/dotenvhub/)
[](https://pypi.python.org/pypi/dotenvhub)
[](https://opensource.org/licenses/MIT)
[](https://pepy.tech/project/dotenvhub)
# 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 -N
```
To copy the string to clipboard to set `FOLDER/FILE` from DotEnvHub in your `Shell` of Choice:
```bash
dot shell -S
```
# 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