moles-tools

A collection of Python tools from the underground. 🐾

📖 Full Documentation

Tools

Quick Start

# Install from PyPI
pip install moles-tools

# Or with uv
uv tool install moles-tools

# Update .env from .env.production
env-updater .env.production .env

Usage

moles-tools

moles-tools - A collection of Python tools from the underground

Available tools:
  env-updater          Update ENV variables in a target file from a source file

Run 'env-updater --help' for usage information.

env-updater

usage: env-updater [-h] [--no-create] [--quiet] [UPDATE] [TARGET]

Update ENV variables in TARGET from UPDATE.

When TARGET is omitted the tool auto-detects the target:
  1. .env exists            → update .env with UPDATE
  2. .env missing, .env.example/.env found → create .env from
     example, then apply UPDATE
  3. No UPDATE given, .env missing → copy .env.example / env.example
     to .env

positional arguments:
  UPDATE       ENV file whose values take precedence (optional).
  TARGET       Target ENV file to update in-place. Auto-detected from the
               current directory when omitted.

options:
  -h, --help   show this help message and exit
  --no-create  Fail if TARGET does not exist instead of creating it.
  --quiet, -q  Suppress informational output.

Development

# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# Clone and set up
git clone https://github.com/the78mole/moles-tools.git
cd moles-tools

# Install all dependencies
uv sync --all-extras

# Install pre-commit hooks
uv run pre-commit install

# Run tests
uv run pytest

License

MIT