pico-fastapi 0.1.0__tar.gz

pico_fastapi-0.1.0/.coveragerc

@@ -0,0 +1,17 @@
+[run]
+branch = True
+source =
+    pico_fastapi
+omit =
+    */_version.py
+
+[paths]
+pico_fastapi =
+    src/pico_fastapi
+    .tox/*/lib/*/site-packages/pico_fastapi
+    .tox/*/site-packages/pico_fastapi
+    */site-packages/pico_fastapi
+
+[report]
+show_missing = True
+

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

@@ -0,0 +1,102 @@
+name: CI & Coverage
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  tests:
+    name: Tests (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: [ "3.10", "3.11", "3.12", "3.13", "3.14" ]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: Install tox
+        run: |
+          python -m pip install --upgrade pip
+          pip install tox
+
+      - name: Run tests with coverage (writes to repo root)
+        shell: bash
+        run: |
+          set -euxo pipefail
+          tox -e cov
+          # Rename to per-version file for artifact + merge job
+          mv .coverage .coverage.${{ matrix.python-version }}
+          ls -la .coverage.${{ matrix.python-version }}
+
+      - name: Upload .coverage artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-${{ matrix.python-version }}
+          path: .coverage.${{ matrix.python-version }}
+          include-hidden-files: true
+          if-no-files-found: error
+
+  coverage-merge:
+    name: Merge coverage
+    runs-on: ubuntu-latest
+    needs: tests
+    steps:
+      - name: Checkout (for repo context)
+        uses: actions/checkout@v4
+
+      - name: Download all coverage artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: coverage-reports
+
+      - name: Combine coverage and generate reports
+        shell: bash
+        run: |
+          set -euxo pipefail
+          python -m pip install coverage
+          files=$(find coverage-reports -type f -name ".coverage.*" -print)
+          if [ -z "$files" ]; then
+            echo "No coverage data files found"; exit 1
+          fi
+          coverage combine $files
+          coverage report -m --rcfile=.coveragerc
+          coverage xml -o coverage.xml --rcfile=.coveragerc
+          coverage html -d htmlcov --rcfile=.coveragerc
+
+      - name: Upload combined coverage XML
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-xml
+          path: coverage.xml
+          if-no-files-found: error
+
+      - name: Upload HTML coverage report
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-html
+          path: htmlcov
+          if-no-files-found: error
+
+      - name: Upload to Codecov
+        if: always() && !cancelled()
+        uses: codecov/codecov-action@v5
+        continue-on-error: true
+        with:
+          files: coverage.xml
+          fail_ci_if_error: false
+          token: ${{ secrets.CODECOV_TOKEN }}
+          slug: dperezcabrera/pico-fastapi
+

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

@@ -0,0 +1,36 @@
+name: Publish Python Package to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
+
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.x'
+
+    - name: Install build deps
+      run: python -m pip install --upgrade pip build
+
+    - name: Build package
+      run: python -m build
+
+    - name: Publish to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        skip-existing: true
+        verify-metadata: true
+        attestations: false
+

pico_fastapi-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 David Pérez Cabrera
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pico_fastapi-0.1.0/MANIFEST.in

@@ -0,0 +1,24 @@
+# Incluir ficheros importantes
+include README.md
+include LICENSE
+
+# Incluir todo el código fuente
+recursive-include src *.py
+
+# Incluir datos de tests si quieres que otros puedan correrlos desde el sdist
+# (opcional — puedes quitarlo si no quieres incluir tests en PyPI)
+recursive-include tests *.py
+
+# Excluir cosas innecesarias
+exclude .gitignore
+exclude Dockerfile*
+exclude docker-compose*.yml
+exclude Makefile
+
+# Excluir carpetas de build, virtualenvs, caches, etc.
+prune build
+prune dist
+prune .tox
+prune .pytest_cache
+prune __pycache__
+

pico_fastapi-0.1.0/PKG-INFO

@@ -0,0 +1,214 @@
+Metadata-Version: 2.4
+Name: pico-fastapi
+Version: 0.1.0
+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
+        
+        Copyright (c) 2025 David Pérez Cabrera
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+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
+Keywords: ioc,di,dependency injection,fastapi,inversion of control,spring boot,controller
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: FastAPI
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pico-ioc>=2.0
+Requires-Dist: fastapi>=0.100
+Provides-Extra: session
+Requires-Dist: starlette-session; extra == "session"
+Provides-Extra: run
+Requires-Dist: uvicorn[standard]; extra == "run"
+Dynamic: license-file
+
+# 📦 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)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+![CI (tox matrix)](https://github.com/dperezcabrera/pico-ioc/actions/workflows/ci.yml/badge.svg)
+[![codecov](https://codecov.io/gh/dperezcabrera/pico-fastapi/branch/main/graph/badge.svg)](https://codecov.io/gh/dperezcabrera/pico-fastapi)
+[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=dperezcabrera_pico-fastapi&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=dperezcabrera_pico-fastapi)
+[![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)
+
+**pico-fastapi** integrates **Pico-IoC** with **FastAPI**, enabling *constructor-based dependency injection*, scoped lifecycles, and clean architectural boundaries — without global state or FastAPI dependency functions.
+
+> 🐍 Requires **Python 3.10+**  
+> ✅ Fully async-compatible  
+> ✅ Real IoC (constructor injection, not function injection)  
+> ✅ Works with request, session, and websocket scopes  
+
+---
+
+## 🎯 Why pico-fastapi?
+
+FastAPI’s built-in dependency system is function-based, which makes business logic tightly coupled to the framework.
+
+`pico-fastapi` moves dependency resolution to the **IoC container**.
+
+| Concern | FastAPI Default | pico-fastapi |
+|--------|----------------|--------------|
+| Dependency injection | Function-based | Constructor-based |
+| Architecture | Framework-driven | Domain-driven |
+| Testing | Must simulate DI functions | Component overrides at container init |
+| Scopes | Manual or ad-hoc | `singleton`, `request`, `session`, `websocket` |
+
+---
+
+## 🧱 Core Features
+
+- `@controller` class-based routing
+- `@get`, `@post`, `@websocket`, etc.
+- Constructor injection for controllers & services
+- Automatic registration into FastAPI
+- Scoped resolution via middleware (`request`, `session`, `websocket`)
+- Full compatibility with Pico-IoC features: overrides, profiles, interceptors, cleanup
+
+---
+
+## 📦 Installation
+
+```bash
+pip install pico-fastapi
+````
+
+Also requires:
+
+```bash
+pip install pico-ioc fastapi
+```
+
+---
+
+## 🚀 Quick Example
+
+```python
+# controllers.py
+from pico_fastapi import controller, get
+
+@controller(prefix="/api")
+class ApiController:
+    def __init__(self, service: "MyService"):
+        self.service = service
+
+    @get("/hello")
+    async def hello(self):
+        return {"msg": self.service.greet()}
+```
+
+```python
+# services.py
+class MyService:
+    def greet(self) -> str:
+        return "hello from service"
+```
+
+```python
+# main.py
+from pico_ioc import init
+from fastapi import FastAPI
+
+container = init(
+    modules=[
+        "controllers",
+        "services",
+        "pico_fastapi.factory",
+    ]
+)
+
+app = container.get(FastAPI)  # ✅ retrieve the fully configured app
+```
+
+---
+
+## 💬 WebSocket Example
+
+```python
+from pico_fastapi import controller, websocket
+from fastapi import WebSocket
+
+@controller
+class ChatController:
+    async def __init__(self):
+        pass
+
+    @websocket("/ws")
+    async def chat(self, websocket: WebSocket):
+        await websocket.accept()
+        while True:
+            message = await websocket.receive_text()
+            await websocket.send_text(f"Echo: {message}")
+```
+
+---
+
+## 🧪 Testing with Overrides
+
+```python
+from pico_ioc import init
+from fastapi import FastAPI
+from fastapi.testclient import TestClient
+
+class FakeService:
+    def greet(self) -> str:
+        return "test"
+
+container = init(
+    modules=["controllers", "services", "pico_fastapi.factory"],
+    overrides={ "MyService": FakeService() }
+)
+
+app = container.get(FastAPI)
+client = TestClient(app)
+
+assert client.get("/api/hello").json() == {"msg": "test"}
+```
+
+---
+
+## ⚙️ How It Works
+
+* `@controller` classes are registered automatically
+* HTTP/WebSocket handlers are wrapped in a request or websocket scope
+* All dependencies (services, config, state) are resolved through Pico-IoC
+* Cleanup happens at application shutdown via lifespan integration
+
+No global state. No implicit singletons. No magic.
+
+---
+
+## 📝 License
+
+MIT — See `LICENSE`.
+
+

pico_fastapi-0.1.0/README.md

@@ -0,0 +1,162 @@
+# 📦 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)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+![CI (tox matrix)](https://github.com/dperezcabrera/pico-ioc/actions/workflows/ci.yml/badge.svg)
+[![codecov](https://codecov.io/gh/dperezcabrera/pico-fastapi/branch/main/graph/badge.svg)](https://codecov.io/gh/dperezcabrera/pico-fastapi)
+[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=dperezcabrera_pico-fastapi&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=dperezcabrera_pico-fastapi)
+[![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)
+
+**pico-fastapi** integrates **Pico-IoC** with **FastAPI**, enabling *constructor-based dependency injection*, scoped lifecycles, and clean architectural boundaries — without global state or FastAPI dependency functions.
+
+> 🐍 Requires **Python 3.10+**  
+> ✅ Fully async-compatible  
+> ✅ Real IoC (constructor injection, not function injection)  
+> ✅ Works with request, session, and websocket scopes  
+
+---
+
+## 🎯 Why pico-fastapi?
+
+FastAPI’s built-in dependency system is function-based, which makes business logic tightly coupled to the framework.
+
+`pico-fastapi` moves dependency resolution to the **IoC container**.
+
+| Concern | FastAPI Default | pico-fastapi |
+|--------|----------------|--------------|
+| Dependency injection | Function-based | Constructor-based |
+| Architecture | Framework-driven | Domain-driven |
+| Testing | Must simulate DI functions | Component overrides at container init |
+| Scopes | Manual or ad-hoc | `singleton`, `request`, `session`, `websocket` |
+
+---
+
+## 🧱 Core Features
+
+- `@controller` class-based routing
+- `@get`, `@post`, `@websocket`, etc.
+- Constructor injection for controllers & services
+- Automatic registration into FastAPI
+- Scoped resolution via middleware (`request`, `session`, `websocket`)
+- Full compatibility with Pico-IoC features: overrides, profiles, interceptors, cleanup
+
+---
+
+## 📦 Installation
+
+```bash
+pip install pico-fastapi
+````
+
+Also requires:
+
+```bash
+pip install pico-ioc fastapi
+```
+
+---
+
+## 🚀 Quick Example
+
+```python
+# controllers.py
+from pico_fastapi import controller, get
+
+@controller(prefix="/api")
+class ApiController:
+    def __init__(self, service: "MyService"):
+        self.service = service
+
+    @get("/hello")
+    async def hello(self):
+        return {"msg": self.service.greet()}
+```
+
+```python
+# services.py
+class MyService:
+    def greet(self) -> str:
+        return "hello from service"
+```
+
+```python
+# main.py
+from pico_ioc import init
+from fastapi import FastAPI
+
+container = init(
+    modules=[
+        "controllers",
+        "services",
+        "pico_fastapi.factory",
+    ]
+)
+
+app = container.get(FastAPI)  # ✅ retrieve the fully configured app
+```
+
+---
+
+## 💬 WebSocket Example
+
+```python
+from pico_fastapi import controller, websocket
+from fastapi import WebSocket
+
+@controller
+class ChatController:
+    async def __init__(self):
+        pass
+
+    @websocket("/ws")
+    async def chat(self, websocket: WebSocket):
+        await websocket.accept()
+        while True:
+            message = await websocket.receive_text()
+            await websocket.send_text(f"Echo: {message}")
+```
+
+---
+
+## 🧪 Testing with Overrides
+
+```python
+from pico_ioc import init
+from fastapi import FastAPI
+from fastapi.testclient import TestClient
+
+class FakeService:
+    def greet(self) -> str:
+        return "test"
+
+container = init(
+    modules=["controllers", "services", "pico_fastapi.factory"],
+    overrides={ "MyService": FakeService() }
+)
+
+app = container.get(FastAPI)
+client = TestClient(app)
+
+assert client.get("/api/hello").json() == {"msg": "test"}
+```
+
+---
+
+## ⚙️ How It Works
+
+* `@controller` classes are registered automatically
+* HTTP/WebSocket handlers are wrapped in a request or websocket scope
+* All dependencies (services, config, state) are resolved through Pico-IoC
+* Cleanup happens at application shutdown via lifespan integration
+
+No global state. No implicit singletons. No magic.
+
+---
+
+## 📝 License
+
+MIT — See `LICENSE`.
+
+