openapi2cli 0.1.0__tar.gz → 0.1.1__tar.gz

openapi2cli-0.1.1/.github/workflows/ci.yml

@@ -0,0 +1,53 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+    tags: ['v*']
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --all-extras --dev
+
+      - name: Lint with ruff
+        run: uv run ruff check .
+
+      - name: Run tests
+        run: uv run pytest
+
+  publish:
+    needs: test
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        env:
+          UV_PUBLISH_TOKEN: ${{ secrets.PYPI_TOKEN }}
+        run: uv publish --token $UV_PUBLISH_TOKEN
+        continue-on-error: true  # Don't fail if version already exists

openapi2cli-0.1.1/AGENTS.md

@@ -0,0 +1,90 @@
+# AGENTS.md
+
+Instructions for AI agents working on this repository.
+
+## Overview
+
+**openapi2cli** generates CLI tools from OpenAPI 3.x specs. Built for AI agents who need to interact with APIs.
+
+## Development
+
+### Setup
+
+```bash
+git clone https://github.com/Olafs-World/openapi2cli.git
+cd openapi2cli
+uv sync
+```
+
+### Running Tests
+
+```bash
+uv run pytest
+uv run ruff check .
+```
+
+### Testing Locally
+
+```bash
+uv run openapi2cli generate https://httpbin.org/spec.json --name httpbin
+python httpbin_cli.py --help
+```
+
+## Project Structure
+
+```
+openapi2cli/
+├── __init__.py      # Package exports
+├── cli.py           # CLI entry point (argparse)
+├── parser.py        # OpenAPI spec parsing
+├── generator.py     # CLI code generation
+├── runtime.py       # Runtime helpers for generated CLIs
+tests/
+├── test_cli.py      # CLI tests
+├── test_parser.py   # Parser tests
+├── test_generator.py # Generator tests
+├── test_runtime.py  # Runtime tests
+├── test_e2e.py      # End-to-end tests
+```
+
+## Making a Release
+
+1. **Bump version** in `pyproject.toml`
+2. **Update CHANGELOG.md** with changes under new version header
+3. **Commit**: `git commit -am "Bump version to X.Y.Z"`
+4. **Tag**: `git tag vX.Y.Z`
+5. **Push**: `git push && git push --tags`
+
+CI will automatically publish to PyPI when the tag is pushed.
+
+## Code Style
+
+- Use `ruff` for linting
+- Follow existing patterns in the codebase
+- Generated CLIs should be standalone (single file, minimal deps)
+- Support common auth patterns (API key, Bearer, Basic)
+
+## Architecture
+
+1. **Parser** - Reads OpenAPI spec, extracts endpoints/params
+2. **Generator** - Creates Python CLI code from parsed spec
+3. **Runtime** - Helper functions used by generated CLIs
+
+## Limitations to Address
+
+- Only OpenAPI 3.x (not Swagger 2.0)
+- No file upload support yet
+- OAuth2 flows not fully implemented
+- Complex nested request bodies need `--data` JSON flag
+
+## Dependencies
+
+- `pyyaml` - YAML parsing
+- `requests` - HTTP client (for generated CLIs)
+- `pytest` - Testing (dev)
+- `ruff` - Linting (dev)
+
+## Git Conventions
+
+- Commit messages: imperative mood ("Add feature" not "Added feature")
+- Co-author AI contributions: `Co-authored-by: olaf-s-app[bot] <259723076+olaf-s-app[bot]@users.noreply.github.com>`

openapi2cli-0.1.1/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.1] - 2026-02-06
+
+### Fixed
+- Use absolute URL for banner image on PyPI
+
+## [0.1.0] - 2026-02-05
+
+### Added
+- Initial release
+- Generate CLI tools from OpenAPI 3.x specs
+- Support for API key, Bearer token, and Basic auth
+- Path, query, header, and body parameters
+- JSON and text output formats
+- Dry-run mode to preview requests

{openapi2cli-0.1.0 → openapi2cli-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: openapi2cli
-Version: 0.1.0
+Version: 0.1.1
 Summary: Generate CLI tools from OpenAPI specs — built for AI agents
 Project-URL: Homepage, https://github.com/Olafs-World/openapi2cli
 Project-URL: Repository, https://github.com/Olafs-World/openapi2cli
@@ -31,6 +31,8 @@ Requires-Dist: pytest>=7.0; extra == 'dev'
 Requires-Dist: ruff>=0.1; extra == 'dev'
 Description-Content-Type: text/markdown
 
+![openapi2cli banner](https://raw.githubusercontent.com/Olafs-World/openapi2cli/main/banner.png)
+
 # openapi2cli 🔧
 
 [![CI](https://github.com/Olafs-World/openapi2cli/actions/workflows/ci.yml/badge.svg)](https://github.com/Olafs-World/openapi2cli/actions/workflows/ci.yml)
@@ -62,6 +64,39 @@ AI agents are great at executing CLI commands. They're less great at crafting HT
 
 ## Installation
 
+### One-liner
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/Olafs-World/openapi2cli/main/install.sh | bash
+```
+
+### Quick run (no install)
+
+```bash
+uvx openapi2cli generate https://petstore3.swagger.io/api/v3/openapi.json --name petstore
+```
+
+### Install as CLI tool
+
+```bash
+uv tool install openapi2cli
+openapi2cli generate https://httpbin.org/spec.json --name httpbin
+```
+
+### Add to a project
+
+```bash
+uv add openapi2cli
+```
+
+### Install as OpenClaw skill
+
+```bash
+clawhub install openapi2cli
+```
+
+Or with pip:
+
 ```bash
 pip install openapi2cli
 ```
@@ -231,13 +266,13 @@ git clone https://github.com/Olafs-World/openapi2cli.git
 cd openapi2cli
 
 # Install dev dependencies
-pip install -e ".[dev]"
+uv sync --extra dev
 
 # Run tests
-pytest tests/ -v
+uv run pytest tests/ -v
 
 # Run only unit tests (no API calls)
-pytest tests/ -v -m "not integration"
+uv run pytest tests/ -v -m "not integration"
 ```
 
 ## How It Works
@@ -256,6 +291,12 @@ The generated CLI uses `requests` for HTTP and optionally `rich` for pretty outp
 - Complex nested request bodies may need `--data` JSON flag
 - OAuth2 flows not fully implemented (use `--token` with pre-obtained tokens)
 
+## Links
+
+- [PyPI](https://pypi.org/project/openapi2cli/)
+- [GitHub](https://github.com/Olafs-World/openapi2cli)
+- [ClawHub Skill](https://clawhub.com/skills/openapi2cli)
+
 ## License
 
 MIT © [Olaf](https://olafs-world.vercel.app)

{openapi2cli-0.1.0 → openapi2cli-0.1.1}/README.md

@@ -1,3 +1,5 @@
+![openapi2cli banner](https://raw.githubusercontent.com/Olafs-World/openapi2cli/main/banner.png)
+
 # openapi2cli 🔧
 
 [![CI](https://github.com/Olafs-World/openapi2cli/actions/workflows/ci.yml/badge.svg)](https://github.com/Olafs-World/openapi2cli/actions/workflows/ci.yml)
@@ -29,6 +31,39 @@ AI agents are great at executing CLI commands. They're less great at crafting HT
 
 ## Installation
 
+### One-liner
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/Olafs-World/openapi2cli/main/install.sh | bash
+```
+
+### Quick run (no install)
+
+```bash
+uvx openapi2cli generate https://petstore3.swagger.io/api/v3/openapi.json --name petstore
+```
+
+### Install as CLI tool
+
+```bash
+uv tool install openapi2cli
+openapi2cli generate https://httpbin.org/spec.json --name httpbin
+```
+
+### Add to a project
+
+```bash
+uv add openapi2cli
+```
+
+### Install as OpenClaw skill
+
+```bash
+clawhub install openapi2cli
+```
+
+Or with pip:
+
 ```bash
 pip install openapi2cli
 ```
@@ -198,13 +233,13 @@ git clone https://github.com/Olafs-World/openapi2cli.git
 cd openapi2cli
 
 # Install dev dependencies
-pip install -e ".[dev]"
+uv sync --extra dev
 
 # Run tests
-pytest tests/ -v
+uv run pytest tests/ -v
 
 # Run only unit tests (no API calls)
-pytest tests/ -v -m "not integration"
+uv run pytest tests/ -v -m "not integration"
 ```
 
 ## How It Works
@@ -223,6 +258,12 @@ The generated CLI uses `requests` for HTTP and optionally `rich` for pretty outp
 - Complex nested request bodies may need `--data` JSON flag
 - OAuth2 flows not fully implemented (use `--token` with pre-obtained tokens)
 
+## Links
+
+- [PyPI](https://pypi.org/project/openapi2cli/)
+- [GitHub](https://github.com/Olafs-World/openapi2cli)
+- [ClawHub Skill](https://clawhub.com/skills/openapi2cli)
+
 ## License
 
 MIT © [Olaf](https://olafs-world.vercel.app)

openapi2cli-0.1.1/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: openapi2cli
+description: Generate CLI tools from OpenAPI specs. Use when you need to interact with any API that has an OpenAPI/Swagger spec - generates a ready-to-use CLI with commands, options, and authentication. Built for AI agents who need quick API access without writing HTTP requests.
+---
+
+# OpenAPI to CLI
+
+Generate CLI tools from OpenAPI 3.x specs. Point at any spec, get a working CLI.
+
+## Installation
+
+```bash
+uvx openapi2cli generate spec.yaml --name myapi  # one-off
+uv tool install openapi2cli                       # persistent
+```
+
+## Usage
+
+### Generate a CLI
+
+```bash
+# From URL
+openapi2cli generate https://petstore3.swagger.io/api/v3/openapi.json --name petstore
+
+# From local file
+openapi2cli generate ./api-spec.yaml --name myapi --output myapi_cli.py
+```
+
+### Use the generated CLI
+
+```bash
+# See available commands
+./petstore_cli.py --help
+
+# Commands are grouped by API tags
+./petstore_cli.py pet find-by-status --status available
+./petstore_cli.py store inventory
+
+# Authentication via env vars
+export PETSTORE_API_KEY=your-key
+./petstore_cli.py pet get --pet-id 123
+
+# JSON output for scripting
+./petstore_cli.py pet list --output json | jq '.[0].name'
+```
+
+### Inspect a spec
+
+```bash
+openapi2cli inspect https://api.example.com/openapi.json
+```
+
+Shows endpoints, parameters, and auth schemes without generating code.
+
+## Generated CLI Features
+
+- Commands grouped by API tags
+- Options for all parameters and request body fields
+- Auth support: API keys, Bearer tokens, env vars
+- Output formats: json, table, raw
+- Base URL override for staging/dev environments
+
+## Python API
+
+```python
+from openapi2cli import OpenAPIParser, CLIGenerator
+
+# Parse spec
+parser = OpenAPIParser()
+spec = parser.parse("https://api.example.com/openapi.json")
+
+# Generate CLI
+generator = CLIGenerator()
+cli = generator.generate(spec, name="example")
+cli.save("example_cli.py")
+```
+
+## Links
+
+- PyPI: https://pypi.org/project/openapi2cli/
+- GitHub: https://github.com/Olafs-World/openapi2cli

openapi2cli-0.1.1/install.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+set -e
+
+echo "🔧 Installing openapi2cli..."
+
+if command -v uv &>/dev/null; then
+  echo "Using uv..."
+  uv tool install openapi2cli
+elif command -v pipx &>/dev/null; then
+  echo "Using pipx..."
+  pipx install openapi2cli
+elif command -v pip3 &>/dev/null; then
+  echo "Using pip3..."
+  pip3 install --user openapi2cli
+elif command -v pip &>/dev/null; then
+  echo "Using pip..."
+  pip install --user openapi2cli
+else
+  echo "❌ No Python package manager found (uv, pipx, or pip)"
+  echo "Install uv: curl -LsSf https://astral.sh/uv/install.sh | sh"
+  exit 1
+fi
+
+echo ""
+echo "✅ openapi2cli installed!"
+echo ""
+echo "Try it:"
+echo "  openapi2cli generate https://httpbin.org/spec.json --name httpbin"

{openapi2cli-0.1.0 → openapi2cli-0.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "openapi2cli"
-version = "0.1.0"
+version = "0.1.1"
 description = "Generate CLI tools from OpenAPI specs — built for AI agents"
 readme = "README.md"
 license = {text = "MIT"}

{openapi2cli-0.1.0 → openapi2cli-0.1.1}/tests/test_e2e.py

@@ -1,4 +1,4 @@
-"""End-to-end tests for api2cli."""
+"""End-to-end tests for openapi2cli."""
 
 import subprocess
 import sys
@@ -10,13 +10,13 @@ FIXTURES = Path(__file__).parent / "fixtures"
 
 
 class TestCLIEndToEnd:
-    """End-to-end tests for the api2cli command."""
+    """End-to-end tests for the openapi2cli command."""
 
     def test_generate_from_file(self, tmp_path):
         """Can generate CLI from a local file."""
         result = subprocess.run(
             [
-                sys.executable, "-m", "api2cli",
+                sys.executable, "-m", "openapi2cli",
                 "generate",
                 str(FIXTURES / "petstore.yaml"),
                 "--name", "petstore",
@@ -33,7 +33,7 @@ class TestCLIEndToEnd:
         """Can generate CLI from a URL."""
         result = subprocess.run(
             [
-                sys.executable, "-m", "api2cli",
+                sys.executable, "-m", "openapi2cli",
                 "generate",
                 "https://httpbin.org/spec.json",
                 "--name", "httpbin",
@@ -51,7 +51,7 @@ class TestCLIEndToEnd:
         # Generate
         subprocess.run(
             [
-                sys.executable, "-m", "api2cli",
+                sys.executable, "-m", "openapi2cli",
                 "generate",
                 str(FIXTURES / "httpbin.json"),
                 "--name", "httpbin",
@@ -77,7 +77,7 @@ class TestCLIEndToEnd:
         # Generate
         subprocess.run(
             [
-                sys.executable, "-m", "api2cli",
+                sys.executable, "-m", "openapi2cli",
                 "generate",
                 str(FIXTURES / "httpbin.json"),
                 "--name", "httpbin",
@@ -104,9 +104,9 @@ class TestCLIEndToEnd:
             assert "url" in result.stdout.lower() or "httpbin" in result.stdout.lower()
 
     def test_help_command(self):
-        """api2cli --help works."""
+        """openapi2cli --help works."""
         result = subprocess.run(
-            [sys.executable, "-m", "api2cli", "--help"],
+            [sys.executable, "-m", "openapi2cli", "--help"],
             capture_output=True,
             text=True
         )
@@ -115,9 +115,9 @@ class TestCLIEndToEnd:
         assert "generate" in result.stdout.lower()
 
     def test_version_command(self):
-        """api2cli --version works."""
+        """openapi2cli --version works."""
         result = subprocess.run(
-            [sys.executable, "-m", "api2cli", "--version"],
+            [sys.executable, "-m", "openapi2cli", "--version"],
             capture_output=True,
             text=True
         )
@@ -134,7 +134,7 @@ class TestRealWorldSpecs:
         # Generate CLI
         gen_result = subprocess.run(
             [
-                sys.executable, "-m", "api2cli",
+                sys.executable, "-m", "openapi2cli",
                 "generate",
                 str(FIXTURES / "petstore.yaml"),
                 "--name", "petstore",
@@ -163,7 +163,7 @@ class TestRealWorldSpecs:
         # Generate
         subprocess.run(
             [
-                sys.executable, "-m", "api2cli",
+                sys.executable, "-m", "openapi2cli",
                 "generate",
                 "https://httpbin.org/spec.json",
                 "--name", "httpbin",

openapi2cli-0.1.0/.github/workflows/ci.yml

@@ -1,60 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        python-version: ["3.9", "3.10", "3.11", "3.12"]
-    
-    steps:
-      - uses: actions/checkout@v4
-      
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
-      
-      - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install -e ".[dev]"
-      
-      - name: Lint with ruff
-        run: ruff check api2cli/ tests/
-      
-      - name: Run unit tests
-        run: pytest tests/ -v -m "not integration" --tb=short
-      
-      - name: Run integration tests
-        run: pytest tests/ -v -m "integration" --tb=short
-
-  publish:
-    needs: test
-    runs-on: ubuntu-latest
-    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
-    
-    steps:
-      - uses: actions/checkout@v4
-      
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.11"
-      
-      - name: Build package
-        run: |
-          pip install build
-          python -m build
-      
-      - name: Publish to PyPI
-        uses: pypa/gh-action-pypi-publish@release/v1
-        with:
-          password: ${{ secrets.PYPI_API_TOKEN }}
-        continue-on-error: true