# Matrix Zion FastAPI Plugin
[](https://badge.fury.io/py/matrix-zion-fastapi)
[](https://pypi.org/project/matrix-zion-fastapi/)
[](https://opensource.org/licenses/MIT)
Plugin FastAPI para o Matrix Zion Framework, fornecendo capacidades de API REST.
## 🚀 Características
- **FastAPI Integration**: Integração nativa com FastAPI
- **Auto-routing**: Descoberta automática de rotas
- **Middleware Support**: Suporte para middlewares customizados
- **OpenAPI**: Documentação automática via Swagger/OpenAPI
- **Auto-descoberta**: Registra-se automaticamente no framework Matrix
## 📦 Instalação
```bash
pip install matrix-zion-fastapi
```
**Nota**: Este plugin requer o `matrix-zion` como dependência base.
## 🎯 Uso Básico
```python
from matrix.zion import Zion
# Inicializar o framework
app = Zion()
# O plugin FastAPI será automaticamente descoberto e carregado
app.discover_plugins()
# Usar funcionalidades FastAPI através do plugin
fastapi_plugin = app.get_plugin('fastapi')
api_app = fastapi_plugin.get_app()
@api_app.get("/health")
async def health_check():
return {"status": "healthy"}
# Executar servidor
fastapi_plugin.run(host="0.0.0.0", port=8000)
```
## ⚙️ Configuração
Configure o servidor através de variáveis de ambiente:
```bash
export FASTAPI_HOST=0.0.0.0
export FASTAPI_PORT=8000
export FASTAPI_DEBUG=true
```
## 🔧 Dependências
- `matrix-zion>=0.1.0`
- `fastapi>=0.100.0`
- `uvicorn>=0.20.0`
## 📚 Documentação
Para documentação completa, visite: [GitHub Repository](https://github.com/tuyoshivinicius/python-microservice-v2)
## 📄 Licença
Este projeto está licenciado sob a Licença MIT - veja o arquivo [LICENSE](LICENSE) para detalhes.
Raw data
{
"_id": null,
"home_page": "https://github.com/tuyoshivinicius/python-microservice-v2",
"name": "matrix-zion-fastapi",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "microservices, fastapi, matrix, plugin, rest, api",
"author": "Tuyoshi Vinicius",
"author_email": "tuyoshi.vinicius@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/6b/5e/e57afbe1aedb3806236946eaf47737e682bc590d8c47edaa289e75c37cb2/matrix_zion_fastapi-0.1.0.tar.gz",
"platform": null,
"description": "# Matrix Zion FastAPI Plugin\n\n[](https://badge.fury.io/py/matrix-zion-fastapi)\n[](https://pypi.org/project/matrix-zion-fastapi/)\n[](https://opensource.org/licenses/MIT)\n\nPlugin FastAPI para o Matrix Zion Framework, fornecendo capacidades de API REST.\n\n## \ud83d\ude80 Caracter\u00edsticas\n\n- **FastAPI Integration**: Integra\u00e7\u00e3o nativa com FastAPI\n- **Auto-routing**: Descoberta autom\u00e1tica de rotas\n- **Middleware Support**: Suporte para middlewares customizados\n- **OpenAPI**: Documenta\u00e7\u00e3o autom\u00e1tica via Swagger/OpenAPI\n- **Auto-descoberta**: Registra-se automaticamente no framework Matrix\n\n## \ud83d\udce6 Instala\u00e7\u00e3o\n\n```bash\npip install matrix-zion-fastapi\n```\n\n**Nota**: Este plugin requer o `matrix-zion` como depend\u00eancia base.\n\n## \ud83c\udfaf Uso B\u00e1sico\n\n```python\nfrom matrix.zion import Zion\n\n# Inicializar o framework\napp = Zion()\n\n# O plugin FastAPI ser\u00e1 automaticamente descoberto e carregado\napp.discover_plugins()\n\n# Usar funcionalidades FastAPI atrav\u00e9s do plugin\nfastapi_plugin = app.get_plugin('fastapi')\napi_app = fastapi_plugin.get_app()\n\n@api_app.get(\"/health\")\nasync def health_check():\n return {\"status\": \"healthy\"}\n\n# Executar servidor\nfastapi_plugin.run(host=\"0.0.0.0\", port=8000)\n```\n\n## \u2699\ufe0f Configura\u00e7\u00e3o\n\nConfigure o servidor atrav\u00e9s de vari\u00e1veis de ambiente:\n\n```bash\nexport FASTAPI_HOST=0.0.0.0\nexport FASTAPI_PORT=8000\nexport FASTAPI_DEBUG=true\n```\n\n## \ud83d\udd27 Depend\u00eancias\n\n- `matrix-zion>=0.1.0`\n- `fastapi>=0.100.0`\n- `uvicorn>=0.20.0`\n\n## \ud83d\udcda Documenta\u00e7\u00e3o\n\nPara documenta\u00e7\u00e3o completa, visite: [GitHub Repository](https://github.com/tuyoshivinicius/python-microservice-v2)\n\n## \ud83d\udcc4 Licen\u00e7a\n\nEste projeto est\u00e1 licenciado sob a Licen\u00e7a MIT - veja o arquivo [LICENSE](LICENSE) para detalhes.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Extens\u00e3o FastAPI para o framework Matrix - Plugin para APIs REST",
"version": "0.1.0",
"project_urls": {
"Bug Reports": "https://github.com/tuyoshivinicius/python-microservice-v2/issues",
"Documentation": "https://github.com/tuyoshivinicius/python-microservice-v2/blob/main/README.md",
"Homepage": "https://github.com/tuyoshivinicius/python-microservice-v2",
"Repository": "https://github.com/tuyoshivinicius/python-microservice-v2"
},
"split_keywords": [
"microservices",
" fastapi",
" matrix",
" plugin",
" rest",
" api"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "dae64b994587b42e0fc71725cab08d2bdcb2fcf7c6cfa1859f2ed3a427bd77b0",
"md5": "da471ff2f3efe78a2c23aec49582083e",
"sha256": "bf34d77c1a0b22638d7c987d799c5daf2ec033aec3223360c1e8d8b2ac349660"
},
"downloads": -1,
"filename": "matrix_zion_fastapi-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "da471ff2f3efe78a2c23aec49582083e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 2826,
"upload_time": "2025-09-04T16:40:16",
"upload_time_iso_8601": "2025-09-04T16:40:16.802406Z",
"url": "https://files.pythonhosted.org/packages/da/e6/4b994587b42e0fc71725cab08d2bdcb2fcf7c6cfa1859f2ed3a427bd77b0/matrix_zion_fastapi-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "6b5ee57afbe1aedb3806236946eaf47737e682bc590d8c47edaa289e75c37cb2",
"md5": "081e9871c79a7b0a11771c0d6fe5c215",
"sha256": "f39dddeb072b97ba52092fda5d6c0c81bd40026207ccaf7863f5585d69921332"
},
"downloads": -1,
"filename": "matrix_zion_fastapi-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "081e9871c79a7b0a11771c0d6fe5c215",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 2271,
"upload_time": "2025-09-04T16:40:17",
"upload_time_iso_8601": "2025-09-04T16:40:17.975844Z",
"url": "https://files.pythonhosted.org/packages/6b/5e/e57afbe1aedb3806236946eaf47737e682bc590d8c47edaa289e75c37cb2/matrix_zion_fastapi-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-04 16:40:17",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "tuyoshivinicius",
"github_project": "python-microservice-v2",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "matrix-zion-fastapi"
}