pyopenapi-gen 0.8.3__tar.gz → 0.8.6__tar.gz

{pyopenapi_gen-0.8.3 → pyopenapi_gen-0.8.6}/.github/BRANCH_PROTECTION.md

@@ -1,10 +1,18 @@
 # Branch Protection Configuration
 
-This document outlines the required GitHub branch protection settings for the `develop` branch.
+This document outlines the GitHub branch protection settings for the `develop`, `staging`, and `main` branches.
+
+## 🛡️ Branch Protection Status
+
+All three critical branches are now **FULLY PROTECTED** with the following settings:
+
+- **main**: ✅ Protected with full CI/CD enforcement
+- **staging**: ✅ Protected with full CI/CD enforcement  
+- **develop**: ✅ Protected with full CI/CD enforcement
 
 ## Required Settings
 
-### Branch Protection Rules for `develop`
+### Branch Protection Rules for `develop`, `staging`, and `main`
 
 1. **Require pull request reviews before merging**
    - Required approving reviews: 1
@@ -14,11 +22,11 @@ This document outlines the required GitHub branch protection settings for the `d
 2. **Require status checks to pass before merging**
    - Require branches to be up to date before merging: ✅
    - Required status checks:
-     - `quality-checks (3.10)`
-     - `quality-checks (3.11)` 
-     - `quality-checks (3.12)`
-     - `security-scan`
-     - `integration-tests`
+     - `format-check` (Black formatting)
+     - `lint` (Ruff linting)
+     - `typecheck` (MyPy type checking)
+     - `security` (Bandit security scanning)
+     - `test` (Full test suite with 85% coverage)
 
 3. **Require conversation resolution before merging**: ✅
 
@@ -34,6 +42,22 @@ This document outlines the required GitHub branch protection settings for the `d
 
 9. **Allow deletions**: ❌
 
+## 🔒 Protection Features
+
+### Deletion Protection
+All branches are protected from accidental deletion:
+- Force pushes are disabled
+- Branch deletion is explicitly forbidden
+- Admin privileges still enforce protection rules
+
+### Quality Gates
+Every PR must pass all quality checks:
+- Code formatting (Black)
+- Linting (Ruff) 
+- Type checking (MyPy strict mode)
+- Security scanning (Bandit)
+- Test suite with 85% coverage minimum
+
 ## How to Configure
 
 ### Via GitHub Web Interface
@@ -44,16 +68,34 @@ This document outlines the required GitHub branch protection settings for the `d
 4. Configure the settings as outlined above
 5. Save the branch protection rule
 
-### Via GitHub CLI (if available)
+### Via GitHub CLI
+
+The protection was applied using GitHub CLI. Here's how to configure each branch:
 
 ```bash
-# Example command (adjust as needed)
-gh api repos/:owner/:repo/branches/develop/protection \
-  --method PUT \
-  --field required_status_checks='{"strict":true,"contexts":["quality-checks (3.10)","quality-checks (3.11)","quality-checks (3.12)","security-scan","integration-tests"]}' \
-  --field enforce_admins=true \
-  --field required_pull_request_reviews='{"required_approving_review_count":1,"dismiss_stale_reviews":true}' \
-  --field restrictions=null
+# Create protection JSON
+cat > branch_protection.json << EOF
+{
+  "required_status_checks": {
+    "strict": true,
+    "contexts": ["format-check", "lint", "typecheck", "security", "test"]
+  },
+  "enforce_admins": true,
+  "required_pull_request_reviews": {
+    "required_approving_review_count": 1,
+    "dismiss_stale_reviews": true,
+    "require_code_owner_reviews": false
+  },
+  "restrictions": null,
+  "allow_deletions": false,
+  "allow_force_pushes": false
+}
+EOF
+
+# Apply to each branch
+gh api --method PUT repos/OWNER/REPO/branches/main/protection --input branch_protection.json
+gh api --method PUT repos/OWNER/REPO/branches/develop/protection --input branch_protection.json
+gh api --method PUT repos/OWNER/REPO/branches/staging/protection --input branch_protection.json
 ```
 
 ## Quality Gates Enforced

{pyopenapi_gen-0.8.3 → pyopenapi_gen-0.8.6}/.github/workflows/ci.yml

@@ -2,9 +2,9 @@ name: CI
 
 on:
   push:
-    branches: [main, develop]
+    branches: [main, develop, staging]
   pull_request:
-    branches: [main, develop]
+    branches: [main, develop, staging]
 
 jobs:
   test:
@@ -39,6 +39,4 @@ jobs:
           poetry run mypy src/
       - name: Run tests with coverage
         run: |
-          poetry run pytest --cov=src --cov-report=xml
-      - name: Generate HTML coverage report
-        run: poetry run pytest --cov=src --cov-report=html
+          poetry run pytest --cov=src --cov-report=xml --cov-report=html

pyopenapi_gen-0.8.6/.github/workflows/claude-review-trigger.yml

@@ -0,0 +1,68 @@
+name: Notify Claude for PR Review
+
+on:
+  pull_request:
+    types: [opened, synchronize, ready_for_review]
+
+jobs:
+  notify-claude:
+    runs-on: ubuntu-latest
+    if: github.event.pull_request.draft == false
+    
+    permissions:
+      contents: read
+      pull-requests: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          
+      - name: Check if PR needs Claude review
+        id: needs_review
+        run: |
+          pr_author="${{ github.event.pull_request.user.login }}"
+          pr_title="${{ github.event.pull_request.title }}"
+          pr_base="${{ github.event.pull_request.base.ref }}"
+          
+          echo "PR Author: $pr_author"
+          echo "PR Title: $pr_title"
+          echo "PR Base Branch: $pr_base"
+          
+          # PRs that should get Claude review:
+          # 1. ALL PRs targeting develop branch (main development branch)
+          # 2. Dependabot PRs (dependency updates)
+          # 3. Version bump PRs from devops-mindhive
+          # 4. Documentation PRs from devops-mindhive
+          # 5. PRs with [claude-review] tag
+          
+          needs_review=false
+          
+          if [[ "$pr_base" == "develop" ]] || \
+             [[ "$pr_author" == "dependabot[bot]" ]] || \
+             [[ "$pr_author" == "devops-mindhive" && "$pr_title" =~ ^(release|chore|docs): ]] || \
+             [[ "$pr_title" =~ \[claude-review\] ]]; then
+            needs_review=true
+          fi
+          
+          echo "needs_review=$needs_review" >> $GITHUB_OUTPUT
+          
+          if [[ "$needs_review" == "true" ]]; then
+            echo "✅ PR needs Claude review"
+          else
+            echo "❌ PR does not need automatic Claude review"
+          fi
+
+      - name: Request Claude review
+        if: steps.needs_review.outputs.needs_review == 'true'
+        run: |
+          gh pr comment ${{ github.event.pull_request.number }} --body "@claude Please review this PR for code quality, security, and compatibility. If you find any issues:
+          
+          1. **For fixable issues** (formatting, linting, small bugs): Please fix them directly by committing to this PR branch
+          2. **For larger issues**: Comment with specific feedback and create issues if needed
+          3. **If everything looks good**: Approve and merge the PR
+          
+          You have full access to modify code, run tests, and ensure the PR meets our quality standards."
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

{pyopenapi_gen-0.8.3 → pyopenapi_gen-0.8.6}/.github/workflows/claude.yml

@@ -9,6 +9,8 @@ on:
     types: [opened, assigned]
   pull_request_review:
     types: [submitted]
+  pull_request:
+    types: [opened, synchronize, ready_for_review]
 
 jobs:
   claude:
@@ -16,18 +18,24 @@ jobs:
       (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
       (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
       (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
-      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
+      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude'))) ||
+      (github.event_name == 'pull_request' && github.event.pull_request.draft == false)
     runs-on: ubuntu-latest
     permissions:
-      contents: read
-      pull-requests: read
-      issues: read
+      contents: write
+      pull-requests: write
+      issues: write
       id-token: write
+      actions: read
+      checks: read
+      statuses: read
+      repository-projects: read
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
         with:
-          fetch-depth: 1
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Run Claude Code
         id: claude

{pyopenapi_gen-0.8.3 → pyopenapi_gen-0.8.6}/.github/workflows/main-checks.yml

@@ -10,7 +10,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.10", "3.11", "3.12"]
+        python-version: ["3.12"]
     
     steps:
     - name: Checkout code
@@ -57,7 +57,6 @@ jobs:
 
     - name: Upload coverage artifacts
       uses: actions/upload-artifact@v4
-      if: matrix.python-version == '3.12'
       with:
         name: coverage-report
         path: htmlcov/

{pyopenapi_gen-0.8.3 → pyopenapi_gen-0.8.6}/.github/workflows/pr-checks.yml

@@ -2,7 +2,7 @@ name: Pull Request Checks
 
 on:
   pull_request:
-    branches: [develop]
+    branches: [develop, staging, main]
   workflow_dispatch:
 
 jobs:
@@ -10,7 +10,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.10", "3.11", "3.12"]
+        python-version: ["3.12"]
     
     steps:
     - name: Checkout code
@@ -59,7 +59,6 @@ jobs:
 
     - name: Upload coverage to Codecov
       uses: codecov/codecov-action@v4
-      if: matrix.python-version == '3.12'
       with:
         file: ./coverage.xml
         flags: unittests
@@ -131,7 +130,7 @@ jobs:
       run: |
         poetry run pyopenapi-gen --help
         # Test basic generation
-        poetry run pyopenapi-gen gen input/minimal_swagger.json --project-root ./test_output --output-package test_client --force --no-postprocess
+        poetry run pyopenapi-gen input/minimal_swagger.json --project-root ./test_output --output-package test_client --force --no-postprocess
 
     - name: Verify generated client structure
       run: |

{pyopenapi_gen-0.8.3 → pyopenapi_gen-0.8.6}/.github/workflows/production-release.yml

@@ -148,7 +148,7 @@ jobs:
           
           ## ✅ Compatibility
           
-          - Python 3.10, 3.11, 3.12
+          - Python 3.12+
           - Linux, macOS
           - Enterprise-ready with comprehensive error handling
         draft: false

{pyopenapi_gen-0.8.3 → pyopenapi_gen-0.8.6}/.github/workflows/testpypi-publish.yml

@@ -3,12 +3,11 @@ name: Publish to TestPyPI (pre-release)
 on:
   push:
     branches: [main]
-  pull_request:
-    branches: [main]
 
 jobs:
   build-and-testpypi:
     runs-on: ubuntu-latest
+    environment: staging
     steps:
       - uses: actions/checkout@v4
       - name: Set up Python

{pyopenapi_gen-0.8.3 → pyopenapi_gen-0.8.6}/.gitignore

@@ -37,20 +37,21 @@ pip-log.txt
 pip-delete-this-directory.txt
 
 # Unit test / coverage reports
-htmlcov/
 .tox/
 .nox/
 .coverage
 .coverage.*
 .cache
 nosetests.xml
-coverage.xml
 *.cover
 *.py,cover
 .hypothesis/
 .pytest_cache/
 cover/
 
+# Coverage reports folder
+coverage_reports/
+
 # Translations
 *.mo
 *.pot
@@ -184,4 +185,5 @@ output
 output_*
 **/.claude/settings.local.json
 out
-test_outputs
+test_outputs
+temp_test

pyopenapi_gen-0.8.6/CHANGELOG.md

@@ -0,0 +1,130 @@
+# Changelog
+
+All notable changes to PyOpenAPI Generator are 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).
+
+## [Unreleased]
+
+## [0.8.4] - 2024-11-06
+
+### Added
+- Claude GitHub App automation for PR reviews and fixes
+- Auto-review for all PRs targeting develop branch
+- Professional-grade documentation overhaul with comprehensive README.md
+- Detailed contributing guidelines in CONTRIBUTING.md
+- Formal changelog protocol following Keep a Changelog format
+- Documentation index in docs/README.md with navigation
+- Universal Why→What→How documentation structure standards
+
+### Changed
+- TestPyPI workflow now uses staging environment for proper secret access
+- Enhanced README.md with modern badges, better structure, and comprehensive examples
+- Improved project metadata and documentation standards in pyproject.toml
+- Updated architecture documentation to follow established standards
+- Optimized CI workflow to eliminate duplicate test execution
+
+### Fixed
+- Claude.yml workflow validation errors (removed invalid metadata permission)
+- TestPyPI publishing failures due to secret access issues
+
+### Removed
+- Unused Jinja2 dependency (project uses visitor pattern, not templates)
+- Feature status promises to avoid implementation commitments
+
+## [0.8.3] - 2024-11-06
+
+### Changed
+- Minor improvements and maintenance updates
+
+## [0.8.1] - 2024-11-06
+
+### Added
+- Enhanced schema handling capabilities
+- Minor improvements to code generation
+
+### Changed  
+- Improved schema processing logic
+
+## [0.8.0] - 2024-11-06
+
+### Added
+- ⭐ **NEW**: Unified type resolution system (`types/` package)
+  - Clean architecture with contracts, resolvers, and services
+  - Dependency injection with protocol-based design
+  - Comprehensive test coverage for type resolution
+- Enterprise-grade developer experience improvements
+- Unified architecture across all components
+
+### Changed
+- Major refactoring to use unified type resolution throughout codebase
+- Enhanced code generation reliability and consistency
+- Improved error handling and type safety
+
+### Fixed
+- All failing tests resolved with new architecture
+- mypy import errors resolved with proper httpx dependency
+
+### Technical Details
+- Implemented unified type resolution system for consistent type handling
+- Applied black formatting to all source files
+- Enhanced testing coverage and reliability
+
+## [0.7.x] - Previous Versions
+
+### Added
+- Core OpenAPI client generation functionality
+- Async-first Python client architecture
+- Advanced cycle detection for complex schemas
+- Pluggable authentication system
+- Smart pagination support
+- Response unwrapping capabilities
+- Tag-based operation organization
+- Comprehensive error handling
+- Self-contained client generation (zero runtime dependencies)
+
+### Features Established
+- Three-stage pipeline: Load → Visit → Emit
+- Intermediate Representation (IR) for stable code generation
+- Support for Python 3.10-3.12
+- Integration with modern Python tooling (Black, Ruff, mypy)
+- Comprehensive test suite with high coverage requirements
+
+---
+
+## Release Notes Format
+
+Each release includes:
+
+- **Added**: New features and capabilities
+- **Changed**: Modifications to existing functionality  
+- **Deprecated**: Features marked for future removal
+- **Removed**: Features that have been removed
+- **Fixed**: Bug fixes and issue resolutions
+- **Security**: Security vulnerability fixes
+
+## Version History Links
+
+- [Unreleased]: Compare against latest release
+- [0.8.3]: https://github.com/your-org/pyopenapi-gen/releases/tag/v0.8.3
+- [0.8.1]: https://github.com/your-org/pyopenapi-gen/releases/tag/v0.8.1  
+- [0.8.0]: https://github.com/your-org/pyopenapi-gen/releases/tag/v0.8.0
+
+## Contributing to the Changelog
+
+When contributing changes:
+
+1. Add entries to the `[Unreleased]` section
+2. Use the appropriate category (Added, Changed, Fixed, etc.)
+3. Write clear, descriptive entries
+4. Include issue/PR references when relevant
+5. Follow the established format and tone
+
+Example entry:
+```markdown
+### Added
+- OAuth2 authentication support with refresh token handling (#123)
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for complete guidelines.

{pyopenapi_gen-0.8.3 → pyopenapi_gen-0.8.6}/CLAUDE.md

@@ -1,6 +1,41 @@
 # CLAUDE.md
 
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+This file provides guidance to Claude Code (claude.ai/code) and the Claude GitHub App when working with code in this repository.
+
+## Claude GitHub App Capabilities
+
+The Claude GitHub App is configured with extensive permissions to independently operate on this repository:
+
+### Automated PR Review & Fixes
+- **Code Review**: Automatically triggered for dependabot PRs, version bumps, and documentation changes
+- **Issue Fixing**: Can directly commit fixes to PR branches for:
+  - Formatting issues (Black, Ruff)
+  - Linting violations
+  - Type checking errors
+  - Security issues
+  - Small bugs and improvements
+- **Quality Assurance**: Runs `make quality` and `make test` to ensure all changes meet standards
+- **Merge Decisions**: Approves and merges PRs when all criteria are met
+
+### Repository Management
+- **Issue Creation**: Creates detailed issues for complex problems that need human attention
+- **Branch Management**: Can work on feature branches and create new branches as needed
+- **Release Management**: Assists with version bumps and changelog updates
+- **Documentation**: Updates documentation to reflect code changes
+
+### Permissions
+The Claude GitHub App has the following permissions:
+- `contents: write` - Modify files and commit changes
+- `pull-requests: write` - Review, approve, and merge PRs
+- `issues: write` - Create and manage issues
+- `actions: read` - Monitor CI/CD status
+- `checks: read` - Review test results
+- `statuses: read` - Check status checks
+
+### Triggering Claude Reviews
+1. **Automatic**: PRs from dependabot, devops-mindhive (docs/release), or with `[claude-review]` tag
+2. **Manual**: Comment `@claude` on any PR, issue, or review to request assistance
+3. **On PR Events**: New PRs automatically get Claude attention for quality review
 
 # PyOpenAPI Generator
 
@@ -391,7 +426,7 @@ Located in `core/parsing/unified_cycle_detection.py` with:
 - **Formatting**: Black (120 char line length)
 - **Linting**: Ruff for code quality and import sorting
 - **Type Safety**: mypy strict mode with 100% coverage
-- **Compatibility**: Python 3.10-3.12
+- **Compatibility**: Python 3.12+
 
 ### Testing Requirements
 Follow cursor rules strictly: