refactor: modularize CLI architecture and add hooks support

This commit represents a major architectural refactoring of uvtask,
transforming the monolithic CLI implementation into a modular, testable
architecture while adding new features and infrastructure improvements.

Author: ticdenis

.github/workflows/cd.yml

@@ -0,0 +1,84 @@
+name: CD
+
+run-name: CD - ${{ github.event_name == 'workflow_run' && format('{0} (from CI)', github.event.workflow_run.head_commit.message) || format('{0}{1}', github.event.inputs.environment != '' && github.event.inputs.environment || 'dev', github.event.inputs.version != '' && format(' (v{0})', github.event.inputs.version) || '') }}
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "Release version"
+        default: "None"
+        required: false
+  workflow_run:
+    workflows: ["CI"]
+    branches: [main]
+    types:
+      - completed
+
+env:
+  CD: ${{ vars.CONTINUOUS_DEPLOYMENT }}
+  DEPLOY_MODE: "true"
+  VERSION: ${{ github.event.inputs.version != '' && github.event.inputs.version || 'None' }}
+
+jobs:
+  # Continuous Deployment (CD) pipeline
+  cd:
+    if: ${{ vars.CONTINUOUS_DEPLOYMENT == 'true' && github.ref_name == 'main' && (github.event_name == 'workflow_dispatch' || (github.event_name == 'workflow_run' && github.event.workflow_run.conclusion == 'success')) }}
+    permissions:
+      contents: write
+      id-token: write
+    timeout-minutes: 15
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest]
+        platforms: [linux/amd64]
+    steps:
+      - name: Checkout Git repository
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+      
+      - name: Install uv and set the Python version
+        uses: astral-sh/setup-uv@v7
+
+      - name: Install dependencies
+        shell: bash
+        run: uvx uvtask dev-install
+
+      - name: Set version
+        shell: bash
+        run: |
+          if [ -z "${VERSION}" ] || [ "${VERSION}" = "None" ]; then
+            uv version --bump minor
+            VERSION=$(uv version --short)
+            echo "VERSION=${VERSION}" >> "${GITHUB_ENV:-/dev/null}"
+          else
+            uv version ${VERSION}
+          fi
+          git config user.name "${{ github.actor }}"
+          git config user.email "${{ github.actor_id }}+${{ github.actor }}@users.noreply.github.com"
+          git tag -a "${VERSION}" -m "Release ${VERSION}"
+          git push origin "${VERSION}"
+        if: ${{ env.PIPELINE_TAG == 'true' && env.RELEASE_MODE == 'true' }}
+      
+      - name: Build package
+        shell: bash
+        run: uv build
+        if: ${{ env.PIPELINE_TAG == 'true' && env.RELEASE_MODE == 'true' }}
+
+      - name: Upload package to artifact registry
+        uses: actions/upload-artifact@v6
+        with:
+          name: uvtask
+          path: dist/
+        if: ${{ env.PIPELINE_TAG == 'true' && env.RELEASE_MODE == 'true' }}
+
+      - name: Publish package
+        shell: bash
+        run: uv publish
+        if: ${{ env.PIPELINE_TAG == 'true' && env.RELEASE_MODE == 'true' }}
+
+      - name: Clean
+        shell: bash
+        run: uvx uvtask clean

.github/workflows/ci.yml

@@ -0,0 +1,80 @@
+name: CI
+
+run-name: CI - ${{ github.event_name == 'pull_request' && github.event.pull_request.title || github.event_name == 'push' && github.event.head_commit.message || github.ref_name }} ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.version != '' && format('(v{0})', github.event.inputs.version) || '' }}
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "Release version"
+        default: "None"
+        required: false
+
+env:
+  CI: "true"
+
+jobs:
+  # Continuous Integration (CI) pipeline
+  ci:
+    if: ${{ vars.CONTINUOUS_INTEGRATION == 'true' }}
+    permissions:
+      contents: read
+    env:
+      PIPELINE_TESTS: ${{ github.event_name != 'workflow_dispatch' && github.event.inputs.version == '' && startsWith(github.ref, 'refs/tags/') == false && github.ref != 'refs/heads/main' && 'true' || 'false' }}
+      RELEASE_MODE: "false"
+      VERSION: ${{ github.run_id }}
+    timeout-minutes: 15
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest]
+        platforms: [linux/amd64, linux/arm64]
+    steps:
+      - name: Checkout Git repository
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+      
+      - name: Install uv and set the Python version
+        uses: astral-sh/setup-uv@v7
+
+      - name: Install dependencies
+        shell: bash
+        run: uvx uvtask dev-install
+
+      - name: security-analysis-licenses
+        shell: bash
+        run: uvx uvtask security-analysis:licenses
+        if: ${{ env.PIPELINE_TESTS == 'true' }}
+
+      - name: security-analysis-vulnerabilities
+        shell: bash
+        run: uvx uvtask security-analysis:vulnerabilities
+        if: ${{ env.PIPELINE_TESTS == 'true' }}
+
+      - name: static-analysis-linter
+        shell: bash
+        run: uvx uvtask static-analysis:linter
+        if: ${{ env.PIPELINE_TESTS == 'true' }}
+
+      - name: static-analysis-types
+        shell: bash
+        run: uvx uvtask static-analysis:types
+        if: ${{ env.PIPELINE_TESTS == 'true' }}
+
+      - name: unit-tests
+        shell: bash
+        run: uvx uvtask unit-tests
+        if: ${{ env.PIPELINE_TESTS == 'true' }}
+      
+      - name: integration-tests
+        shell: bash
+        run: uvx uvtask integration-tests
+        if: ${{ env.PIPELINE_TESTS == 'true' }}
+
+      - name: Clean
+        shell: bash
+        run: uvx uvtask clean

.gitignore

@@ -8,6 +8,7 @@
 *.egg-info/
 *.pyc
 __pycache__/
+.coverage
 build/
 dist/
 requirements-dev.txt

.python-version

@@ -0,0 +1 @@
+3.14

README.md

@@ -1,46 +1,67 @@
-# 🚀 uvtask
+# uvtask
 
-[![PyPI version](https://badge.fury.io/py/uvtask.svg)](https://badge.fury.io/py/uvtask)
+[![image](https://img.shields.io/pypi/v/uvtask.svg)](https://pypi.python.org/pypi/uvtask)
+[![image](https://img.shields.io/pypi/l/uvtask.svg)](https://pypi.python.org/pypi/uvtask)
+[![image](https://img.shields.io/pypi/pyversions/uvtask.svg)](https://pypi.python.org/pypi/uvtask)
+[![Actions status](https://github.com/aiopy/python-uvtask/actions/workflows/ci.yml/badge.svg)](https://github.com/aiopy/python-uvtask/actions)
 [![PyPIDownloads](https://static.pepy.tech/badge/uvtask)](https://pepy.tech/project/uvtask)
 
-**uvtask** is a modern, fast, and flexible Python task runner and test automation tool designed to simplify development workflows. It supports running, organizing, and managing tasks or tests in Python projects with an emphasis on ease of use and speed. ⚡
+An extremely fast Python task runner.
+
+## Highlights
+
+- ⚡ **Extremely fast** - Built for speed with zero installation overhead
+- 📝 **Simple configuration** - Define scripts in `pyproject.toml`
+- 🔗 **Pre/post hooks** - Automatically run hooks before and after commands
+- 🎨 **Beautiful output** - Colorful, `uv`-inspired CLI
 
 ## 🎯 Quick Start
 
-Run tasks defined in your `pyproject.toml`:
+Run `uvtask` directly with `uvx` (no installation required):
 
 ```shell
-uvx uvtask <task_name>
+uvx uvtask <OPTIONS> [COMMAND]
+```
+
+Or install it and use it directly:
+
+```shell
+uv add --dev uvtask
+uvtask <OPTIONS> [COMMAND]
 ```
 
 ## 📝 Configuration
 
-Define your tasks in `pyproject.toml` under the `[tool.run-script]` section:
+Define your scripts in `pyproject.toml` under the `[tool.run-script]` section:
 
 ```toml
 [tool.run-script]
-hello-world = "echo 'hello world'"
+install = "uv sync --dev --all-extras"
+format = "ruff format ."
+lint = { command = "ruff check .", description = "Check code quality" }
+check = ["ty check .", "mypy ."]
+pre-test = "echo 'Running tests...'"
+test = "pytest"
+post-test = "echo 'Tests completed!'"
+deploy = [
+    "echo 'Building...'",
+    "uv build",
+    "echo 'Deploying...'",
+    "uv deploy"
+]
 ```
 
 ## 🛠️ Development
 
 To run the development version:
 
 ```shell
-uvx --no-cache --from $PWD run --help
+uvx -q --no-cache --from $PWD uvtask
 ```
 
-## 📋 Requirements
-
-- 🐍 Python >= 3.13
-
 ## 🤝 Contributing
 
-Contributions are welcome! 🎉
-
-- For major changes, please open an issue first to discuss what you would like to change
-- Make sure to update tests as appropriate
-- Follow the existing code style and conventions
+Contributions are welcome! Please feel free to submit a Pull Request.
 
 ## 📄 License
 

pyproject.toml

@@ -1,6 +1,10 @@
 [build-system]
-build-backend = "setuptools.build_meta"
-requires = ["setuptools"]
+requires = ["uv_build"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "uvtask"
+module-root = ""
 
 [project]
 authors = [
@@ -27,8 +31,8 @@ classifiers = [
     "Programming Language :: Python :: 3.14",
 ]
 dependencies = []
-description = "uvtask is a modern, fast, and flexible Python task runner and test automation tool designed to simplify development workflows. It supports running, organizing, and managing tasks or tests in Python projects with an emphasis on ease of use and speed."
-dynamic = ["version"]
+description = "An extremely fast Python task runner."
+version = "0.0.0"
 keywords = [
     "uv", 
     "uvx",
@@ -51,25 +55,13 @@ dev = [
     "pytest-cov>=7.0.0", # test, coverage
     "pytest-xdist>=3.8.0", # test
     "ruff>=0.14.10", # code-formatter, static-analysis
-    "ty>=0.0.4", # static-analysis
+    "ty>=0.0.6", # static-analysis
 ]
 
 [project.urls]
 "documentation" = "https://aiopy.github.io/python-uvtask/"
 "repository" = "https://github.com/aiopy/python-uvtask"
 
-[tool.setuptools.dynamic]
-version = { attr = "uvtask.__version__" }
-
-[tool.setuptools.packages.find]
-include = ["uvtask*"]
-
-[tool.setuptools.package-data]
-"uvtask" = ["py.typed"]
-
-[[tool.uv.index]]
-url = "https://pypi.org/simple"
-
 [tool.bandit]
 exclude_dirs = ["tests"]
 skips = ["B404", "B602"]
@@ -103,6 +95,8 @@ lint.select = [
 ]
 lint.ignore = [
     "PLC0415",
+    "PLR0912",
+    "PLR0913",
     "PLR2004", 
 ]
 
@@ -118,7 +112,7 @@ force-single-line = false
 known-first-party = ["uvtask"]
 
 [tool.ruff.lint.mccabe]
-max-complexity = 15
+max-complexity = 20
 
 [tool.ty.environment]
 python-version = "3.13"
@@ -127,35 +121,37 @@ python-version = "3.13"
 exclude = [
     "tests/fixtures/**",
     "var",
+    ".venv",
 ]
 
 [tool.run-script]
-install = "uv sync --frozen --no-dev"
-upgrade-install = "uv sync --frozen --no-dev --upgrade --refresh"
-dev-install = "uv sync --dev --all-extras"
-upgrade-dev-install = "uv sync --dev --all-extras --upgrade --refresh"
-deploy = "uv build && uv publish"
-docs = "python3 -m mkdocs build -f docs_src/config/en/mkdocs.yml && python3 -m mkdocs build -f docs_src/config/es/mkdocs.yml"
-dev-docs = "python3 -m mkdocs serve -f docs_src/config/en/mkdocs.yml"
-code-formatter = "uv run ruff format uvtask tests $@"
-"security-analysis:licenses" = "uv run pip-licenses"
-"security-analysis:vulnerabilities" = "uv run bandit -r -c pyproject.toml uvtask tests"
-"static-analysis:linter" = "uv run ruff check uvtask tests"
-"static-analysis:types" = "uv run ty check uvtask tests"
-test = "uv run pytest"
-unit-tests = "uv run pytest tests/unit"
-integration-tests = "uv run pytest tests/integration"
-functional-tests = "uv run pytest -n1 tests/functional"
-coverage = "uv run pytest -n1 --cov --cov-report=html"
-clean = """python3 -c \"
+install = { command = "uv sync --frozen --no-dev", description = "Install dependencies as specified in lockfile, excluding dev dependencies" }
+upgrade-install = { command = "uv sync --frozen --no-dev --upgrade --refresh", description = "Upgrade and refresh installation of non-dev dependencies" }
+dev-install = { command = "uv sync --dev --all-extras", description = "Install all dependencies including dev and extras" }
+upgrade-dev-install = { command = "uv sync --dev --all-extras --upgrade --refresh", description = "Upgrade and refresh installation of all dependencies including dev and extras" }
+code-formatter = { command = "ruff format uvtask tests", description = "Format code with ruff" }
+"security-analysis" = { command = ["security-analysis:licenses", "security-analysis:vulnerabilities"], description = "Run all security analysis checks" }
+"security-analysis:licenses" = { command = "pip-licenses", description = "Check third-party dependencies licenses using pip-licenses" }
+"security-analysis:vulnerabilities" = { command = "bandit -r -c pyproject.toml uvtask tests", description = "Scan code for security vulnerabilities using bandit" }
+"static-analysis" = { command = ["static-analysis:linter", "static-analysis:types"], description = "Run all static analysis checks" }
+"static-analysis:linter" = { command = "ruff check uvtask tests", description = "Run linter checks using ruff" }
+"static-analysis:types" = { command = "ty check uvtask tests", description = "Run type checks using ty" }
+test = { command = ["unit-tests", "integration-tests", "functional-tests"], description = "Run all tests with pytest" }
+unit-tests = { command = "pytest tests/unit", description = "Run unit tests with pytest" }
+integration-tests = { command = "pytest tests/integration", description = "Run integration tests with pytest" }
+functional-tests = { command = "pytest -n1 tests/functional", description = "Run functional tests with pytest" }
+coverage = { command = "pytest -n1 --cov --cov-report=html", description = "Run tests with coverage report in HTML using pytest" }
+clean = { command = """python3 -c "
 from glob import iglob
 from shutil import rmtree
 
 for pathname in ['./build', './*.egg-info', './dist', './var', '**/__pycache__']:
   for path in iglob(pathname, recursive=True):
     rmtree(path, ignore_errors=True)
-\""""
+"
+""", description = "Clean build artifacts" }
 
 [project.scripts]
 uvtask = "uvtask.cli:main"
+run = "uvtask.cli:main"
 run-script = "uvtask.cli:main"

tests/__init__.py

@@ -1 +1 @@
-"""Test package for uvtask."""
+