dony 0.1.3

Lightweight Python task runner that just gets it

🍥️ dony

A lightweight Python command runner with simple and consistent workflow for managing project commands. A Justfile alternative.

How it works

Define your commands in dony/ in the root of your project.

# dony/commands/hello_world.py
import dony

@dony.command()
def hello_world(name: str = "John"):
    print(f"Hello, {name}!")	

Run dony to fuzzy-search your commands from anywhere in your project.

Common use cases: build, release, publish, test, deploy, configure, format, run static analyzers, manage databases, generate documentation, run benchmarks, get useful links, create release notes and much more

Defining Commands

Create commands as Python functions

import dony

@dony.command()
def greet(
	greeting: str = 'Hello',
	name: str = None
):
	name = name or dony.input('What is your name?')
    dony.shell(f"echo {greeting}, {name}!")

• All parameters must provide defaults to allow invocation with no arguments, and any missing values should be requested via user prompts
• Currently, only str and List[str] parameter types are supported.

Running commands

Run commands interactively:

dony

Run commands directly:

dony <command_name> [--arg1 value --arg2 value]

Installation

Ensure you have the following prerequisites:

• Python 3.8 or higher
• pipx for isolated installation (brew install pipx on macOS)
• fzf for fuzzy command selection (brew install fzf on macOS)

Then install the package with pipx:

pipx install dony

Initialize your project:

dony --init

This creates a dony/ directory:

• A commands/ directory containing a sample command
• A dedicated uv virtual environment

Dony directory structure

dony/
... (uv environment) 
├── commands/
│   ├── my_global_command.py # one command per file
│   ├── my-service/         
│   │   ├── service_command.py  # will be displayed as `my-service/service_command`
│   │   └── _helper.py       # private module (ignored)

License

MIT License. See LICENSE for details.

Author

Mark Lidenberg [e-mail]