crackerjack 0.12.1__py3-none-any.whl → 0.13.0__py3-none-any.whl

crackerjack/__init__.py

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

crackerjack/__main__.py

@@ -1,6 +1,5 @@
 import typing as t
 from enum import Enum
-
 import typer
 from pydantic import BaseModel, field_validator
 from rich.console import Console
@@ -32,6 +31,7 @@ class Options(BaseModel):
     update_precommit: bool = False
     clean: bool = False
     test: bool = False
+    all: t.Optional[BumpOption] = None
 
     @classmethod
     @field_validator("publish", "bump", mode="before")
@@ -81,6 +81,13 @@ cli_options = {
         help="Remove docstrings, line comments, and unnecessary whitespace.",
     ),
     "test": typer.Option(False, "-t", "--test", help="Run tests."),
+    "all": typer.Option(
+        None,
+        "-a",
+        "--all",
+        help="Run with `-x -t -p <micro|minor|major> -c` development options).",
+        case_sensitive=False,
+    ),
 }
 
 
@@ -97,6 +104,7 @@ def main(
     update_precommit: bool = cli_options["update_precommit"],
     verbose: bool = cli_options["verbose"],
     publish: t.Optional[BumpOption] = cli_options["publish"],
+    all: t.Optional[BumpOption] = cli_options["all"],
     bump: t.Optional[BumpOption] = cli_options["bump"],
     clean: bool = cli_options["clean"],
     test: bool = cli_options["test"],
@@ -112,6 +120,7 @@ def main(
         bump=bump,
         clean=clean,
         test=test,
+        all=all,
     )
     crackerjack_it(options)
 

crackerjack/crackerjack.py

@@ -8,7 +8,6 @@ from pathlib import Path
 from subprocess import CompletedProcess
 from subprocess import run as execute
 from tomllib import loads
-
 from pydantic import BaseModel
 from rich.console import Console
 from tomli_w import dumps
@@ -369,11 +368,10 @@ class Crackerjack(BaseModel, arbitrary_types_allowed=True):
         if options.clean:
             if self.pkg_dir:
                 self.code_cleaner.clean_files(self.pkg_dir)
-            if self.pkg_path.stem == "crackerjack":
-                tests_dir = self.pkg_path / "tests"
-                if tests_dir.exists() and tests_dir.is_dir():
-                    self.console.print("\nCleaning tests directory...\n")
-                    self.code_cleaner.clean_files(tests_dir)
+            tests_dir = self.pkg_path / "tests"
+            if tests_dir.exists() and tests_dir.is_dir():
+                self.console.print("\nCleaning tests directory...\n")
+                self.code_cleaner.clean_files(tests_dir)
 
     def _run_tests(self, options: t.Any) -> None:
         if options.test:
@@ -432,6 +430,11 @@ class Crackerjack(BaseModel, arbitrary_types_allowed=True):
         return execute(cmd, **kwargs)
 
     def process(self, options: t.Any) -> None:
+        if options.all:
+            options.clean = True
+            options.test = True
+            options.publish = options.all
+            options.commit = True
         self._setup_package()
         self._update_project(options)
         self._update_precommit(options)

crackerjack/pyproject.toml

@@ -120,7 +120,7 @@ pythonPlatform = "Darwin"
 
 [project]
 name = "crackerjack"
-version = "0.12.0"
+version = "0.12.1"
 description = "Default template for PDM package"
 requires-python = ">=3.13"
 readme = "README.md"

{crackerjack-0.12.1.dist-info → crackerjack-0.13.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: crackerjack
-Version: 0.12.1
+Version: 0.13.0
 Summary: Default template for PDM package
 Keywords: black,ruff,mypy,creosote,refurb
 Author-Email: lesleslie <les@wedgwoodwebworks.com>
@@ -52,6 +52,31 @@ Description-Content-Type: text/markdown
 
 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.
 
+---
+
+## Getting Started
+
+### Quick Start
+
+If you're new to Crackerjack, follow these steps:
+1. **Install Python 3.13:** Ensure you have Python 3.13 installed.
+2. **Install PDM:**
+    ```
+    pipx install pdm
+    ```
+3. **Install Crackerjack:**
+    ```
+    pip install crackerjack
+    ```
+
+4. **Initialize a New Project:**
+    Navigate to your project's root directory and run:
+    ```
+    python -m crackerjack
+    ```
+
+---
+
 ## The Crackerjack Philosophy
 
 Crackerjack is built on the following core principles:
@@ -61,7 +86,7 @@ Crackerjack is built on the following core principles:
 -   **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.
+-   **Static Typing:** Static typing is essential for all development.
 
 ## Key Features
 
@@ -76,7 +101,7 @@ Crackerjack provides:
 -   **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.
+-   **Commit and Push:** Commits and pushes your changes.
 
 ## Pre-commit Hooks
 
@@ -101,7 +126,7 @@ 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.
+-   **Markdown for Documentation:** Use Markdown (`.md`) for all documentation, 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.
@@ -141,12 +166,14 @@ Run Crackerjack from the root of your Python project using:
 -   `-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.
+-   `-d`, `--doc`: Generate documentation.  (not yet implemented)
+-   `-v`, `--verbose`: Enable verbose output. (not yet implemented)
 -   `-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.
+-   `-a`, `--all`: Run with `-x -t -p <micro|minor|major> -c` development options.
+-   `--help`: Display help.
 
 ### Example Workflows
 
@@ -156,7 +183,7 @@ Run Crackerjack from the root of your Python project using:
     ```
 
 -   **Clean code, run checks, run tests, then commit:**
-    ````
+    ```
     python -m crackerjack -c -x -t
     ```
 
@@ -174,15 +201,27 @@ Run Crackerjack from the root of your Python project using:
     ```
     python -m crackerjack -b major
     ```
+
 - **Update pre-commit hooks:**
     ```
     python -m crackerjack -u
     ```
+
 - **Get help:**
     ```
-    python -m crackerjack -h
+    python -m crackerjack --help
     ```
 
+- **Clean code, run checks, run tests, bump version, publish, then commit:**
+    ```
+  python -m crackerjack -x -t -p minor -c
+
+  # or even easier
+
+  python -m crackerjack -a minor
+  ```
+
+
 ## Contributing
 
 Crackerjack is an evolving project. Contributions are welcome! Please open a pull request or issue.

{crackerjack-0.12.1.dist-info → crackerjack-0.13.0.dist-info}/RECORD

@@ -1,7 +1,7 @@
-crackerjack-0.12.1.dist-info/METADATA,sha256=I2aFmCJgCcocNUMVzGABrwtECMia6jR_wQ-unCxTaQM,10289
-crackerjack-0.12.1.dist-info/WHEEL,sha256=thaaA2w1JzcGC48WYufAs8nrYZjJm8LqNfnXFOFyCC4,90
-crackerjack-0.12.1.dist-info/entry_points.txt,sha256=6OYgBcLyFCUgeqLgnvMyOJxPCWzgy7se4rLPKtNonMs,34
-crackerjack-0.12.1.dist-info/licenses/LICENSE,sha256=fDt371P6_6sCu7RyqiZH_AhT1LdN3sN1zjBtqEhDYCk,1531
+crackerjack-0.13.0.dist-info/METADATA,sha256=tosPl42vttJ7H3wxdi5HBsCg83BTAIFRfMoxvh5U5jQ,11055
+crackerjack-0.13.0.dist-info/WHEEL,sha256=thaaA2w1JzcGC48WYufAs8nrYZjJm8LqNfnXFOFyCC4,90
+crackerjack-0.13.0.dist-info/entry_points.txt,sha256=6OYgBcLyFCUgeqLgnvMyOJxPCWzgy7se4rLPKtNonMs,34
+crackerjack-0.13.0.dist-info/licenses/LICENSE,sha256=fDt371P6_6sCu7RyqiZH_AhT1LdN3sN1zjBtqEhDYCk,1531
 crackerjack/.coverage,sha256=dLzPzp72qZEXohNfxnOAlRwvM9dqF06-HoFqfvXZd1U,53248
 crackerjack/.gitignore,sha256=l8ErBAypC3rI6N9lhc7ZMdOw87t0Tz69ZW5C6uj15Wg,214
 crackerjack/.libcst.codemod.yaml,sha256=a8DlErRAIPV1nE6QlyXPAzTOgkB24_spl2E9hphuf5s,772
@@ -40,13 +40,13 @@ crackerjack/.ruff_cache/0.7.1/1024065805990144819,sha256=3Sww592NB0PWBNHU_UIqvqg
 crackerjack/.ruff_cache/0.7.1/285614542852677309,sha256=mOHKRzKoSvW-1sHtqI_LHWRt-mBinJ4rQRtp9Yqzv5I,224
 crackerjack/.ruff_cache/0.7.3/16061516852537040135,sha256=AWJR9gmaO7-wpv8mY1homuwI8CrMPI3VrnbXH-wRPlg,224
 crackerjack/.ruff_cache/0.8.4/16354268377385700367,sha256=Ksz4X8N6Z1i83N0vV1PxmBRlqgjrtzmDCOg7VBF4baQ,224
-crackerjack/.ruff_cache/0.9.10/12813592349865671909,sha256=yZM3VVwJk77yGcduPLDw3Nc7SZ5dFMXXaXfWCwspfRU,224
+crackerjack/.ruff_cache/0.9.10/12813592349865671909,sha256=ljyRwrfGnholtUN-9x9096LMPL8qRpp8G_h_zDCZvnE,224
 crackerjack/.ruff_cache/0.9.3/13948373885254993391,sha256=kGhtIkzPUtKAgvlKs3D8j4QM4qG8RhsHrmQJI69Sv3o,224
 crackerjack/.ruff_cache/0.9.9/12813592349865671909,sha256=tmr8_vhRD2OxsVuMfbJPdT9fDFX-d5tfC5U9jgziyho,224
 crackerjack/.ruff_cache/0.9.9/8843823720003377982,sha256=e4ymkXfQsUg5e_mtO34xTsaTvs1uA3_fI216Qq9qCAM,136
 crackerjack/.ruff_cache/CACHEDIR.TAG,sha256=WVMVbX4MVkpCclExbq8m-IcOZIOuIZf5FrYw5Pk-Ma4,43
-crackerjack/__init__.py,sha256=XTWW_XQkWR6dSydFSLg-T--eY3TPKUp4jUwZP11kgwY,142
-crackerjack/__main__.py,sha256=D9gxXzFDQMND-y680cTlL5kIg74HgbCzMzsz0BtoPJs,3486
-crackerjack/crackerjack.py,sha256=MzNIzmbhhaGMDssp-TylLukVQfUfeDBY_vXAD7mI7aY,17907
-crackerjack/pyproject.toml,sha256=9A-gUuOZpXTwlY1zp_PAxGz7hqsNUkNgzFiQnkkWTJI,3442
-crackerjack-0.12.1.dist-info/RECORD,,
+crackerjack/__init__.py,sha256=EOKnIXfBAvxS55uPkpk5DbcNqVS29wja_IcCPaGwyus,141
+crackerjack/__main__.py,sha256=11gg9itMrUY7-7vPFGc1MrNOuOFIzdm0vheW_PMS_Gk,3783
+crackerjack/crackerjack.py,sha256=RUj2OQ6gnTavj5dfQuAVd1-rWxmGiamR7gnVd8Cfkrs,18003
+crackerjack/pyproject.toml,sha256=T55z6QM_uW0MYsh5y4ufm4NAKU5_6MADcbEw2i5GOYY,3442
+crackerjack-0.13.0.dist-info/RECORD,,