capiscio 2.1.3__tar.gz → 2.2.0__tar.gz

capiscio-2.2.0/.github/workflows/e2e.yml

@@ -0,0 +1,47 @@
+name: E2E Tests
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  e2e-tests:
+    name: E2E Tests (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["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,test]"
+      
+      - name: Run unit tests
+        run: |
+          pytest tests/unit/ -v --cov=capiscio --cov-report=xml --cov-report=term
+      
+      - name: Run E2E tests
+        run: |
+          pytest tests/e2e/ -v --tb=short
+      
+      - name: Upload coverage reports
+        if: matrix.python-version == '3.11'
+        uses: codecov/codecov-action@v4
+        with:
+          file: ./coverage.xml
+          flags: unittests
+          name: codecov-umbrella
+          fail_ci_if_error: false

capiscio-2.2.0/.github/workflows/test.yml

@@ -0,0 +1,43 @@
+name: Unit Tests
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  test:
+    name: Unit Tests (Python ${{ matrix.python-version }})
+    runs-on: ${{ matrix.os }}
+    
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["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,test]"
+      
+      - name: Run unit tests
+        run: |
+          pytest tests/unit/ -v --cov=capiscio --cov-report=xml --cov-report=term
+      
+      - name: Upload coverage
+        if: matrix.python-version == '3.11' && matrix.os == 'ubuntu-latest'
+        uses: codecov/codecov-action@v4
+        with:
+          file: ./coverage.xml
+          flags: unittests
+          name: codecov-umbrella

capiscio-2.2.0/CHANGELOG.md

@@ -0,0 +1,34 @@
+# 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.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [2.2.0] - 2025-12-10
+
+### Changed
+- **VERSION ALIGNMENT**: All CapiscIO packages now share the same version number.
+  - `capiscio-core`, `capiscio` (npm), and `capiscio` (PyPI) are all v2.2.0.
+  - Simplifies compatibility - no version matrix needed.
+- **CORE VERSION**: Now downloads `capiscio-core` v2.2.0.
+
+### Added
+- **Test Suite**: Added comprehensive test coverage (96%) for CLI wrapper and binary manager.
+
+## [2.1.3] - 2025-11-21
+
+### Fixed
+- **Core Version Sync**: Fixed an issue where the wrapper attempted to download a non-existent `v2.1.2` of `capiscio-core`. It now correctly downloads `v1.0.2`.
+- **Package Versioning**: Bumped package version to `2.1.3` to resolve PyPI conflicts while pointing to the stable `v1.0.2` core binary.
+
+## [2.1.2] - 2025-11-21
+
+### Added
+- **CLI Wrapper**: Initial release of the new Python CLI wrapper.
+- **Architecture**: Replaced the legacy Python library with a lightweight wrapper that downloads and executes the high-performance Go binary (`capiscio-core`).
+- **Platform Support**: Automatic detection and download for Linux, macOS, and Windows (AMD64/ARM64).
+- **Zero Dependencies**: The wrapper itself has minimal dependencies (`rich`, `platformdirs`, `requests`) and delegates all logic to the standalone binary.
+
+### Removed
+- **Legacy Library**: Removed the old Python implementation of the validation logic in favor of the unified Go core.

{capiscio-2.1.3 → capiscio-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: capiscio
-Version: 2.1.3
+Version: 2.2.0
 Summary: The official CapiscIO CLI tool for validating A2A agents.
 Project-URL: Homepage, https://capisc.io
 Project-URL: Documentation, https://docs.capisc.io/cli
@@ -27,6 +27,10 @@ Provides-Extra: dev
 Requires-Dist: build; extra == 'dev'
 Requires-Dist: pytest>=7.0.0; extra == 'dev'
 Requires-Dist: twine; extra == 'dev'
+Provides-Extra: test
+Requires-Dist: pytest-cov>=4.0.0; extra == 'test'
+Requires-Dist: pytest>=7.0.0; extra == 'test'
+Requires-Dist: requests>=2.31.0; extra == 'test'
 Description-Content-Type: text/markdown
 
 # CapiscIO CLI (Python)
@@ -58,8 +62,8 @@ Once installed, the `capiscio` command is available in your terminal. It passes
 # Validate an agent
 capiscio validate https://my-agent.example.com
 
-# Check compliance score
-capiscio score https://my-agent.example.com
+# Validate with JSON output
+capiscio validate https://my-agent.example.com --json
 
 # Check version
 capiscio --version

{capiscio-2.1.3 → capiscio-2.2.0}/README.md

@@ -27,8 +27,8 @@ Once installed, the `capiscio` command is available in your terminal. It passes
 # Validate an agent
 capiscio validate https://my-agent.example.com
 
-# Check compliance score
-capiscio score https://my-agent.example.com
+# Validate with JSON output
+capiscio validate https://my-agent.example.com --json
 
 # Check version
 capiscio --version

capiscio-2.2.0/docs/getting-started/installation.md

@@ -0,0 +1,36 @@
+# CapiscIO Python CLI
+
+The **CapiscIO Python CLI** is a lightweight wrapper that automatically downloads and executes the high-performance [CapiscIO Core](https://github.com/capiscio/capiscio-core) binary.
+
+It provides a seamless experience for Python developers, allowing you to install the CLI via `pip` without worrying about platform-specific binaries.
+
+## Installation
+
+```bash
+pip install capiscio
+```
+
+## Usage
+
+Once installed, the `capiscio` command is available in your terminal. It passes all arguments directly to the underlying Core binary.
+
+```bash
+# Validate an agent card
+capiscio validate ./agent-card.json
+
+# Check version
+capiscio --version
+```
+
+For full command reference, see the [CapiscIO Core Documentation](../../capiscio-core/index.md).
+
+## How it Works
+
+1.  **Detection**: When you run `capiscio`, the wrapper detects your Operating System (Linux, macOS, Windows) and Architecture (AMD64, ARM64).
+2.  **Download**: It checks if the correct `capiscio-core` binary is present in your user cache directory. If not, it downloads it securely from GitHub Releases.
+3.  **Execution**: It executes the binary with your provided arguments, piping input and output directly to your terminal.
+
+## Requirements
+
+*   Python 3.10+
+*   Internet connection (for initial binary download)

capiscio-2.2.0/docs/index.md

@@ -0,0 +1,55 @@
+---
+title: CapiscIO Python CLI - Documentation
+description: Official documentation for the CapiscIO Python CLI wrapper.
+---
+
+# CapiscIO Python CLI
+
+The **CapiscIO Python CLI** is a lightweight wrapper around the [CapiscIO Core](https://github.com/capiscio/capiscio-core) binary, designed for seamless integration into Python environments.
+
+!!! info "This is a Wrapper Package"
+    This package does NOT contain validation logic. It downloads and executes the `capiscio-core` Go binary, which performs the actual validation.
+
+<div class="grid cards" markdown>
+
+-   **🚀 Getting Started**
+
+    ---
+
+    Install the CLI via pip.
+
+    [:octicons-arrow-right-24: Installation](./getting-started/installation.md)
+
+-   **⚙️ Reference**
+
+    ---
+
+    Wrapper commands and usage.
+
+    [:octicons-arrow-right-24: Commands](./reference/commands.md)
+
+</div>
+
+## Quick Start
+
+```bash
+# Install
+pip install capiscio
+
+# Validate an agent card
+capiscio validate ./agent-card.json
+
+# Validate with JSON output
+capiscio validate ./agent-card.json --json
+
+# Check core binary version
+capiscio --version
+```
+
+## What This Package Does
+
+1. **Downloads** the correct `capiscio-core` binary for your platform (macOS/Linux/Windows, AMD64/ARM64)
+2. **Caches** the binary in your user cache directory
+3. **Executes** the binary with your arguments, using `os.execv()` for zero overhead
+
+All validation logic lives in `capiscio-core`. This wrapper just makes it easy to install via pip.

capiscio-2.2.0/docs/reference/commands.md

@@ -0,0 +1,46 @@
+# Wrapper-Specific Commands
+
+While most commands are handled by the Core binary, the Python wrapper includes a few utility commands for managing the wrapper itself.
+
+## `capiscio --wrapper-version`
+
+Displays the version of the Python wrapper package itself, distinct from the Core binary version.
+
+```bash
+$ capiscio --wrapper-version
+capiscio-python wrapper v2.1.3
+```
+
+## `capiscio --wrapper-clean`
+
+Removes the cached `capiscio-core` binary. This is useful if the binary becomes corrupted or if you want to force a re-download.
+
+```bash
+$ capiscio --wrapper-clean
+Cleaned cache directory: /Users/username/Library/Caches/capiscio/bin
+```
+
+---
+
+## Core Commands
+
+All other commands are passed directly to the `capiscio-core` binary. See the [CLI Reference](https://docs.capisc.io/reference/cli/) for full documentation.
+
+### Common Commands
+
+```bash
+# Validate an agent card
+capiscio validate ./agent-card.json
+
+# Validate with JSON output
+capiscio validate ./agent-card.json --json
+
+# Validate with live endpoint testing
+capiscio validate https://agent.example.com --test-live
+
+# Check version of the core binary
+capiscio --version
+
+# Generate a signing key pair
+capiscio key gen --out-priv ./private.jwk --out-pub ./public.jwk
+```

capiscio-2.2.0/mkdocs.yml

@@ -0,0 +1,90 @@
+# CapiscIO Python CLI Wrapper
+
+site_name: CapiscIO Python CLI
+site_url: https://docs.capisc.io/capiscio-python
+site_description: The official Python wrapper for the CapiscIO Core CLI.
+site_author: CapiscIO Team
+copyright: Copyright © 2025 CapiscIO
+
+repo_name: capiscio/capiscio-python
+repo_url: https://github.com/capiscio/capiscio-python
+edit_uri: edit/main/docs/
+
+theme:
+  name: material
+  logo: https://docs.capisc.io/assets/logo.png
+  favicon: https://docs.capisc.io/assets/favicon.ico
+  palette:
+    - scheme: slate
+      primary: blue grey
+      accent: cyan
+      toggle:
+        icon: material/brightness-4
+        name: Switch to light mode
+    - scheme: default
+      primary: blue grey
+      accent: cyan
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+  
+  font:
+    text: Roboto
+    code: Roboto Mono
+  
+  features:
+    - navigation.instant
+    - navigation.tracking
+    - navigation.tabs
+    - navigation.sections
+    - navigation.expand
+    - navigation.top
+    - navigation.footer
+    - toc.follow
+    - search.suggest
+    - search.highlight
+    - content.code.copy
+    - content.tabs.link
+
+plugins:
+  - search:
+      lang: en
+
+markdown_extensions:
+  - abbr
+  - admonition
+  - attr_list
+  - def_list
+  - footnotes
+  - md_in_html
+  - tables
+  - toc:
+      permalink: true
+  - pymdownx.details
+  - pymdownx.highlight:
+      anchor_linenums: true
+  - pymdownx.inlinehilite
+  - pymdownx.superfences:
+      custom_fences:
+        - name: mermaid
+          class: mermaid
+          format: !!python/name:pymdownx.superfences.fence_code_format
+  - pymdownx.tabbed:
+      alternate_style: true
+  - pymdownx.tasklist:
+      custom_checkbox: true
+
+extra:
+  homepage: https://docs.capisc.io
+  social:
+    - icon: fontawesome/brands/github
+      link: https://github.com/capiscio
+    - icon: fontawesome/brands/twitter
+      link: https://twitter.com/capiscio
+
+nav:
+  - Home: index.md
+  - Getting Started:
+      - Installation: getting-started/installation.md
+  - Reference:
+      - Commands: reference/commands.md

{capiscio-2.1.3 → capiscio-2.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "capiscio"
-version = "2.1.3"
+version = "2.2.0"
 description = "The official CapiscIO CLI tool for validating A2A agents."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -36,6 +36,11 @@ dev = [
     "build",
     "twine",
 ]
+test = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+    "requests>=2.31.0",
+]
 
 [project.scripts]
 capiscio = "capiscio.cli:main"

capiscio-2.2.0/pytest.ini

@@ -0,0 +1,12 @@
+[pytest]
+testpaths = tests
+python_files = test_*.py
+python_classes = Test*
+python_functions = test_*
+addopts = -v --strict-markers
+markers =
+    e2e: marks tests as end-to-end tests requiring a live server
+    unit: marks tests as unit tests (no external dependencies)
+
+filterwarnings =
+    ignore::DeprecationWarning

{capiscio-2.1.3 → capiscio-2.2.0}/src/capiscio/__init__.py

@@ -1,3 +1,3 @@
 """CapiscIO CLI package."""
 
-__version__ = "0.1.0"
+__version__ = "2.2.0"

{capiscio-2.1.3 → capiscio-2.2.0}/src/capiscio/manager.py

@@ -17,7 +17,7 @@ console = Console()
 logger = logging.getLogger(__name__)
 
 # Configuration
-CORE_VERSION = "1.0.2"  # The version of the core binary to download
+CORE_VERSION = "2.2.0"  # The version of the core binary to download
 GITHUB_REPO = "capiscio/capiscio-core"
 BINARY_NAME = "capiscio"
 

capiscio-2.2.0/tests/README.md

@@ -0,0 +1,98 @@
+# Tests for capiscio-python CLI
+
+This directory contains unit and E2E tests for the `capiscio` CLI wrapper.
+
+## Directory Structure
+
+```
+tests/
+├── unit/              # Unit tests with mocks (no server required)
+│   ├── test_cli.py
+│   └── test_manager.py
+└── e2e/               # E2E tests (offline mode, no server required)
+    ├── conftest.py    # Pytest fixtures and configuration
+    ├── fixtures/      # Test data files
+    │   ├── valid-agent-card.json
+    │   ├── invalid-agent-card.json
+    │   └── malformed.txt
+    ├── test_validate_e2e.py  # Validation command tests
+    └── test_badge_e2e.py     # Badge issuance/verification tests
+```
+
+## Running Tests
+
+### Run All Tests
+
+```bash
+pytest               # All tests
+pytest tests/unit/   # Unit tests only
+pytest tests/e2e/    # E2E tests only
+```
+
+### Run Specific Test File
+
+```bash
+pytest tests/e2scio --cov-report=html
+```
+
+## E2E Test Design
+
+The E2E tests are designed to run **offline** without requiring a server:
+
+- **Validate tests**: Use `--schema-only` flag for local schema validation
+- **Badge tests**: Use `--self-sign` for issuance and `--accept-self-signed --offline` for verification
+
+This approach allows E2E tests to run in CI without complex server infrastructure.
+
+## Test Coverage
+
+### Validate Command (`test_validate_e2e.py`)
+
+- ✅ Valid local agent card file (schema-only mode)
+- ✅ Invalid local agent card file
+- ✅ Malformed JSON file
+- ✅ Nonexistent file
+- ✅ JSON output format
+- ✅ Help command
+
+###     ├── test_validate_e2e.sue self-signed badge
+- ✅ Issue badge with custom expiration
+- ✅ Issue badge with audience restriction
+- ✅ Verify self-signed badge (offline)
+- ✅ Verify invalid token (error handling)
+- ✅ Help commands (badge, issue, verify)
+
+## CI/CD Integration
+
+The E2E tests run in GitHub Actions without server dependencies:
+
+```yaml
+# See .github/workflows/e2e.yml
+- name: Run E2E tests
+  run: pytest tests/e2e/
+```
+
+## Notes
+
+- **Offline Mode**: All E2E tests run offline without server dependencies
+- **Download Messages**: On first run, the CLI may download the capiscio-core binary; tests handle this gracefully
+
+## Troubleshooting
+
+### Build/Install Issues
+
+Ensure the project is installed:
+
+```bash
+pip install -e .
+pytest tests/e2e/
+```
+
+### Path Issues
+
+Ensure you're running pytest from the project root:
+
+```bash
+cd /path/to/capiscio-python
+pytest tests/e2e/
+```

capiscio-2.2.0/tests/conftest.py

@@ -0,0 +1,7 @@
+"""Pytest configuration for capiscio-python tests."""
+import sys
+from pathlib import Path
+
+# Add src directory to path so tests can import capiscio
+src_path = Path(__file__).parent.parent / "src"
+sys.path.insert(0, str(src_path))

capiscio-2.2.0/tests/e2e/conftest.py

@@ -0,0 +1,41 @@
+"""
+pytest configuration for capiscio-python CLI E2E tests.
+
+Provides fixtures for testing the CLI offline using:
+- validate --schema-only
+- badge issue --self-sign
+- badge verify --accept-self-signed --offline
+"""
+
+import pytest
+from pathlib import Path
+
+
+@pytest.fixture(scope="session")
+def fixtures_dir() -> Path:
+    """Get path to fixtures directory."""
+    return Path(__file__).parent / "fixtures"
+
+
+@pytest.fixture
+def valid_agent_card_path(fixtures_dir: Path) -> Path:
+    """Path to valid agent card fixture."""
+    return fixtures_dir / "valid-agent-card.json"
+
+
+@pytest.fixture
+def invalid_agent_card_path(fixtures_dir: Path) -> Path:
+    """Path to invalid agent card fixture."""
+    return fixtures_dir / "invalid-agent-card.json"
+
+
+@pytest.fixture
+def malformed_json_path(fixtures_dir: Path) -> Path:
+    """Path to malformed JSON fixture."""
+    return fixtures_dir / "malformed.txt"
+
+
+@pytest.fixture
+def nonexistent_path(fixtures_dir: Path) -> Path:
+    """Path to a file that doesn't exist."""
+    return fixtures_dir / "does-not-exist.json"

capiscio-2.2.0/tests/e2e/fixtures/invalid-agent-card.json

@@ -0,0 +1,9 @@
+{
+  "version": "1.0",
+  "did": "invalid-did-format",
+  "name": "Invalid Agent",
+  "publicKey": {
+    "kty": "WRONG",
+    "x": "invalid-key-data"
+  }
+}

capiscio-2.2.0/tests/e2e/fixtures/malformed.txt

@@ -0,0 +1,4 @@
+{
+  "version": "1.0",
+  "did": "did:web:example.com"
+  "missing": "comma above"

capiscio-2.2.0/tests/e2e/fixtures/valid-agent-card.json

@@ -0,0 +1,26 @@
+{
+  "protocolVersion": "1.3.0",
+  "version": "1.0.0",
+  "name": "Test Agent",
+  "description": "A test agent for E2E validation tests",
+  "url": "https://example.com/.well-known/agent.json",
+  "capabilities": {
+    "streaming": false,
+    "pushNotifications": false
+  },
+  "skills": [
+    {
+      "id": "test-skill",
+      "name": "Test Skill",
+      "description": "A skill for testing",
+      "tags": ["test", "validation"]
+    }
+  ],
+  "provider": {
+    "organization": "Test Organization",
+    "url": "https://example.com"
+  },
+  "authentication": {
+    "schemes": ["none"]
+  }
+}