mydotenv 0.2.3

A simple package to manage environment variables with command-line interface

mydotenv

A simple Python package to manage environment variables in your .env file with command-line interface.

Installation

Using pipx (Recommended)

pipx install mydotenv

Using pip

pip install mydotenv

From Source

git clone https://github.com/banddude/mydotenv.git
cd mydotenv
pip install -e .

Usage

Basic Command Line Interface

1. Print a variable's value:

mydotenv API_KEY

2. Add or update a variable:

mydotenv NEW_KEY=value
mydotenv "KEY_WITH_SPACES=value with spaces"

3. Delete a variable:

mydotenv delete VARIABLE_NAME

4. View all variables:

mydotenv

Custom Command Name

You can set a custom command name to use instead of mydotenv:

mydotenv --set-command dotman

Now you can use either mydotenv or dotman to run commands:

dotman NEW_KEY=value
dotman delete NEW_KEY

When you set a new command name, it replaces any previous custom command name.

Advanced Features (New)

Scanning for Environment Variables

The new CLI functionality lets you scan your codebase for env.VARIABLE_NAME references and manage your .env file based on what it finds:

1. Replace existing .env with newly discovered variables (empty values):

mydotenv --replace env [<path>]

2. Add newly discovered variables as empty placeholders (preserving existing ones):

mydotenv --add-empty env [<path>]

3. Add newly discovered variables (same as --add-empty in current implementation):

mydotenv --add env [<path>]

Import Statement Rewriting

You can also rewrite import statements in your Python files to use the preferred style:

mydotenv --add imports [<path>]

This will find any import mydotenv or from mydotenv import ... statements and rewrite them as from mydotenv import env.

Optional Parameters

• --ignore: Specify paths to ignore when scanning

mydotenv --add env . --ignore tests venv

• --env-file: Specify which .env file to use (default: .env)

mydotenv --replace env . --env-file .env.dev

Features

• Manage environment variables from the command line
• Set custom command names for easier use
• Preserves comments and formatting in .env file
• Handles values with spaces and special characters
• Works from any directory
• Creates and manages .env file in your current directory
• NEW: Scan codebase for environment variable references
• NEW: Replace or update .env files based on discovered variables
• NEW: Rewrite import statements to a consistent style

Dependencies

• python-dotenv >= 1.0.0

Configuration

• The package stores its configuration in ~/.config/mydotenv/config.env
• Custom command names are managed through symlinks in ~/.local/bin

License

MIT License - feel free to use this package in your projects!