crackerjack 0.11.4__tar.gz → 0.12.0__tar.gz

crackerjack-0.12.0/PKG-INFO

@@ -0,0 +1,225 @@
+Metadata-Version: 2.1
+Name: crackerjack
+Version: 0.12.0
+Summary: Default template for PDM package
+Keywords: black,ruff,mypy,creosote,refurb
+Author-Email: lesleslie <les@wedgwoodwebworks.com>
+Maintainer-Email: lesleslie <les@wedgwoodwebworks.com>
+License: BSD-3-CLAUSE
+Classifier: Environment :: Console
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Development Status :: 4 - Beta
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: Utilities
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Typing :: Typed
+Project-URL: homepage, https://github.com/lesleslie/crackerjack
+Project-URL: documentation, https://github.com/lesleslie/crackerjack
+Project-URL: repository, https://github.com/lesleslie/crackerjack
+Requires-Python: >=3.13
+Requires-Dist: autotyping>=24.9.0
+Requires-Dist: pre-commit>=4.1.0
+Requires-Dist: pytest>=8.3.5
+Requires-Dist: pydantic>=2.10.6
+Requires-Dist: pdm-bump>=0.9.10
+Requires-Dist: pdm>=2.22.4
+Requires-Dist: uv>=0.6.5
+Requires-Dist: pytest-cov>=6.0.0
+Requires-Dist: pytest-mock>=3.14.0
+Requires-Dist: tomli-w>=1.2.0
+Requires-Dist: pytest-asyncio>=0.25.3
+Requires-Dist: rich>=13.9.4
+Requires-Dist: typer>=0.15.2
+Description-Content-Type: text/markdown
+
+# Crackerjack: Elevate Your Python Development
+
+[![Code style: crackerjack](https://img.shields.io/badge/code%20style-crackerjack-000042)](https://github.com/lesleslie/crackerjack)
+[![Python Version](https://img.shields.io/badge/python-3.13-blue.svg)](https://www.python.org/downloads/)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
+[![Checked with pyright](https://microsoft.github.io/pyright/img/pyright_badge.svg)](https://microsoft.github.io/pyright/)
+[![pdm-managed](https://img.shields.io/badge/pdm-managed-blueviolet)](https://pdm.fming.dev)
+[![security: bandit](https://img.shields.io/badge/security-bandit-yellow.svg)](https://github.com/PyCQA/bandit)
+[![License](https://img.shields.io/badge/License-BSD%203--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)
+
+**Crackerjack** (`ˈkra-kər-ˌjak`): *a person or thing of marked excellence.*
+
+Crackerjack is an opinionated Python project management tool designed to help you create, maintain, and publish high-quality Python projects with ease. It combines best-in-class tools and a streamlined workflow to ensure code quality, consistency, and reliability.
+
+## The Crackerjack Philosophy
+
+Crackerjack is built on the following core principles:
+
+-   **Code Clarity:** Code should be easy to read, understand, and maintain.
+-   **Automation:** Tedious tasks should be automated, allowing developers to focus on solving problems.
+-   **Consistency:** Code style, formatting, and project structure should be consistent across projects.
+-   **Reliability:** Tests are essential, and code should be checked rigorously.
+-   **Tool Integration:** Leverage powerful existing tools instead of reinventing the wheel.
+- **Static Typing:** Static typing is essential for all development.
+
+## Key Features
+
+Crackerjack provides:
+
+-   **Effortless Project Setup:** Initializes new Python projects with a standard directory structure, `pyproject.toml`, and essential configuration files.
+-   **PDM Integration:** Manages dependencies and virtual environments using [PDM](https://pdm.fming.dev/) (with [uv](https://github.com/astral-sh/uv) enabled for speed).
+-   **Automated Code Cleaning:** Removes unnecessary docstrings, line comments, and trailing whitespace.
+-   **Consistent Code Formatting:** Enforces a consistent style using [Ruff](https://github.com/astral-sh/ruff), the lightning-fast Python linter and formatter.
+-   **Comprehensive Pre-commit Hooks:** Installs and manages a robust suite of pre-commit hooks to ensure code quality (see the "Pre-commit Hooks" section below).
+-   **Interactive Checks:** Supports interactive pre-commit hooks (like `refurb`, `bandit`, and `pyright`) to allow you to fix issues in real-time.
+-   **Built-in Testing:** Automatically runs tests using `pytest`.
+-   **Easy Version Bumping:** Provides commands to bump the project version (micro, minor, or major).
+-   **Simplified Publishing:** Automates publishing to PyPI via PDM.
+- **Commit and Push:** Commits and pushes your changes.
+
+## Pre-commit Hooks
+
+Crackerjack automatically installs and manages these pre-commit hooks:
+
+1.  **pdm-lock-check:** Ensures the `pdm.lock` file is up to date.
+2.  **Core pre-commit-hooks:** Essential hooks from [pre-commit-hooks](https://github.com/pre-commit/pre-commit-hooks) (e.g., `trailing-whitespace`, `end-of-file-fixer`).
+3.  **Ruff:** [Ruff](https://github.com/astral-sh/ruff) for linting, code formatting, and general code style enforcement.
+4.  **Vulture:** [Vulture](https://github.com/jendrikseipp/vulture) to identify dead code.
+5.  **Creosote:** [Creosote](https://github.com/fredrikaverpil/creosote) to detect unused dependencies.
+6.  **Flynt:** [Flynt](https://github.com/ikamensh/flynt/) for converting string formatting to f-strings.
+7.  **Codespell:** [Codespell](https://github.com/codespell-project/codespell) for correcting typos in the code.
+8.  **Autotyping:** [Autotyping](https://github.com/JelleZijlstra/autotyping) for adding type hints.
+9.  **Refurb:** [Refurb](https://github.com/dosisod/refurb) to suggest code improvements.
+10. **Bandit:** [Bandit](https://github.com/PyCQA/bandit) to identify potential security vulnerabilities.
+11. **Pyright:** [Pyright](https://github.com/RobertCraigie/pyright-python) for static type checking.
+12. **Ruff (again):** A final Ruff pass to ensure all changes comply with the enforced style.
+
+## The Crackerjack Style Guide
+
+Crackerjack projects adhere to these guidelines:
+
+-   **Static Typing:** Use type hints consistently throughout your code.
+-   **Explicit Naming:** Choose clear, descriptive names for classes, functions, variables, and other identifiers.
+-   **Markdown for Documentation:** Use Markdown (`.md`) for all documentation, including docstrings, READMEs, etc.
+-   **Pathlib:** Use `pathlib.Path` for handling file and directory paths instead of `os.path`.
+-   **Consistent Imports:** Use `import typing as t` for type hinting.
+-   **Constants and Config:** Do not use all-caps for constants or configuration settings.
+-   **Path Parameters:** Functions that handle file operations should accept `pathlib.Path` objects as parameters.
+-   **Dependency Management:** Use PDM for dependency management, package building, and publishing.
+-   **Testing:** Use pytest as your testing framework.
+-   **Python Version:** Crackerjack projects support the latest Python versions.
+-   **Clear Code:** Avoid overly complex code.
+-   **Modular:** Functions should do one thing well.
+
+## Installation
+
+1.  **Python:** Ensure you have Python 3.13 installed.
+2.  **PDM:** Install [PDM](https://pdm.fming.dev/) using `pipx`:
+
+    ```
+    pipx install pdm
+    ```
+
+3.  **Crackerjack:** Install Crackerjack and initialize in your project root using:
+    ```
+    pip install crackerjack
+    cd your_project_root
+    python -m crackerjack
+    ```
+
+## Usage
+
+Run Crackerjack from the root of your Python project using:
+
+    python -m crackerjack
+
+
+### Command-Line Options
+
+-   `-c`, `--commit`: Commit changes to Git.
+-   `-i`, `--interactive`: Run pre-commit hooks interactively when possible.
+-   `-n`, `--no-config-updates`: Skip updating configuration files (e.g., `pyproject.toml`).
+-   `-u`, `--update-precommit`: Update pre-commit hooks to the latest versions.
+-   `-v`, `--verbose`: Enable verbose output.
+-   `-p`, `--publish <micro|minor|major>`: Bump the project version and publish to PyPI using PDM.
+-   `-b`, `--bump <micro|minor|major>`: Bump the project version without publishing.
+-   `-x`, `--clean`: Clean code by removing docstrings, line comments, and extra whitespace.
+-   `-t`, `--test`: Run tests using `pytest`.
+-   `-h`, `--help`: Display help.
+
+### Example Workflows
+
+-   **Run checks, bump version, publish, then commit:**
+    ```
+    python -m crackerjack -p minor -c
+    ```
+
+-   **Clean code, run checks, run tests, then commit:**
+    ````
+    python -m crackerjack -c -x -t
+    ```
+
+-   **Run checks skipping config updates:**
+    ```
+    python -m crackerjack -n
+    ```
+
+-   **Bump the version and publish to PyPI:**
+    ```
+    python -m crackerjack -p micro
+    ```
+
+-   **Bump the version without publishing:**
+    ```
+    python -m crackerjack -b major
+    ```
+- **Update pre-commit hooks:**
+    ```
+    python -m crackerjack -u
+    ```
+- **Get help:**
+    ```
+    python -m crackerjack -h
+    ```
+
+## Contributing
+
+Crackerjack is an evolving project. Contributions are welcome! Please open a pull request or issue.
+
+To contribute:
+
+1. Add Crackerjack as a development dependency to your project:
+  ```
+  pdm add -G dev crackerjack
+  ```
+
+2. Run checks and tests before submitting:
+  ```
+  python -m crackerjack -x -t
+  ```
+
+This ensures your code meets all quality standards before submission.
+
+## License
+
+This project is licensed under the terms of the BSD 3-Clause license.
+
+## Acknowledgments
+
+-   **PDM:** For excellent dependency and virtual environment management.
+-   **Ruff:** For lightning-fast linting and code formatting.
+-   **pre-commit:** For the robust hook management system.
+-   **pytest:** For the flexible and powerful testing framework.
+-   **uv:** For greatly improving PDM speeds.
+- **bandit:** For finding security vulnerabilities.
+- **vulture:** for dead code detection.
+- **creosote:** For unused dependency detection.
+- **flynt:** For f-string conversion.
+- **codespell:** For spelling correction.
+- **autotyping:** For automatically adding type hints.
+- **refurb:** For code improvement suggestions.
+- **pyright:** For static type checking.
+- **Typer:** For the creation of the CLI.
+
+---

crackerjack-0.12.0/README.md

@@ -0,0 +1,186 @@
+# Crackerjack: Elevate Your Python Development
+
+[![Code style: crackerjack](https://img.shields.io/badge/code%20style-crackerjack-000042)](https://github.com/lesleslie/crackerjack)
+[![Python Version](https://img.shields.io/badge/python-3.13-blue.svg)](https://www.python.org/downloads/)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
+[![Checked with pyright](https://microsoft.github.io/pyright/img/pyright_badge.svg)](https://microsoft.github.io/pyright/)
+[![pdm-managed](https://img.shields.io/badge/pdm-managed-blueviolet)](https://pdm.fming.dev)
+[![security: bandit](https://img.shields.io/badge/security-bandit-yellow.svg)](https://github.com/PyCQA/bandit)
+[![License](https://img.shields.io/badge/License-BSD%203--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)
+
+**Crackerjack** (`ˈkra-kər-ˌjak`): *a person or thing of marked excellence.*
+
+Crackerjack is an opinionated Python project management tool designed to help you create, maintain, and publish high-quality Python projects with ease. It combines best-in-class tools and a streamlined workflow to ensure code quality, consistency, and reliability.
+
+## The Crackerjack Philosophy
+
+Crackerjack is built on the following core principles:
+
+-   **Code Clarity:** Code should be easy to read, understand, and maintain.
+-   **Automation:** Tedious tasks should be automated, allowing developers to focus on solving problems.
+-   **Consistency:** Code style, formatting, and project structure should be consistent across projects.
+-   **Reliability:** Tests are essential, and code should be checked rigorously.
+-   **Tool Integration:** Leverage powerful existing tools instead of reinventing the wheel.
+- **Static Typing:** Static typing is essential for all development.
+
+## Key Features
+
+Crackerjack provides:
+
+-   **Effortless Project Setup:** Initializes new Python projects with a standard directory structure, `pyproject.toml`, and essential configuration files.
+-   **PDM Integration:** Manages dependencies and virtual environments using [PDM](https://pdm.fming.dev/) (with [uv](https://github.com/astral-sh/uv) enabled for speed).
+-   **Automated Code Cleaning:** Removes unnecessary docstrings, line comments, and trailing whitespace.
+-   **Consistent Code Formatting:** Enforces a consistent style using [Ruff](https://github.com/astral-sh/ruff), the lightning-fast Python linter and formatter.
+-   **Comprehensive Pre-commit Hooks:** Installs and manages a robust suite of pre-commit hooks to ensure code quality (see the "Pre-commit Hooks" section below).
+-   **Interactive Checks:** Supports interactive pre-commit hooks (like `refurb`, `bandit`, and `pyright`) to allow you to fix issues in real-time.
+-   **Built-in Testing:** Automatically runs tests using `pytest`.
+-   **Easy Version Bumping:** Provides commands to bump the project version (micro, minor, or major).
+-   **Simplified Publishing:** Automates publishing to PyPI via PDM.
+- **Commit and Push:** Commits and pushes your changes.
+
+## Pre-commit Hooks
+
+Crackerjack automatically installs and manages these pre-commit hooks:
+
+1.  **pdm-lock-check:** Ensures the `pdm.lock` file is up to date.
+2.  **Core pre-commit-hooks:** Essential hooks from [pre-commit-hooks](https://github.com/pre-commit/pre-commit-hooks) (e.g., `trailing-whitespace`, `end-of-file-fixer`).
+3.  **Ruff:** [Ruff](https://github.com/astral-sh/ruff) for linting, code formatting, and general code style enforcement.
+4.  **Vulture:** [Vulture](https://github.com/jendrikseipp/vulture) to identify dead code.
+5.  **Creosote:** [Creosote](https://github.com/fredrikaverpil/creosote) to detect unused dependencies.
+6.  **Flynt:** [Flynt](https://github.com/ikamensh/flynt/) for converting string formatting to f-strings.
+7.  **Codespell:** [Codespell](https://github.com/codespell-project/codespell) for correcting typos in the code.
+8.  **Autotyping:** [Autotyping](https://github.com/JelleZijlstra/autotyping) for adding type hints.
+9.  **Refurb:** [Refurb](https://github.com/dosisod/refurb) to suggest code improvements.
+10. **Bandit:** [Bandit](https://github.com/PyCQA/bandit) to identify potential security vulnerabilities.
+11. **Pyright:** [Pyright](https://github.com/RobertCraigie/pyright-python) for static type checking.
+12. **Ruff (again):** A final Ruff pass to ensure all changes comply with the enforced style.
+
+## The Crackerjack Style Guide
+
+Crackerjack projects adhere to these guidelines:
+
+-   **Static Typing:** Use type hints consistently throughout your code.
+-   **Explicit Naming:** Choose clear, descriptive names for classes, functions, variables, and other identifiers.
+-   **Markdown for Documentation:** Use Markdown (`.md`) for all documentation, including docstrings, READMEs, etc.
+-   **Pathlib:** Use `pathlib.Path` for handling file and directory paths instead of `os.path`.
+-   **Consistent Imports:** Use `import typing as t` for type hinting.
+-   **Constants and Config:** Do not use all-caps for constants or configuration settings.
+-   **Path Parameters:** Functions that handle file operations should accept `pathlib.Path` objects as parameters.
+-   **Dependency Management:** Use PDM for dependency management, package building, and publishing.
+-   **Testing:** Use pytest as your testing framework.
+-   **Python Version:** Crackerjack projects support the latest Python versions.
+-   **Clear Code:** Avoid overly complex code.
+-   **Modular:** Functions should do one thing well.
+
+## Installation
+
+1.  **Python:** Ensure you have Python 3.13 installed.
+2.  **PDM:** Install [PDM](https://pdm.fming.dev/) using `pipx`:
+
+    ```
+    pipx install pdm
+    ```
+
+3.  **Crackerjack:** Install Crackerjack and initialize in your project root using:
+    ```
+    pip install crackerjack
+    cd your_project_root
+    python -m crackerjack
+    ```
+
+## Usage
+
+Run Crackerjack from the root of your Python project using:
+
+    python -m crackerjack
+
+
+### Command-Line Options
+
+-   `-c`, `--commit`: Commit changes to Git.
+-   `-i`, `--interactive`: Run pre-commit hooks interactively when possible.
+-   `-n`, `--no-config-updates`: Skip updating configuration files (e.g., `pyproject.toml`).
+-   `-u`, `--update-precommit`: Update pre-commit hooks to the latest versions.
+-   `-v`, `--verbose`: Enable verbose output.
+-   `-p`, `--publish <micro|minor|major>`: Bump the project version and publish to PyPI using PDM.
+-   `-b`, `--bump <micro|minor|major>`: Bump the project version without publishing.
+-   `-x`, `--clean`: Clean code by removing docstrings, line comments, and extra whitespace.
+-   `-t`, `--test`: Run tests using `pytest`.
+-   `-h`, `--help`: Display help.
+
+### Example Workflows
+
+-   **Run checks, bump version, publish, then commit:**
+    ```
+    python -m crackerjack -p minor -c
+    ```
+
+-   **Clean code, run checks, run tests, then commit:**
+    ````
+    python -m crackerjack -c -x -t
+    ```
+
+-   **Run checks skipping config updates:**
+    ```
+    python -m crackerjack -n
+    ```
+
+-   **Bump the version and publish to PyPI:**
+    ```
+    python -m crackerjack -p micro
+    ```
+
+-   **Bump the version without publishing:**
+    ```
+    python -m crackerjack -b major
+    ```
+- **Update pre-commit hooks:**
+    ```
+    python -m crackerjack -u
+    ```
+- **Get help:**
+    ```
+    python -m crackerjack -h
+    ```
+
+## Contributing
+
+Crackerjack is an evolving project. Contributions are welcome! Please open a pull request or issue.
+
+To contribute:
+
+1. Add Crackerjack as a development dependency to your project:
+  ```
+  pdm add -G dev crackerjack
+  ```
+
+2. Run checks and tests before submitting:
+  ```
+  python -m crackerjack -x -t
+  ```
+
+This ensures your code meets all quality standards before submission.
+
+## License
+
+This project is licensed under the terms of the BSD 3-Clause license.
+
+## Acknowledgments
+
+-   **PDM:** For excellent dependency and virtual environment management.
+-   **Ruff:** For lightning-fast linting and code formatting.
+-   **pre-commit:** For the robust hook management system.
+-   **pytest:** For the flexible and powerful testing framework.
+-   **uv:** For greatly improving PDM speeds.
+- **bandit:** For finding security vulnerabilities.
+- **vulture:** for dead code detection.
+- **creosote:** For unused dependency detection.
+- **flynt:** For f-string conversion.
+- **codespell:** For spelling correction.
+- **autotyping:** For automatically adding type hints.
+- **refurb:** For code improvement suggestions.
+- **pyright:** For static type checking.
+- **Typer:** For the creation of the CLI.
+
+---

{crackerjack-0.11.4 → crackerjack-0.12.0}/crackerjack/.gitignore

@@ -13,3 +13,5 @@
 /*.pyc
 /.crackerjack.yaml
 /scratch/
+
+.qodo

{crackerjack-0.11.4 → crackerjack-0.12.0}/crackerjack/.pre-commit-config.yaml

@@ -1,6 +1,6 @@
 repos:
   - repo: https://github.com/pdm-project/pdm
-    rev: 2.22.3  # a PDM release exposing the hook
+    rev: 2.22.4  # a PDM release exposing the hook
     hooks:
       - id: pdm-lock-check
   - repo: https://github.com/pre-commit/pre-commit-hooks
@@ -17,7 +17,7 @@ repos:
       - id: check-added-large-files
         name: check-added-large-files
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.9.9
+    rev: v0.9.10
     hooks:
       - id: ruff-format
       - id: ruff
@@ -69,7 +69,7 @@ repos:
     hooks:
       - id: pyright
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.9.9
+    rev: v0.9.10
     hooks:
       - id: ruff
       - id: ruff-format

crackerjack-0.12.0/crackerjack/.pytest_cache/.gitignore

@@ -0,0 +1,2 @@
+# Created by pytest automatically.
+*

crackerjack-0.12.0/crackerjack/.pytest_cache/CACHEDIR.TAG

@@ -0,0 +1,4 @@
+Signature: 8a477f597d28d172789f06886806bc55
+# This file is a cache directory tag created by pytest.
+# For information about cache directory tags, see:
+#	https://bford.info/cachedir/spec.html

crackerjack-0.12.0/crackerjack/.pytest_cache/README.md

@@ -0,0 +1,8 @@
+# pytest cache directory #
+
+This directory contains data from the pytest's cache plugin,
+which provides the `--lf` and `--ff` options, as well as the `cache` fixture.
+
+**Do not** commit this to version control.
+
+See [the docs](https://docs.pytest.org/en/stable/how-to/cache.html) for more information.

crackerjack-0.12.0/crackerjack/.pytest_cache/v/cache/nodeids

@@ -0,0 +1 @@
+[]

crackerjack-0.12.0/crackerjack/.pytest_cache/v/cache/stepwise

@@ -0,0 +1 @@
+[]

crackerjack-0.12.0/crackerjack/__init__.py

@@ -0,0 +1,4 @@
+from typing import Sequence
+from .crackerjack import Crackerjack, crackerjack_it
+
+__all__: Sequence[str] = ["crackerjack_it", "Crackerjack"]

crackerjack-0.12.0/crackerjack/__main__.py

@@ -0,0 +1,119 @@
+import typing as t
+from enum import Enum
+import typer
+from pydantic import BaseModel, field_validator
+from rich.console import Console
+from crackerjack import crackerjack_it
+
+console = Console(force_terminal=True)
+app = typer.Typer(
+    help="Crackerjack: Your Python project setup and style enforcement tool."
+)
+
+
+class BumpOption(str, Enum):
+    micro = "micro"
+    minor = "minor"
+    major = "major"
+
+    def __str__(self) -> str:
+        return self.value
+
+
+class Options(BaseModel):
+    commit: bool = False
+    interactive: bool = False
+    doc: bool = False
+    no_config_updates: bool = False
+    publish: t.Optional[BumpOption] = None
+    bump: t.Optional[BumpOption] = None
+    verbose: bool = False
+    update_precommit: bool = False
+    clean: bool = False
+    test: bool = False
+
+    @classmethod
+    @field_validator("publish", "bump", mode="before")
+    def validate_bump_options(cls, value: t.Optional[str]) -> t.Optional[BumpOption]:
+        if value is None:
+            return None
+        try:
+            return BumpOption(value.lower())
+        except ValueError:
+            valid_options = ", ".join([o.value for o in BumpOption])
+            raise ValueError(
+                f"Invalid bump option: {value}. Must be one of: {valid_options}"
+            )
+
+
+cli_options = {
+    "commit": typer.Option(False, "-c", "--commit", help="Commit changes to Git."),
+    "interactive": typer.Option(
+        False, "-i", "--interactive", help="Run pre-commit hooks interactively."
+    ),
+    "doc": typer.Option(False, "-d", "--doc", help="Generate documentation."),
+    "no_config_updates": typer.Option(
+        False, "-n", "--no-config-updates", help="Do not update configuration files."
+    ),
+    "update_precommit": typer.Option(
+        False, "-u", "--update-precommit", help="Update pre-commit hooks."
+    ),
+    "verbose": typer.Option(False, "-v", "--verbose", help="Enable verbose output."),
+    "publish": typer.Option(
+        None,
+        "-p",
+        "--publish",
+        help="Bump version and publish to PyPI (micro, minor, major).",
+        case_sensitive=False,
+    ),
+    "bump": typer.Option(
+        None,
+        "-b",
+        "--bump",
+        help="Bump version (micro, minor, major).",
+        case_sensitive=False,
+    ),
+    "clean": typer.Option(
+        False,
+        "-x",
+        "--clean",
+        help="Remove docstrings, line comments, and unnecessary whitespace.",
+    ),
+    "test": typer.Option(False, "-t", "--test", help="Run tests."),
+}
+
+
+def create_options(**kwargs: t.Any) -> Options:
+    return Options(**kwargs)
+
+
+@app.command()
+def main(
+    commit: bool = cli_options["commit"],
+    interactive: bool = cli_options["interactive"],
+    doc: bool = cli_options["doc"],
+    no_config_updates: bool = cli_options["no_config_updates"],
+    update_precommit: bool = cli_options["update_precommit"],
+    verbose: bool = cli_options["verbose"],
+    publish: t.Optional[BumpOption] = cli_options["publish"],
+    bump: t.Optional[BumpOption] = cli_options["bump"],
+    clean: bool = cli_options["clean"],
+    test: bool = cli_options["test"],
+) -> None:
+    options = create_options(
+        commit=commit,
+        interactive=interactive,
+        doc=doc,
+        no_config_updates=no_config_updates,
+        update_precommit=update_precommit,
+        verbose=verbose,
+        publish=publish,
+        bump=bump,
+        clean=clean,
+        test=test,
+    )
+    crackerjack_it(options)
+
+
+if __name__ == "__main__":
+    app()