task-automator 0.2.2

Task-Automator is a modern Python framework for building declarative command-line interfaces with nested subcommands, designed for automation workflows and build systems.

Task-Automator - Declarative CLI Automation Framework

Supported Platforms

Overview | What is Task-Automator? | Features | Installation | Build | Defining Commands | License

[!IMPORTANT] 📣 As of March 2025 Task-Automator is still in early development. 📣

Task-Automator is a best-effort open project library. This means that support is not guaranteed and how long the project will be maintained is unknown.

What is Task-Automator?

Task-Automator is a modern Python framework for building declarative command-line interfaces
with nested subcommands, designed for automation workflows and build systems.

Task-Automator is implemented in pure Python that enables scripting of more complicated tasks.

Features

• 🚀 Declarative Command Tree - Define CLI structure through simple nested dictionaries
• 🛠 Zero Boilerplate - Focus on business logic, not argument parsing
• 📚 Automatic Help Generation - Built-in help system with hierarchical documentation
• 🌳 Hierarchical Commands - Support for unlimited nested subcommands
• 🖥 Cross-Platform - Works on Windows, Linux, and macOS
• 📚 Filesystem & Web utils: Utility functions for filesystem operations and web

Installation

You can use pip to install Task-Automator

pip install task-automator

Build

Task-Automator uses Poetry for its build process. To build the wheel file and source distribution run:

poetry build

Defining Commands

Create your command structure in a Python module:

...


def setup_dev_env():
  """Initialize development environment"""
  print("Installing dependencies...")


AUTOMATION_TREE = {
  "setup-dev-env": {
    "help": "Initialize development environment",
    "func": setup_dev_env
  },
  "build": {
    "help": "Build artifacts",
    "subcommands": {
      "win-package": {
        "help": "Create Windows deployment package",
        "func": build_windows_package
      },
      "setup-exe": {
        "help": "Generate installer executable",
        "func": create_installer
      }
    }
  }
}

if __name__ == "__main__":
  from task_automator import automator
  automator.Automator(AUTOMATION_TREE).run()

License

This project is licensed under the BSD-3 License - see the LICENSE file for details.