cli-wizard 2.1.0__tar.gz → 3.0.0__tar.gz

{cli_wizard-2.1.0/src/cli_wizard.egg-info → cli_wizard-3.0.0}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: cli-wizard
-Version: 2.1.0
+Version: 3.0.0
 Summary: Generate modern CLIs from OpenAPI specifications
 Author-email: Giacomo Marciani <giacomo.marciani@gmail.com>
 License: MIT
-Project-URL: Homepage, https://github.com/gmarciani/cli-wizard
+Project-URL: Homepage, https://gmarciani.github.io/cli-wizard/
 Project-URL: Repository, https://github.com/gmarciani/cli-wizard
 Project-URL: Issues, https://github.com/gmarciani/cli-wizard/issues
 Classifier: Development Status :: 5 - Production/Stable
@@ -23,22 +23,6 @@ Requires-Dist: pydantic~=2.13
 Requires-Dist: PyYAML~=6.0
 Requires-Dist: requests~=2.34
 Requires-Dist: ruff~=0.16.2
-Provides-Extra: dev
-Requires-Dist: build~=1.5; extra == "dev"
-Requires-Dist: mypy~=2.3; extra == "dev"
-Requires-Dist: pre-commit~=4.6; extra == "dev"
-Requires-Dist: pytest~=9.1; extra == "dev"
-Requires-Dist: pytest-cov~=7.1; extra == "dev"
-Requires-Dist: tox~=4.58; extra == "dev"
-Requires-Dist: twine<8.0,>=6.2; extra == "dev"
-Requires-Dist: types-PyYAML~=6.0; extra == "dev"
-Requires-Dist: types-requests~=2.33; extra == "dev"
-Provides-Extra: docs
-Requires-Dist: sphinx~=9.1; extra == "docs"
-Requires-Dist: sphinx-click~=6.2; extra == "docs"
-Requires-Dist: sphinx-rtd-theme~=3.1; extra == "docs"
-Requires-Dist: sphinx-new-tab-link~=0.8; extra == "docs"
-Requires-Dist: autodoc_pydantic~=2.2; extra == "docs"
 Dynamic: license-file
 
 # CLI WIZARD
@@ -47,7 +31,7 @@ Dynamic: license-file
 <img src="https://raw.githubusercontent.com/gmarciani/cli-wizard/main/resources/brand/banner.png" alt="cli-wizard-banner" width="500">
 
 [![PyPI version](https://img.shields.io/pypi/v/cli-wizard.svg)](https://pypi.org/project/cli-wizard)
-[![Python versions](https://img.shields.io/pypi/pyversions/cli-wizard.svg)](https://pypi.org/project/cli-wizard)
+[![Python versions](https://img.shields.io/badge/python-3.12%20%7C%203.13%20%7C%203.14-blue.svg)](https://pypi.org/project/cli-wizard)
 [![License](https://img.shields.io/github/license/gmarciani/cli-wizard.svg)](https://github.com/gmarciani/cli-wizard/blob/main/LICENSE)
 [![Build status](https://img.shields.io/github/actions/workflow/status/gmarciani/cli-wizard/test.yaml?branch=main)](https://github.com/gmarciani/cli-wizard/actions)
 [![Tests](https://img.shields.io/github/actions/workflow/status/gmarciani/cli-wizard/test.yaml?branch=main&label=tests)](https://github.com/gmarciani/cli-wizard/actions)
@@ -76,7 +60,7 @@ Generate modern CLIs from OpenAPI specifications.
 - Automatic command grouping based on OpenAPI tags
 - Automatic help generation for all commands
 - Clean, colored terminal output
-- `--debug` flag for verbose logging
+- `--debug` flag for verbose logging, with credentials redacted from the output
 - Built-in API client with configurable base URL and timeout
 - SSL/TLS support with custom CA certificate bundles
 - `--ca-file` option to specify custom CA certificates at runtime
@@ -92,7 +76,13 @@ Generate modern CLIs from OpenAPI specifications.
 
 ### Developer Experience
 - Generated projects are pip-installable out of the box
-- Auto-generated `pyproject.toml`, `README.md`, and `VERSION`
+- Auto-generated `pyproject.toml` and `VERSION`
+- Auto-generated `README.md` with commands and configuration reference
+- Auto-generated `DEVELOPMENT.md`, `CHANGELOG.md` and `LICENSE`
+- Test suite for the generated CLI, ready to run
+- `tox.ini` with test, lint, type, format and coverage environments, plus a `Makefile` wrapping them
+- Pre-commit configuration running ruff and mypy
+- Optional GitHub setup (`IncludeGithubWorkflows`): test, release, docs, PR validation, CodeQL, changelog and labeler workflows, plus Dependabot, issue and PR templates, and `CODEOWNERS`
 - Resources (CA certs, splash files) bundled in the package
 - Profile management for storing credentials and settings
 
@@ -125,51 +115,74 @@ paths:
           description: OK
 ```
 
-### Step 2: Create a Configuration File
+### Step 2: Generate the CLI
 
-Create a `cli-wizard.yaml` file with your CLI settings. At minimum, you need `PackageName` and `DefaultBaseUrl`:
+Run the `generate` command, passing the OpenAPI spec and a project name:
+
+```shell
+cli-wizard generate --api openapi.yaml --project-name "My CLI"
+```
+
+This creates a complete Python CLI project in the `my-cli` directory: the
+command name derives from the project name, and every other setting takes its
+default. Pass `--output` to write it elsewhere.
+
+### Step 3: Install the Generated CLI
+
+Navigate to the generated project and install it:
+
+```shell
+pip install -e my-cli
+```
+
+### Step 4: Use Your CLI
+
+Your CLI is now ready to use:
+
+```shell
+my-cli --help
+my-cli users list-users
+```
+
+### Step 5: Customize with a Configuration File
+
+To go beyond the defaults, create a `cli-wizard.yaml` file with the settings you
+want to change. Every parameter is optional:
 
 ```yaml
-# Required parameters
-PackageName: "my-cli"
+ProjectName: "My CLI"
 DefaultBaseUrl: "https://api.example.com"
 
-# Optional: customize the splash screen
+# Customize the splash screen
 SplashFile: "splash.txt"
 SplashColor: "#00FFFF"
 
-# Optional: filter which tags to include
+# Filter which tags to include
 IncludeTags:
   - Users
   - Products
 ```
 
-### Step 3: Generate the CLI
-
-Run the `generate` command:
+Then generate from it. The project lands in the current directory, in a
+directory named after `CommandName`:
 
 ```shell
-cli-wizard generate --openapi openapi.yaml --config cli-wizard.yaml --output my-cli
+cli-wizard generate --configuration cli-wizard.yaml --api openapi.yaml
 ```
 
-This creates a complete Python CLI project in the `my-cli` directory.
+### Starting Without a Specification
 
-### Step 4: Install the Generated CLI
-
-Navigate to the generated project and install it:
+To start from scratch instead, run `bootstrap`. It prompts for the main
+settings, writes a commented `cli-wizard.yaml`, and generates a basic CLI from
+it, without API commands. The CLI lands in the current directory, in a
+directory named after `CommandName`; pass `--output` to write it elsewhere:
 
 ```shell
-pip install -e my-cli
+cli-wizard bootstrap --configuration cli-wizard.yaml
 ```
 
-### Step 5: Use Your CLI
-
-Your CLI is now ready to use:
-
-```shell
-my-cli --help
-my-cli users list-users
-```
+Then edit the configuration, point `Api` at your specification, and rebuild
+with `cli-wizard generate --configuration cli-wizard.yaml`.
 
 ## Configuration
 
@@ -180,17 +193,34 @@ See the [examples](examples/) directory for complete configuration examples.
 
 ### cli-wizard generate
 
-Generate a CLI from an OpenAPI specification and configuration file.
+Generate a CLI from an OpenAPI specification, with an optional configuration file.
 
 ```shell
 cli-wizard generate [OPTIONS]
 ```
 
 Options:
-- `--openapi, -o` - Path to OpenAPI spec file (default: `openapi.yaml`)
-- `--config, -c` - Path to config YAML file (default: `cli-wizard.yaml`)
-- `--output, -d` - Output directory for generated CLI (default: `cli`)
-- `--working-dir, -w` - Working directory for resolving relative paths
+- `--api, -a` - Path to the OpenAPI spec file, YAML or JSON. Without it and without `Api` in the configuration, the CLI is generated without API commands
+- `--configuration, -c` - Path to the `cli-wizard.yaml` configuration file. Without it, every parameter takes its default
+- `--project-name, -p` - Human-readable project name; the generated command name derives from it, unless the configuration sets it
+- `--output, -o` - Output directory (default: a directory named after `CommandName` in the current directory)
+- `--force, -f` - Skip the confirmation prompt when the output directory is not empty
+
+### cli-wizard bootstrap
+
+Bootstrap a new CLI project interactively, without an OpenAPI specification.
+It does two things: it writes a configuration file to evolve the project from,
+then generates a basic CLI from that file, without API commands, in the output
+directory.
+
+```shell
+cli-wizard bootstrap [OPTIONS]
+```
+
+Options:
+- `--configuration, -c` - Path for the `cli-wizard.yaml` configuration file (default: `./cli-wizard.yaml`). An existing file is overwritten, after confirmation, without keeping any of its values
+- `--output, -o` - Output directory of the basic CLI (default: a directory named after `CommandName` in the current directory)
+- `--force, -f` - Skip the confirmation prompts to overwrite an existing configuration file or to write into a non-empty directory
 
 ## Issues
 

{cli_wizard-2.1.0 → cli_wizard-3.0.0}/README.md

@@ -4,7 +4,7 @@
 <img src="https://raw.githubusercontent.com/gmarciani/cli-wizard/main/resources/brand/banner.png" alt="cli-wizard-banner" width="500">
 
 [![PyPI version](https://img.shields.io/pypi/v/cli-wizard.svg)](https://pypi.org/project/cli-wizard)
-[![Python versions](https://img.shields.io/pypi/pyversions/cli-wizard.svg)](https://pypi.org/project/cli-wizard)
+[![Python versions](https://img.shields.io/badge/python-3.12%20%7C%203.13%20%7C%203.14-blue.svg)](https://pypi.org/project/cli-wizard)
 [![License](https://img.shields.io/github/license/gmarciani/cli-wizard.svg)](https://github.com/gmarciani/cli-wizard/blob/main/LICENSE)
 [![Build status](https://img.shields.io/github/actions/workflow/status/gmarciani/cli-wizard/test.yaml?branch=main)](https://github.com/gmarciani/cli-wizard/actions)
 [![Tests](https://img.shields.io/github/actions/workflow/status/gmarciani/cli-wizard/test.yaml?branch=main&label=tests)](https://github.com/gmarciani/cli-wizard/actions)
@@ -33,7 +33,7 @@ Generate modern CLIs from OpenAPI specifications.
 - Automatic command grouping based on OpenAPI tags
 - Automatic help generation for all commands
 - Clean, colored terminal output
-- `--debug` flag for verbose logging
+- `--debug` flag for verbose logging, with credentials redacted from the output
 - Built-in API client with configurable base URL and timeout
 - SSL/TLS support with custom CA certificate bundles
 - `--ca-file` option to specify custom CA certificates at runtime
@@ -49,7 +49,13 @@ Generate modern CLIs from OpenAPI specifications.
 
 ### Developer Experience
 - Generated projects are pip-installable out of the box
-- Auto-generated `pyproject.toml`, `README.md`, and `VERSION`
+- Auto-generated `pyproject.toml` and `VERSION`
+- Auto-generated `README.md` with commands and configuration reference
+- Auto-generated `DEVELOPMENT.md`, `CHANGELOG.md` and `LICENSE`
+- Test suite for the generated CLI, ready to run
+- `tox.ini` with test, lint, type, format and coverage environments, plus a `Makefile` wrapping them
+- Pre-commit configuration running ruff and mypy
+- Optional GitHub setup (`IncludeGithubWorkflows`): test, release, docs, PR validation, CodeQL, changelog and labeler workflows, plus Dependabot, issue and PR templates, and `CODEOWNERS`
 - Resources (CA certs, splash files) bundled in the package
 - Profile management for storing credentials and settings
 
@@ -82,51 +88,74 @@ paths:
           description: OK
 ```
 
-### Step 2: Create a Configuration File
+### Step 2: Generate the CLI
 
-Create a `cli-wizard.yaml` file with your CLI settings. At minimum, you need `PackageName` and `DefaultBaseUrl`:
+Run the `generate` command, passing the OpenAPI spec and a project name:
+
+```shell
+cli-wizard generate --api openapi.yaml --project-name "My CLI"
+```
+
+This creates a complete Python CLI project in the `my-cli` directory: the
+command name derives from the project name, and every other setting takes its
+default. Pass `--output` to write it elsewhere.
+
+### Step 3: Install the Generated CLI
+
+Navigate to the generated project and install it:
+
+```shell
+pip install -e my-cli
+```
+
+### Step 4: Use Your CLI
+
+Your CLI is now ready to use:
+
+```shell
+my-cli --help
+my-cli users list-users
+```
+
+### Step 5: Customize with a Configuration File
+
+To go beyond the defaults, create a `cli-wizard.yaml` file with the settings you
+want to change. Every parameter is optional:
 
 ```yaml
-# Required parameters
-PackageName: "my-cli"
+ProjectName: "My CLI"
 DefaultBaseUrl: "https://api.example.com"
 
-# Optional: customize the splash screen
+# Customize the splash screen
 SplashFile: "splash.txt"
 SplashColor: "#00FFFF"
 
-# Optional: filter which tags to include
+# Filter which tags to include
 IncludeTags:
   - Users
   - Products
 ```
 
-### Step 3: Generate the CLI
-
-Run the `generate` command:
+Then generate from it. The project lands in the current directory, in a
+directory named after `CommandName`:
 
 ```shell
-cli-wizard generate --openapi openapi.yaml --config cli-wizard.yaml --output my-cli
+cli-wizard generate --configuration cli-wizard.yaml --api openapi.yaml
 ```
 
-This creates a complete Python CLI project in the `my-cli` directory.
+### Starting Without a Specification
 
-### Step 4: Install the Generated CLI
-
-Navigate to the generated project and install it:
+To start from scratch instead, run `bootstrap`. It prompts for the main
+settings, writes a commented `cli-wizard.yaml`, and generates a basic CLI from
+it, without API commands. The CLI lands in the current directory, in a
+directory named after `CommandName`; pass `--output` to write it elsewhere:
 
 ```shell
-pip install -e my-cli
+cli-wizard bootstrap --configuration cli-wizard.yaml
 ```
 
-### Step 5: Use Your CLI
-
-Your CLI is now ready to use:
-
-```shell
-my-cli --help
-my-cli users list-users
-```
+Then edit the configuration, point `Api` at your specification, and rebuild
+with `cli-wizard generate --configuration cli-wizard.yaml`.
 
 ## Configuration
 
@@ -137,17 +166,34 @@ See the [examples](examples/) directory for complete configuration examples.
 
 ### cli-wizard generate
 
-Generate a CLI from an OpenAPI specification and configuration file.
+Generate a CLI from an OpenAPI specification, with an optional configuration file.
 
 ```shell
 cli-wizard generate [OPTIONS]
 ```
 
 Options:
-- `--openapi, -o` - Path to OpenAPI spec file (default: `openapi.yaml`)
-- `--config, -c` - Path to config YAML file (default: `cli-wizard.yaml`)
-- `--output, -d` - Output directory for generated CLI (default: `cli`)
-- `--working-dir, -w` - Working directory for resolving relative paths
+- `--api, -a` - Path to the OpenAPI spec file, YAML or JSON. Without it and without `Api` in the configuration, the CLI is generated without API commands
+- `--configuration, -c` - Path to the `cli-wizard.yaml` configuration file. Without it, every parameter takes its default
+- `--project-name, -p` - Human-readable project name; the generated command name derives from it, unless the configuration sets it
+- `--output, -o` - Output directory (default: a directory named after `CommandName` in the current directory)
+- `--force, -f` - Skip the confirmation prompt when the output directory is not empty
+
+### cli-wizard bootstrap
+
+Bootstrap a new CLI project interactively, without an OpenAPI specification.
+It does two things: it writes a configuration file to evolve the project from,
+then generates a basic CLI from that file, without API commands, in the output
+directory.
+
+```shell
+cli-wizard bootstrap [OPTIONS]
+```
+
+Options:
+- `--configuration, -c` - Path for the `cli-wizard.yaml` configuration file (default: `./cli-wizard.yaml`). An existing file is overwritten, after confirmation, without keeping any of its values
+- `--output, -o` - Output directory of the basic CLI (default: a directory named after `CommandName` in the current directory)
+- `--force, -f` - Skip the confirmation prompts to overwrite an existing configuration file or to write into a non-empty directory
 
 ## Issues
 

cli_wizard-3.0.0/VERSION

@@ -0,0 +1 @@
+3.0.0

{cli_wizard-2.1.0 → cli_wizard-3.0.0}/pyproject.toml

@@ -30,15 +30,32 @@ dependencies = [
     "ruff~=0.16.2",
 ]
 
-[project.optional-dependencies]
+[project.scripts]
+cli-wizard = "cli_wizard.cli:main"
+
+[project.urls]
+Homepage = "https://gmarciani.github.io/cli-wizard/"
+Repository = "https://github.com/gmarciani/cli-wizard"
+Issues = "https://github.com/gmarciani/cli-wizard/issues"
+
+# Local-only tooling (PEP 735). Groups are never published, so none of this
+# reaches anyone installing cli-wizard from an index. There are no extras: the
+# built distributions carry no tests, so a published test extra would only
+# install pytest for a consumer with nothing to run it against.
+[dependency-groups]
 dev = [
+    {include-group = "test"},
+    {include-group = "docs"},
     "build~=1.5",
-    "mypy~=2.3",
     "pre-commit~=4.6",
-    "pytest~=9.1",
-    "pytest-cov~=7.1",
     "tox~=4.58",
     "twine>=6.2,<8.0",
+]
+# mypy and the stubs too: the suite type checks the code it generates.
+test = [
+    "mypy~=2.3",
+    "pytest~=9.1",
+    "pytest-cov~=7.1",
     "types-PyYAML~=6.0",
     "types-requests~=2.33",
 ]
@@ -50,14 +67,6 @@ docs = [
     "autodoc_pydantic~=2.2",
 ]
 
-[project.scripts]
-cli-wizard = "cli_wizard.cli:main"
-
-[project.urls]
-Homepage = "https://github.com/gmarciani/cli-wizard"
-Repository = "https://github.com/gmarciani/cli-wizard"
-Issues = "https://github.com/gmarciani/cli-wizard/issues"
-
 [tool.setuptools.packages.find]
 where = ["src"]
 include = ["cli_wizard*"]
@@ -74,18 +83,35 @@ cli_wizard = [
 [tool.setuptools.dynamic]
 version = {file = "VERSION"}
 
+# Ruff targets the oldest supported version: it emits syntax valid for the
+# target, and newer syntax would be a SyntaxError on 3.12.
 [tool.ruff]
 line-length = 88
 target-version = "py312"
 
 [tool.ruff.lint]
-select = ["E", "F", "W", "I"]
+# E/W pycodestyle, F pyflakes, I isort, B bugbear, S bandit, UP pyupgrade
+select = ["E", "F", "W", "I", "B", "S", "UP"]
 
+[tool.ruff.lint.per-file-ignores]
+# Tests assert by design.
+"tests/**" = ["S101"]
+
+# mypy checks against the default interpreter, the newest supported version.
 [tool.mypy]
-python_version = "3.12"
+python_version = "3.14"
 warn_return_any = true
 warn_unused_configs = true
 disallow_untyped_defs = true
 
 [tool.coverage.run]
 omit = ["*/__init__.py"]
+
+[tool.coverage.report]
+fail_under = 90
+
+[tool.pytest.ini_options]
+# Import cli_wizard from the checkout being tested. The editable install names
+# one checkout in its .pth file, so a run started from a git worktree would
+# otherwise import that other checkout.
+pythonpath = ["src"]

cli_wizard-3.0.0/src/cli_wizard/cli.py

@@ -0,0 +1,67 @@
+# Copyright (c) 2026, Giacomo Marciani
+# Licensed under the MIT License
+
+"""Main CLI module for CLI Wizard."""
+
+import logging
+import traceback
+from typing import Any
+
+import click
+
+from cli_wizard.commands.bootstrap import bootstrap
+from cli_wizard.commands.common import configure_logging, debug_option
+from cli_wizard.commands.config import config
+from cli_wizard.commands.generate import generate
+from cli_wizard.constants import __version__
+from cli_wizard.errors import UnexpectedError, reported
+
+logger = logging.getLogger(__name__)
+
+
+class RootGroup(click.Group):
+    """The root group, reporting what Click raises on its own as JSON too.
+
+    Click's main() shows a ClickException and exits with its code; wrapping the
+    parsing and the dispatch turns everything else into one of cli-wizard's
+    errors first, so every failure is the one JSON document on stdout.
+    """
+
+    def make_context(
+        self,
+        info_name: str | None,
+        args: list[str],
+        parent: click.Context | None = None,
+        **extra: Any,
+    ) -> click.Context:
+        with reported():
+            return super().make_context(info_name, args, parent, **extra)
+
+    def invoke(self, ctx: click.Context) -> Any:
+        try:
+            with reported():
+                return super().invoke(ctx)
+        except UnexpectedError as e:
+            # The traceback the bug came with, kept for --debug
+            logger.debug("".join(traceback.format_exception(e.__cause__)))
+            raise
+
+
+@click.group(cls=RootGroup, help="CLI Wizard - Generate modern CLI from OpenAPI.")
+@click.version_option(version=__version__, prog_name="cli-wizard")
+@debug_option
+@click.pass_context
+def main(ctx: click.Context, debug: bool) -> None:
+    """Main CLI entry point."""
+    ctx.ensure_object(dict)
+    ctx.obj["debug"] = debug
+    configure_logging(debug)
+
+
+main.add_command(bootstrap)
+main.add_command(config)
+main.add_command(generate)
+
+
+if __name__ == "__main__":
+    main()