pico-fastapi 0.2.3.dev0__tar.gz → 0.3.1__tar.gz

pico_fastapi-0.3.1/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,32 @@
+name: Bug Report
+description: Report a bug in pico-fastapi
+labels: ["bug"]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: What happened?
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps to Reproduce
+      description: Minimal code or steps to reproduce the issue.
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: pico-fastapi version
+      placeholder: "0.2.2"
+    validations:
+      required: true
+  - type: input
+    id: python-version
+    attributes:
+      label: Python version
+      placeholder: "3.11"
+    validations:
+      required: true

pico_fastapi-0.3.1/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,18 @@
+name: Feature Request
+description: Suggest an enhancement for pico-fastapi
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What problem does this solve?
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: How should it work?
+    validations:
+      required: true

pico_fastapi-0.3.1/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,10 @@
+## Summary
+
+<!-- Brief description of the changes -->
+
+## Checklist
+
+- [ ] Tests pass (`pytest tests/ -v`)
+- [ ] Code formatted (`ruff format src/ tests/`)
+- [ ] Lint clean (`ruff check src/ tests/`)
+- [ ] CHANGELOG.md updated (if user-facing change)

pico_fastapi-0.3.1/.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"

pico_fastapi-0.3.1/.github/workflows/ci.yml

@@ -0,0 +1,90 @@
+name: CI
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+      - run: pip install ruff
+      - run: ruff check src/ tests/
+      - run: ruff format --check src/ tests/
+
+  tests:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install tox
+      - name: Run tests with coverage
+        env:
+          SETUPTOOLS_SCM_PRETEND_VERSION: "0.1.0"
+        run: |
+          tox -e cov
+          mv .coverage .coverage.${{ matrix.python-version }}
+      - uses: actions/upload-artifact@v7
+        with:
+          name: coverage-${{ matrix.python-version }}
+          path: .coverage.${{ matrix.python-version }}
+          include-hidden-files: true
+          if-no-files-found: error
+
+  coverage:
+    needs: tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+      - uses: actions/download-artifact@v8
+        with:
+          path: coverage-reports
+      - name: Combine and upload
+        run: |
+          pip install coverage
+          files=$(find coverage-reports -type f -name ".coverage.*")
+          if [ -z "$files" ]; then echo "No coverage files"; exit 1; fi
+          coverage combine $files
+          coverage xml
+      - uses: codecov/codecov-action@v7
+        continue-on-error: true
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: coverage.xml
+          fail_ci_if_error: false
+
+  sonar:
+    if: github.event_name == 'push'
+    needs: tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+      - uses: SonarSource/sonarqube-scan-action@v6
+        env:
+          SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
+        with:
+          args: >
+            -Dsonar.host.url=https://sonarcloud.io
+            -Dsonar.organization=dperezcabrera
+            -Dsonar.projectKey=dperezcabrera_${{ github.event.repository.name }}
+            -Dsonar.projectName=${{ github.event.repository.name }}
+            -Dsonar.sources=src
+            -Dsonar.tests=tests
+            -Dsonar.python.version=3.11,3.12,3.13,3.14

pico_fastapi-0.3.1/.github/workflows/codeql.yml

@@ -0,0 +1,21 @@
+name: CodeQL
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  schedule:
+    - cron: "0 6 * * 1"
+
+permissions:
+  security-events: write
+  contents: read
+
+jobs:
+  analyze:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: github/codeql-action/init@v4
+        with: { languages: python }
+      - uses: github/codeql-action/analyze@v4

pico_fastapi-0.3.1/.github/workflows/docs.yml

@@ -0,0 +1,48 @@
+name: Docs
+on:
+  push:
+    branches: [main]
+    paths: [docs/**, mkdocs.yml]
+  pull_request:
+    branches: [main]
+    paths: [docs/**, mkdocs.yml]
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  validate:
+    if: github.event_name == 'pull_request'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+        with: { fetch-depth: 0 }
+      - uses: actions/setup-python@v6
+        with: { python-version: "3.12" }
+      - run: pip install -r docs/requirements.txt
+      - run: mkdocs build --strict
+
+  deploy:
+    if: github.event_name != 'pull_request'
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - uses: actions/checkout@v7
+        with: { fetch-depth: 0 }
+      - uses: actions/setup-python@v6
+        with: { python-version: "3.12" }
+      - run: pip install -r docs/requirements.txt
+      - run: mkdocs build --strict --verbose
+      - uses: actions/upload-pages-artifact@v5
+        with: { path: site }
+      - id: deployment
+        uses: actions/deploy-pages@v5

pico_fastapi-0.3.1/.github/workflows/publish-to-pypi.yml

@@ -0,0 +1,24 @@
+name: Publish to PyPI
+on:
+  release:
+    types: [published]
+
+permissions:
+  id-token: write
+  contents: read
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+        with: { fetch-depth: 0 }
+      - uses: actions/setup-python@v6
+        with: { python-version: "3.x" }
+      - run: pip install build
+      - run: python -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true
+          verify-metadata: true
+          attestations: true

pico_fastapi-0.3.1/.sonarcloud.properties

@@ -0,0 +1,3 @@
+sonar.python.version=3.11,3.12,3.13,3.14
+sonar.sources=src
+sonar.tests=tests

{pico_fastapi-0.2.3.dev0 → pico_fastapi-0.3.1}/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.h
 
 ---
 
+## v0.3.0 — Breaking: Configurer Rename (2026-02-20)
+
+### Changed
+- **Breaking:** Renamed `FastApiConfigurer.configure(app)` to `configure_app(app)` to avoid protocol collision with `DatabaseConfigurer.configure(engine)` in structural typing.
+
+---
+
 ## v0.2.2 — Internal Quality (2026-02-06)
 
 ### Changed
@@ -34,17 +41,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.h
 ### Changed
 - Bumped `pico-ioc` dependency from `>= 2.1.3` to `>= 2.2.0`.
 - Dropped Python 3.10 from CI matrix, tox and Makefile (requires-python is `>=3.11`).
-- Changed `version_scheme` from `post-release` to `guess-next-dev` for clean release versions.
+- Reverted `version_scheme` to `post-release` (`guess-next-dev` caused `.dev0` versions to leak to PyPI).
 
 ---
 
 ## v0.2.0 — Ecosystem Integration (2025-11-25)
 
-### 🔌 New
+### New
 - Added native `pico-boot` auto-discovery using the `pico_boot.modules` entry point.
 - `pico-fastapi` is now automatically detected and loaded when initializing applications with `pico-boot`.
 
-### 🧱 No Behavioral Changes
+### No Behavioral Changes
 - No updates to middleware behavior.
 - No DI or request lifecycle changes.
 - No breaking changes.

{pico_fastapi-0.2.3.dev0 → pico_fastapi-0.3.1}/CLAUDE.md

@@ -11,7 +11,7 @@ pico-fastapi provides FastAPI integration for pico-ioc. It uses:
 ## Key Reminders
 
 - pico-ioc dependency: `>= 2.2.0`
-- `version_scheme = "guess-next-dev"` (clean versions on tag)
+- **NEVER change `version_scheme`** in pyproject.toml. It MUST remain `"post-release"`. Changing it to `"guess-next-dev"` causes `.dev0` versions to leak to PyPI. This was already fixed once — do not revert it.
 - requires-python >= 3.11
 - Commit messages: one line only
 - CI badge must point to `pico-fastapi` repo (not pico-ioc)

pico_fastapi-0.3.1/CODE_OF_CONDUCT.md

@@ -0,0 +1,31 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+
+Examples of unacceptable behavior:
+
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information without explicit permission
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to **dperezcabrera@gmail.com**. All complaints will be reviewed
+and investigated promptly and fairly.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org/), version 2.1.

pico_fastapi-0.3.1/CONTRIBUTING.md

@@ -0,0 +1,34 @@
+# Contributing to Pico-FastAPI
+
+## Development Setup
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[test]"
+pip install ruff
+```
+
+## Running Tests
+
+```bash
+pytest tests/ -v                # Run tests
+tox                             # Full matrix (3.11-3.14)
+```
+
+## Code Style
+
+- Python 3.11+
+- Format with `ruff format src/ tests/`
+- Lint with `ruff check src/ tests/`
+
+## Pull Requests
+
+1. Fork the repository
+2. Create a feature branch
+3. Ensure tests pass and code is formatted
+4. Submit a PR with a clear description
+
+## Reporting Issues
+
+Use [GitHub Issues](https://github.com/dperezcabrera/pico-fastapi/issues) for bugs and feature requests.

{pico_fastapi-0.2.3.dev0 → pico_fastapi-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pico-fastapi
-Version: 0.2.3.dev0
+Version: 0.3.1
 Summary: Pico-ioc integration for FastAPI. Adds Spring Boot-style controllers, autoconfiguration, and scopes (request, websocket, session).
 Author-email: David Perez Cabrera <dperezcabrera@gmail.com>
 License: MIT License
@@ -28,6 +28,8 @@ License: MIT License
 Project-URL: Homepage, https://github.com/dperezcabrera/pico-fastapi
 Project-URL: Repository, https://github.com/dperezcabrera/pico-fastapi
 Project-URL: Issue Tracker, https://github.com/dperezcabrera/pico-fastapi/issues
+Project-URL: Documentation, https://dperezcabrera.github.io/pico-fastapi/
+Project-URL: Changelog, https://github.com/dperezcabrera/pico-fastapi/blob/main/CHANGELOG.md
 Keywords: ioc,di,dependency injection,fastapi,inversion of control,spring boot,controller
 Classifier: Development Status :: 4 - Beta
 Classifier: Framework :: FastAPI
@@ -38,8 +40,10 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
+Classifier: Typing :: Typed
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
@@ -51,7 +55,7 @@ Provides-Extra: run
 Requires-Dist: uvicorn[standard]; extra == "run"
 Dynamic: license-file
 
-# 📦 pico-fastapi
+# pico-fastapi
 
 [![PyPI](https://img.shields.io/pypi/v/pico-fastapi.svg)](https://pypi.org/project/pico-fastapi/)
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/dperezcabrera/pico-fastapi)
@@ -62,6 +66,7 @@ Dynamic: license-file
 [![Duplicated Lines (%)](https://sonarcloud.io/api/project_badges/measure?project=dperezcabrera_pico-fastapi&metric=duplicated_lines_density)](https://sonarcloud.io/summary/new_code?id=dperezcabrera_pico-fastapi)
 [![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=dperezcabrera_pico-fastapi&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=dperezcabrera_pico-fastapi)
 [![Docs](https://img.shields.io/badge/Docs-pico--fastapi-blue?style=flat&logo=readthedocs&logoColor=white)](https://dperezcabrera.github.io/pico-fastapi/)
+[![Interactive Lab](https://img.shields.io/badge/Learn-online-green?style=flat&logo=python&logoColor=white)](https://dperezcabrera.github.io/pico-learn/)
 
 # Pico-FastAPI
 
@@ -69,17 +74,17 @@ Dynamic: license-file
 
 It provides scoped lifecycles, automatic controller registration, and clean architectural boundaries, without global state and without FastAPI’s function-based dependency system.
 
-> 🐍 Requires Python 3.11+
-> ⚡ Built on FastAPI  
-> ✅ Fully async-compatible  
-> ✅ Real IoC with constructor injection  
-> ✅ Supports singleton, request, session, and websocket scopes
+> Requires Python 3.11+
+> Built on FastAPI
+> Fully async-compatible
+> Real IoC with constructor injection
+> Supports singleton, request, session, and websocket scopes
 
 With Pico-FastAPI you get the speed, clarity, and async performance of FastAPI, enhanced by a real IoC container for clean, testable, and maintainable applications.
 
 ---
 
-## 🎯 Why pico-fastapi
+## Why pico-fastapi
 
 FastAPI’s built-in dependency system is function-based, which often ties business logic to the framework. Pico-FastAPI moves dependency resolution into the IoC container, promoting separation of concerns and testability.
 
@@ -92,7 +97,7 @@ FastAPI’s built-in dependency system is function-based, which often ties busin
 
 ---
 
-## 🧱 Core Features
+## Core Features
 
 - Controller classes with `@controller`
 - Route decorators: `@get`, `@post`, `@put`, `@delete`, `@patch`, `@websocket`
@@ -103,15 +108,15 @@ FastAPI’s built-in dependency system is function-based, which often ties busin
 
 ---
 
-## 📦 Installation
+## Installation
 
 ```bash
 pip install pico-fastapi
-````
+```
 
 ---
 
-## 🚀 Quick Example
+## Quick Example
 
 ```python
 from pico_fastapi import controller, get
@@ -151,7 +156,7 @@ app = container.get(FastAPI)
 ```
 ---
 
-# 🚀 Quick Example (with pico-boot auto-discovery)
+# Quick Example (with pico-boot auto-discovery)
 
 ### 1. Controller
 
@@ -200,7 +205,7 @@ app = container.get(FastAPI)
 
 ---
 
-## 💬 WebSocket Example
+## WebSocket Example
 
 ```python
 from pico_fastapi import controller, websocket
@@ -218,7 +223,7 @@ class ChatController:
 
 ---
 
-## 🧪 Testing with Overrides
+## Testing with Overrides
 
 ```python
 from pico_ioc import init
@@ -242,7 +247,7 @@ assert client.get("/api/hello").json() == {"msg": "test"}
 
 ---
 
-## 📁 Static Files Configuration Example
+## Static Files Configuration Example
 
 ```python
 from dataclasses import dataclass
@@ -263,7 +268,7 @@ class StaticFilesConfigurer(FastApiConfigurer):
     priority = -100
     def __init__(self, settings: StaticSettings):
         self.settings = settings
-    def configure(self, app: FastAPI) -> None:
+    def configure_app(self, app: FastAPI) -> None:
         app.mount(self.settings.static_url, StaticFiles(directory=self.settings.static_dir), name="static")
 ```
 
@@ -295,7 +300,7 @@ fastapi:
 
 ---
 
-## 🔐 JWT Authentication Configuration Example
+## JWT Authentication Configuration Example
 
 ```python
 import base64
@@ -358,7 +363,7 @@ class JwtConfigurer(FastApiConfigurer):
     def __init__(self, container: PicoContainer, settings: JwtSettings):
         self.container = container
         self.settings = settings
-    def configure(self, app: FastAPI) -> None:
+    def configure_app(self, app: FastAPI) -> None:
         app.add_middleware(JwtMiddleware, container=self.container, secret=self.settings.secret)
 ```
 
@@ -391,7 +396,7 @@ app = container.get(FastAPI)
 
 ---
 
-## ⚙️ How It Works
+## How It Works
 
 * Controller classes are discovered and registered automatically
 * Each route executes within its own request or websocket scope
@@ -402,20 +407,27 @@ No global state and no implicit singletons.
 
 ---
 
-## 🤖 Claude Code Skills
+## AI Coding Skills
+
+Install [Claude Code](https://code.claude.com) or [OpenAI Codex](https://openai.com/index/introducing-codex/) skills for AI-assisted development with pico-fastapi:
+
+```bash
+curl -sL https://raw.githubusercontent.com/dperezcabrera/pico-skills/main/install.sh | bash -s -- fastapi
+```
 
-This project includes pre-designed skills for [Claude Code](https://claude.ai/claude-code), enabling AI-assisted development with pico-fastapi patterns.
+| Command | Description |
+|---------|-------------|
+| `/add-controller` | Add FastAPI controllers with route decorators |
+| `/add-component` | Add components, factories, interceptors, settings |
+| `/add-tests` | Generate tests for pico components |
 
-| Skill | Command | Description |
-|-------|---------|-------------|
-| **Pico FastAPI Endpoint** | `/pico-fastapi` | Creates endpoints with controller-based routing and DI |
-| **Pico Test Generator** | `/pico-tests` | Generates tests for pico-framework components |
+All skills: `curl -sL https://raw.githubusercontent.com/dperezcabrera/pico-skills/main/install.sh | bash`
 
-See [Skills documentation](docs/skills.md) for full details and installation instructions.
+See [pico-skills](https://github.com/dperezcabrera/pico-skills) for details.
 
 ---
 
-## 📝 License
+## License
 
 MIT