---
id: python-tools-scripts
version: "0.20.5"
license: Apache Software License 2.0
license_treatment: permissive
maintenance: dormant
---

# python-tools-scripts — Python Tools Scripts

License: permissive · Maintenance: dormant · Downloads: 586.2K/mo

## What it is and what it does

Python Tools Scripts is a CLI framework that discovers Python functions in a repository's tools package and automatically exposes them as command-line commands. It uses argparse under the hood and relies on decorators to define command groups and individual commands with their arguments. You define functions in tools modules, decorate them to register as commands, and the framework generates a full CLI with help text, argument parsing, and subcommand hierarchies.

It's designed for repository-level automation—tasks like VM management, deployment, testing, or local development workflows. The framework handles argument definition, type hints, and context passing to commands. Dependencies include attrs, pydantic, rich, requests, filelock, and typing-extensions, all of which are widely maintained. The package itself is dormant since 2024-02-29, so it is stable but not actively developed.

Use it for:

- Define repository-level automation scripts (deployment, testing, VM management) as discoverable CLI commands.
- Build task runners for development workflows without writing raw argparse boilerplate.
- Create hierarchical command structures from Python functions in a tools package.
- Share command definitions across team members via a tools package in version control.
- Organize local development tasks into a unified CLI interface.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Builds CLI tools by auto-discovering Python functions in a repository's tools package and exposing them as command-line commands with argparse-based argument handling.

Yes, if you need a lightweight CLI framework for repository automation and are comfortable with dormant maintenance. The package is stable, has low install friction, and uses well-maintained dependencies. It is not suitable if you require active bug fixes, new features, or ongoing support—the last release was 2024-02-29 with no subsequent commits. Consider it for established projects where the CLI is unlikely to need frequent changes.

## Install

pip install python-tools-scripts
uv add python-tools-scripts
poetry add python-tools-scripts

## Installing python-tools-scripts

Before you install: Low install friction with six common dependencies (attrs, pydantic, rich, requests, filelock, typing-extensions). Maintenance is dormant—last release was 2024-02-29 and no commits since then—so expect no active bug fixes or feature updates.

License in practice: Apache Software License 2.0 (permissive) imposes no significant restrictions on use or redistribution; suitable for both open-source and proprietary projects.

Quickstart:

# In tools/__init__.py, import your scripts
from tools import my_script

# Then run from repository root:
# tools -h

Requires Python 3.9 or later and a tools package in your repository root.

Verify before relying:

- Whether the package is actively maintained or if dormant status signals end-of-life intent.
- How well it handles complex nested command hierarchies or large numbers of commands.
- Whether rich output formatting is configurable or mandatory for CLI output.
- Specific examples of how command discovery and decorator-based registration work in practice.

## Package facts

- License: Apache Software License 2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 586.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

CLI framework for repository tools, command-line interface builder, auto-discover python scripts, argparse-based task runner, repository tool automation, python function to CLI, task runner framework, cli-framework, task-automation, repository-tools

[View on SkillFed](https://skillfed.io/packages/python-tools-scripts) · [View on PyPI](https://pypi.org/project/python-tools-scripts/)