fastapi-modular 0.1.0__py3-none-any.whl

fastapi_modular-0.1.0.dist-info/METADATA

@@ -0,0 +1,377 @@
+Metadata-Version: 2.5
+Name: fastapi-modular
+Version: 0.1.0
+Summary: FastAPI theo kiến trúc module kiểu NestJS: DI container, controller dạng class, WebSocket, RabbitMQ/Redis/MQTT/Kafka
+Project-URL: Homepage, https://github.com/quanglinh2909/pymodular
+Project-URL: Documentation, https://github.com/quanglinh2909/pymodular/tree/main/docs
+Project-URL: Source, https://github.com/quanglinh2909/pymodular
+Project-URL: Issues, https://github.com/quanglinh2909/pymodular/issues
+Project-URL: Changelog, https://github.com/quanglinh2909/pymodular/blob/main/CHANGELOG.md
+Author-email: Oryza <developer@oryza.vn>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: dependency-injection,fastapi,kafka,module,mqtt,nestjs,rabbitmq,redis,websocket
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: fastapi<1.0.0,>=0.115.0
+Requires-Dist: pydantic-settings<3.0.0,>=2.6.0
+Requires-Dist: pydantic<3.0.0,>=2.9.0
+Requires-Dist: structlog>=24.4.0
+Requires-Dist: uvicorn[standard]<1.0.0,>=0.32.0
+Provides-Extra: all
+Requires-Dist: aio-pika<10.0.0,>=9.4.0; extra == 'all'
+Requires-Dist: aiokafka<0.13.0,>=0.10.0; extra == 'all'
+Requires-Dist: aiomqtt<3.0.0,>=2.0.0; extra == 'all'
+Requires-Dist: aiosqlite>=0.20.0; extra == 'all'
+Requires-Dist: alembic>=1.13.0; extra == 'all'
+Requires-Dist: asyncpg>=0.29.0; extra == 'all'
+Requires-Dist: motor<4.0.0,>=3.6.0; extra == 'all'
+Requires-Dist: redis<7.0.0,>=5.0.0; extra == 'all'
+Requires-Dist: sqlalchemy[asyncio]<3.0.0,>=2.0.30; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: httpx>=0.27.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
+Requires-Dist: pytest>=8.3.0; extra == 'dev'
+Requires-Dist: ruff>=0.6.0; extra == 'dev'
+Provides-Extra: kafka
+Requires-Dist: aiokafka<0.13.0,>=0.10.0; extra == 'kafka'
+Provides-Extra: mongodb
+Requires-Dist: motor<4.0.0,>=3.6.0; extra == 'mongodb'
+Provides-Extra: mqtt
+Requires-Dist: aiomqtt<3.0.0,>=2.0.0; extra == 'mqtt'
+Provides-Extra: postgres
+Requires-Dist: alembic>=1.13.0; extra == 'postgres'
+Requires-Dist: asyncpg>=0.29.0; extra == 'postgres'
+Requires-Dist: sqlalchemy[asyncio]<3.0.0,>=2.0.30; extra == 'postgres'
+Provides-Extra: rabbitmq
+Requires-Dist: aio-pika<10.0.0,>=9.4.0; extra == 'rabbitmq'
+Provides-Extra: redis
+Requires-Dist: redis<7.0.0,>=5.0.0; extra == 'redis'
+Provides-Extra: sqlite
+Requires-Dist: aiosqlite>=0.20.0; extra == 'sqlite'
+Requires-Dist: alembic>=1.13.0; extra == 'sqlite'
+Requires-Dist: sqlalchemy[asyncio]<3.0.0,>=2.0.30; extra == 'sqlite'
+Description-Content-Type: text/markdown
+
+# pymodular
+
+FastAPI theo kiến trúc module kiểu NestJS: DI container, controller dạng class,
+repository chung cho nhiều loại database, gateway WebSocket có phòng, và bốn lớp
+hạ tầng tuỳ chọn: RabbitMQ, Redis, MQTT, Kafka.
+
+> **In English:** pymodular brings NestJS-style modular architecture to FastAPI —
+> a DI container, class-based controllers, auto-discovered modules, a shared
+> repository over four databases, a WebSocket gateway with rooms, and optional
+> RabbitMQ / Redis / MQTT / Kafka layers that stay dormant until enabled.
+> **Documentation is in Vietnamese**; the public API is English.
+
+## Bắt đầu
+
+Cần **Python 3.10+**.
+
+```bash
+python -m venv .venv && . .venv/bin/activate
+pip install fastapi-modular
+
+pym init          # đổ file vào THƯ MỤC HIỆN TẠI, không tạo thêm cấp
+pym dev
+```
+
+Mở http://localhost:8000/docs — đã có sẵn một module `health` chạy được.
+
+`pym init` lấy tên dự án theo **tên thư mục hiện tại**; đặt tên khác bằng
+`pym init --name ten-khac`. Nó không ghi đè file nào đã có, nên chạy được cả
+trong thư mục đang có sẵn code. Muốn nó tự tạo thư mục thì `pym new <tên>`.
+
+Lõi **không kéo theo** driver database hay client hàng đợi nào. Cần cái gì thì
+thêm cái đó:
+
+```bash
+pym install sqlite      # hoặc postgres, mongodb
+pym install rabbitmq    # hoặc redis, mqtt, kafka
+pym install all         # tất cả
+```
+
+`pym install` vừa cài thư viện vừa ghi biến vào `.env`. Muốn tự cài bằng pip
+cũng được: `pip install "fastapi-modular[sqlite,rabbitmq]"`.
+
+## Lệnh
+
+Một chương trình, hai tên: `pymodular` (đầy đủ) và `pym` (gõ tắt). Dưới đây dùng
+`pym` cho gọn.
+
+Tên lệnh rút gọn được tới khi nào tiền tố còn chỉ đúng một lệnh — `pym mo alerts`
+chạy y hệt `pym module alerts`. Nhập nhằng thì `pym` hỏi lại chứ không đoán:
+
+```
+$ pym m
+pym: lệnh 'm' chưa rõ — khớp với migrate, module. Gõ thêm vài chữ cho rõ.
+```
+
+| Lệnh | Rút gọn | Làm gì |
+|---|---|---|
+| `pym init [--name <tên>]` | `pym ini` | dựng dự án **trong thư mục hiện tại**, không ghi đè file nào đã có; tên dự án mặc định lấy theo tên thư mục |
+| `pym new <tên>` | `pym n` | dựng dự án trong một thư mục mới |
+| `pym dev` | `pym d` | chạy kèm autoreload |
+| `pym run --workers 4` | `pym r` | chạy chế độ production |
+| `pym module <tên>` | `pym mo` | sinh module: controller + service + dto + entity |
+| `pym module <tên> --gateway` | | kèm gateway WebSocket (`--consumer` cho RabbitMQ) |
+| `pym module <tên> --gateway-only` | | chỉ thêm gateway vào module **đã có** (`--consumer-only` cho RabbitMQ) |
+| `pym module <tên> --entity <Tên>` | | đặt tên lớp entity; mặc định đoán từ tên module |
+| `pym env <thành-phần>` | `pym e` | chỉ ghi biến cấu hình vào `.env` (không cài gì) |
+| `pym clean` | `pym c` | xoá cache và bản dựng (không đụng `data/`) |
+| `pym build` · `pym publish [--test]` | `pym b` · `pym p` | dựng wheel/sdist · đẩy lên PyPI |
+| `pym info` | `pym inf` | đang nối vào đâu, thư viện nào đã cài, cảnh báo cấu hình prod |
+| `pym migrate [up\|down\|history\|sql\|create]` | `pym mi` | Alembic |
+| `pym test` · `pym lint [--fix]` | `pym t` · `pym l` | pytest · ruff. `pym lint` không tham số soi `src`; truyền đường dẫn để soi chỗ khác |
+| **Thêm database** | | *cài thư viện **rồi** ghi biến vào `.env`* |
+| `pym install sqlite` | `pym ins s` | file `.db`, không cần server |
+| `pym install postgres` | `pym ins p` | PostgreSQL |
+| `pym install mongodb` | `pym ins mo` | MongoDB |
+| **Thêm hàng đợi** | | *cài thư viện **rồi** ghi biến vào `.env`* |
+| `pym install rabbitmq` | `pym ins ra` | hàng đợi bền, thử lại + DLQ |
+| `pym install redis` | `pym ins re` | cache, đếm nguyên tử, pub/sub |
+| `pym install mqtt` | `pym ins mq` | thiết bị IoT |
+| `pym install kafka` | `pym ins k` | nhật ký sự kiện đọc lại được |
+| `pym install ws-redis` | `pym ins w` | phát tin WebSocket xuyên nhiều worker |
+| `pym install dev` | `pym ins d` | pytest · pytest-asyncio · httpx · ruff — cần cho `pym test` / `pym lint` |
+| `pym install all` | `pym ins a` | tất cả những thứ trên, **trừ** `dev` |
+
+Tham số dạng danh sách cũng rút gọn theo cùng luật đó: `pym ins sq`,
+`pym e post`, `pym mi h`. Còn giá trị bạn tự đặt thì không bị đụng tới —
+`pym mo ins` tạo module tên đúng là `ins`.
+
+Host và cổng lấy từ `APP_HOST` / `APP_PORT` trong `.env`, nên `pym dev` không cần
+tham số. `pym --help` cho danh sách đầy đủ.
+
+## Thêm module
+
+```bash
+pym module alerts              # controller + service + dto + entities
+pym module alerts --gateway    # kèm gateway WebSocket
+pym module alerts --consumer   # kèm consumer RabbitMQ
+```
+
+Route xuất hiện ngay, bảng được tạo ngay, validate chạy ngay — chỉ thân hàm là
+chưa viết (gọi vào trả 501 kèm tên hàm). Việc của bạn: thêm trường vào entity và
+DTO, rồi viết thân hàm trong service.
+
+Không phải sửa file nào khác. Chi tiết: [docs/architecture.md](docs/architecture.md#thêm-module-mới).
+
+## Chọn database
+
+`pym install sqlite` (hoặc `postgres`, `mongodb`) làm cả hai việc: cài thư viện
+của đúng driver đó, rồi ghi biến vào `.env`. Chỉ muốn ghi `.env` mà không cài gì
+thì dùng `pym env sqlite`.
+
+`pym env` ghi mỗi biến kèm giải thích, cho biết nó **bắt buộc hay tuỳ chọn** và
+**mặc định là gì** nếu xoá dòng đi. `pym info` cho biết hiện đang nối vào đâu.
+
+Chi tiết: [docs/database.md](docs/database.md).
+
+## Cấu hình của riêng bạn
+
+Kế thừa `Settings` là thêm được biến vào `.env`, không phải sửa gì trong khung:
+
+```python
+# src/core/config.py — pym init sinh sẵn file này
+class AppSettings(Settings):
+    team_name: str = Field(default="", alias="APP_TEAM_NAME")
+    jwt: JwtSettings = Field(default_factory=JwtSettings, alias="APP_JWT")   # -> APP_JWT__SECRET
+```
+
+Service nhận `AppSettings` qua DI với gợi ý kiểu đầy đủ.
+Chi tiết: [docs/config.md](docs/config.md).
+
+## Điểm vào là file của bạn
+
+`pym init` sinh ra `src/main.py` với từng bước lắp ráp bày ra hết — thêm
+middleware, đổi CORS, gắn router bên thứ ba thì sửa thẳng ở đó:
+
+```python
+settings = bind_settings(AppSettings())
+configure_logging(settings.log)
+
+app = new_fastapi(settings, lifespan=lifespan)
+add_middleware(app, settings)                       # CORS + request-id + access log
+register_error_handlers(app, debug=settings.debug)
+register_routes(app, prefix=settings.api_prefix)    # quét src/api/
+```
+
+Chưa cần sửa gì thì cả khối rút lại còn `app = create_app(AppSettings())` —
+`create_app` chạy đúng dãy trên, không hơn.
+
+Vòng đời cũng vậy: `src/core/lifespan.py` là của bạn, chỉ **bọc** phần hạ tầng
+của khung lại:
+
+```python
+@asynccontextmanager
+async def lifespan(app):
+    async with framework_lifespan(app):   # khung mở database, hàng đợi
+        await warm_cache()                # việc riêng — database đã dùng được
+        try:
+            yield
+        finally:
+            await flush_ledger()          # việc riêng — database VẪN CÒN
+```
+
+Đo trên log thật: `db.connected` → `app.started` → **`app.ready`** → …phục vụ… →
+**`app.closing`** → `app.stopping` → `app.stopped`.
+
+## Realtime (WebSocket)
+
+Một client một kết nối, vào phòng để nhận tin theo nhóm, hoặc nhận tin gửi
+thẳng cho riêng mình:
+
+```python
+@gateway(path="/ws/alerts", guards=[WsJwt], client_rooms=True)
+class AlertGateway:
+    @subscribe("alert.ack")
+    async def ack(self, socket: Socket, payload: AlertAck) -> dict:
+        return {"ok": True}
+```
+
+```bash
+pym dev
+# ws://localhost:8000/ws/chat?client_id=an
+
+pym module alerts --gateway-only   # thêm gateway vào module đã có
+pym install ws-redis               # bắt buộc khi chạy nhiều worker
+```
+
+Đẩy tin từ REST hay tác vụ nền: nhận `WebSocketServer` qua `__init__` rồi gọi
+`to_room` / `to_user` / `to_socket`.
+
+Hướng dẫn đầy đủ (kèm cách dùng bằng **Postman** và client **Next.js**):
+[docs/websocket.md](docs/websocket.md).
+
+## Hàng đợi (RabbitMQ — tuỳ chọn)
+
+```python
+await self._mq.publish("events", "alert.created.hanoi", {"id": "A1"})
+
+# Mặc định: đúng MỘT hàng đợi trên broker, hỏng là bỏ (có log).
+@rabbitmq_subscriber("events", "alert.created", queue="alert-mailer")
+async def gui_mail(self, payload: AlertCreated) -> None: ...
+
+# Tự bật khi tin đáng tiền -> thêm alert-mailer.retry và alert-mailer.dlq
+@rabbitmq_subscriber("events", "alert.created", queue="alert-mailer",
+                     max_retries=3, dead_letter=True)
+async def gui_mail(self, payload: AlertCreated) -> None: ...
+```
+
+```bash
+pym install rabbitmq            # cài aio-pika + ghi APP_RABBITMQ__* vào .env
+pym module alerts --consumer    # module mới kèm consumer
+```
+
+Không cài, không bật thì mọi thứ chạy y như chưa từng có nó. Broker rớt thì app
+vẫn phục vụ và tự nối lại. Chi tiết: [docs/rabbitmq.md](docs/rabbitmq.md).
+
+## Redis, MQTT, Kafka (cũng tuỳ chọn)
+
+Cùng một khuôn với RabbitMQ: một package riêng dưới `infrastructure/`, một nhóm
+biến `APP_<TÊN>__*`, mặc định **tắt**, thư viện chỉ import khi bật, và luôn tự
+nối lại.
+
+```bash
+pym install redis    # cache, đếm, pub/sub      -> docs/redis.md
+pym install mqtt     # thiết bị IoT             -> docs/mqtt.md
+pym install kafka    # nhật ký sự kiện          -> docs/kafka.md
+```
+
+```python
+await redis.cached("bao-cao:A", tinh_that, ttl=30)     # trượt thì tính, trúng thì thôi
+await mqtt.publish("thiet-bi/bep/den", "ON", qos=1, retain=True)
+await kafka.publish("don-hang", don, key=don.ma_don)   # cùng key = cùng thứ tự
+
+@redis_subscriber("gia:*")                      # Redis: mọi worker một bản sao
+@mqtt_subscriber("thiet-bi/+/nhiet-do", qos=1)  # MQTT:  + một tầng, # mọi tầng
+@kafka_subscriber("don-hang", group="kho-van")  # Kafka: mỗi nhóm một con trỏ đọc
+```
+
+| Cần gì | Dùng gì |
+|---|---|
+| tin không được mất, chia việc cho worker | RabbitMQ |
+| nhanh, mọi worker nhận một bản sao, mất vài tin cũng được | Redis |
+| thiết bị, mạng chập chờn, kết nối lâu | MQTT |
+| đọc lại được lịch sử, nhiều nhóm đọc độc lập | Kafka |
+
+## Vận hành
+
+```bash
+curl localhost:8000/api/health        # liveness
+curl localhost:8000/api/health/ready  # readiness, có ping database
+curl localhost:8000/api/metrics       # số đo dạng Prometheus
+pym migrate                           # chạy migration (SQL)
+pym info                              # cấu hình đang dùng + cảnh báo prod
+```
+
+Chi tiết: [docs/operations.md](docs/operations.md).
+
+## Cấu trúc repo này
+
+```
+pymodular/          THƯ VIỆN — thứ được đóng gói và cài về
+  core/             DI, controller, config, WebSocket, guard, số đo
+  infrastructure/   database, rabbitmq, redis, mqtt, kafka (mỗi thứ một package)
+  cli/              init · new · module · dev · run · install · env · info
+                    migrate · test · lint · clean · build · publish
+  factory.py        create_app()
+  discovery.py      tự quét package ứng dụng, dựng router
+src/                ỨNG DỤNG MẪU — không nằm trong gói cài; xoá thoải mái
+  main.py           điểm vào: lắp ráp app — file của bạn, không phải của khung
+  core/config.py    AppSettings: kế thừa Settings để thêm biến .env của bạn
+  core/lifespan.py  việc lúc khởi động / lúc tắt của riêng ứng dụng
+  api/              các module nghiệp vụ; mỗi thư mục con là một module
+tests/              341 test chạy không cần hạ tầng, 40 test nữa bật khi có server thật
+docs/               tài liệu tra cứu
+```
+
+`pymodular/` không import gì từ `src/`. Nó chỉ biết "có một package tên
+`src.api`, quét nó đi" — nên dự án xếp khác cũng được, khai một lần trong
+`src/main.py`: `register_routes(app, package="cong_ty.dich_vu")`.
+
+## Đóng góp
+
+```bash
+git clone <repo> && cd pymodular
+pip install -e ".[all,dev]"
+pym dev                        # chạy ứng dụng mẫu trong src/
+pym test
+pym lint pymodular src tests
+```
+
+Nhóm test cần hạ tầng thật chỉ chạy khi có biến môi trường tương ứng:
+
+```bash
+docker run -d -p 6379:6379 redis:7-alpine
+TEST_REDIS_URL=redis://localhost:6379/0 pym test
+```
+
+Xem đầu mỗi file `tests/test_<tên>.py` để biết lệnh Docker và biến cần đặt.
+
+## Giấy phép
+
+MIT — xem [LICENSE](LICENSE).
+
+## Tài liệu
+
+- [docs/architecture.md](docs/architecture.md) — cấu trúc module, DI, đối chiếu NestJS
+- [docs/config.md](docs/config.md) — Settings, thứ tự ưu tiên, thêm biến của riêng bạn
+- [docs/database.md](docs/database.md) — memory / SQLite / PostgreSQL / MongoDB
+- [docs/migrations.md](docs/migrations.md) — Alembic: sinh, chạy, lùi migration
+- [docs/websocket.md](docs/websocket.md) — gateway WebSocket, phòng, Postman, Next.js
+- [docs/rabbitmq.md](docs/rabbitmq.md) — exchange, topic, consumer nền, `.retry` / `.dlq`
+- [docs/redis.md](docs/redis.md) — cache, đếm nguyên tử, pub/sub
+- [docs/mqtt.md](docs/mqtt.md) — QoS, retain, luật khớp topic `+` và `#`
+- [docs/kafka.md](docs/kafka.md) — nhóm consumer, phân vùng, `.dlt`
+- [docs/operations.md](docs/operations.md) — guard, circuit breaker, metrics, trace

fastapi_modular-0.1.0.dist-info/RECORD

@@ -0,0 +1,69 @@
+pymodular/__init__.py,sha256=fkq33egtR-FbqMJZD7O9L9f14OGlZLY6U17edBdHOO4,1959
+pymodular/discovery.py,sha256=GZYNOd2x1slzPSI35cRyvMHm8mIQyvlhKDHORD7fs8w,6627
+pymodular/factory.py,sha256=rSVx2eLw52YD4VSvtu1J-gVBOlfStMU-zJ_tUI0r6lk,4931
+pymodular/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pymodular/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pymodular/cli/clean.py,sha256=-VtxXSfB4N1l5m56mgmGc6fYVgOB5MERGLRWA-aKgnk,1517
+pymodular/cli/configure_env.py,sha256=oRhZHKAMgpeae8hHgUxbN_n66tSqUl6sT-wZbVxUfX8,24079
+pymodular/cli/cong_cu.py,sha256=vjTA1D9Xi_7wMTyb-6mYHMxUSqfjVSNTIAdixv_oJtU,3602
+pymodular/cli/info.py,sha256=6Zz4-mk2eupN9xVJdDGfIIVsm8qD3ku2IFeFWxM4PsY,2445
+pymodular/cli/install.py,sha256=0riOfY4eAdGNpWwL_KCR4reOj4vZPs3Wbzrgycshdv0,3083
+pymodular/cli/main.py,sha256=cxk196n4sQQRk_HFKeOb0Izl_jEY32e6jqnLf6gHCCY,10152
+pymodular/cli/new_module.py,sha256=w1ieN-DVGs0OC-tttsMXVy9tjreATWlcIWRfy1bdE3c,19098
+pymodular/cli/new_project.py,sha256=VX2SbmZaLCUeLP7BBAOH10ylfhTddEX0Kkl2Lm8pqbM,15256
+pymodular/cli/serve.py,sha256=UnMWgyMilj8v2TC387mCwh9zgxGx92qrNm6mex9MDEY,2054
+pymodular/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pymodular/core/clock.py,sha256=e085ol6MF5ni9Fsr_mexNq3ZZ_wqE9sDbt2JK8FUzIg,392
+pymodular/core/compat.py,sha256=JyP7fmNvJEqBR7npG4K8xY3wpuedjh2zgqQ-YBpUjaw,1578
+pymodular/core/config.py,sha256=TjiPlBOojl9vrLlqYCvROqNOYtLHwNMnIzQYY7a43XA,21855
+pymodular/core/container.py,sha256=BP8bjkQmcOYSxnjA1aeWD2u7CzL52zRcOhMfzEAMQFY,14253
+pymodular/core/context.py,sha256=XZM7JyA9jyaSeA3m2dPTkjkBoHb02oO_Jo4Xw8JlqUM,2141
+pymodular/core/controller.py,sha256=AqVEqlOMLK7SKrnf_sC1Y3cyqPYcXyGAAcTdOGq--to,7727
+pymodular/core/error_handlers.py,sha256=iPOofUT3VAluaMRjgC4nZ5QTcSLoESjWEJTIWEIpESY,11148
+pymodular/core/exceptions.py,sha256=2bKxkGFACjmVhQces9VgqlvfmqQ7vySHPrMORLK3pX0,2745
+pymodular/core/guards.py,sha256=efM_SsTc2vdvewSXJ3t5cg8ZOJp3PKBPAyWk36LiB6I,4747
+pymodular/core/lifespan.py,sha256=XX7P-5L8o91UTrJDWqqeZjMHOklSALTUqN26G8wtmIg,6003
+pymodular/core/logging.py,sha256=W6bRZZl-i14-O8Uv-b_8ThvgIupHfS1FOmTq_ANCm7w,3009
+pymodular/core/metrics.py,sha256=sDnqfPwCCzTbEjwZIma3tfHwo36m225PWDmzxRUBe9E,7202
+pymodular/core/schemas.py,sha256=QRlmzEaFnub5DxhSz5OWAalu9fednbuxIolmEIS4jlQ,4211
+pymodular/core/websocket/__init__.py,sha256=2LC-ZMJG1OScnJkYdzU42xbi6jXyPZG1ne0D9GPDEfA,1005
+pymodular/core/websocket/adapter.py,sha256=66q_W3GQsmolpg6hnMms8m6fMw_JP8vHpnvW39hnR5g,7139
+pymodular/core/websocket/gateway.py,sha256=OWye428-z8-tqIA6Ux7M_iSYRyhoFtkJdsToD0xz8Cw,28881
+pymodular/core/websocket/namespace.py,sha256=tgX6Xt2tqv3hUVHtAHVMfJQfR51H7ddaq10O9yoX53k,5292
+pymodular/core/websocket/protocol.py,sha256=mtZiB3v00pgXKvjuFL5__xVRxTnwV6rNn0hG7XstznE,5768
+pymodular/core/websocket/server.py,sha256=nonHhYcAOBCktWnk-JxUSPkfKnYKflHF48Pp6Cb7vU4,6734
+pymodular/core/websocket/socket.py,sha256=vW44UqDHzPAH7jQDJ_lY_odatJZAfjsSSCZHbyNhznM,9405
+pymodular/infrastructure/__init__.py,sha256=sCB7r_YNMxrpALUH0pRWYv0dN3ItuJHCxoQjBTMjjLY,110
+pymodular/infrastructure/database/__init__.py,sha256=RubEeUrWC1xt1xwMThgDQQ276f39LNKQHs50Vf7-T9M,293
+pymodular/infrastructure/database/base.py,sha256=izj68h0CC0NGv-8vCrVqkKvI7r_zBHJB59-Yu8gBZ_k,9275
+pymodular/infrastructure/database/circuit.py,sha256=odzERJsKjxS1DOPoofm7jbiCNyiunUiv_wuklKQe3co,8051
+pymodular/infrastructure/database/factory.py,sha256=ht6UwkkR6s2eCPkBJJZo6kdloS0tpgyiIAr5qa1gLoc,3591
+pymodular/infrastructure/database/memory.py,sha256=hN-zEuoDUH6PgRW5WGalCpFh1bvDLpVUt96jbGok_n8,3712
+pymodular/infrastructure/database/mongo.py,sha256=0J3A1TP17RlC_8wOQ6ubYkl0_SlEBSOxzpX4ITxoXEc,6884
+pymodular/infrastructure/database/repository.py,sha256=Bn8EGhO_s2essLuz8WXdeXQSUP8AZQ7RDlF15QcJem0,7214
+pymodular/infrastructure/database/sql.py,sha256=Z-j5zocrSiS80iXbliROcUJjowKmY2-EhHBYgiPRzrw,20292
+pymodular/infrastructure/kafka/__init__.py,sha256=eqSfsRNyOIz3sdvGPu9f5eT4G7JkKab9V2qcuEfxO9c,834
+pymodular/infrastructure/kafka/broker.py,sha256=7wH86A5Bl_bVrDtwG4J0k7D4ZgA4oSoR85daA4TI12A,9373
+pymodular/infrastructure/kafka/consumers.py,sha256=0ljwjc7igLqtcuWEgJkIM1MvCRmwbfFo0cuIovf2b1w,14897
+pymodular/infrastructure/kafka/metrics.py,sha256=nijdJ9DqhgFjQt0d0pC2fjvOzGrS36AjSKqwzAbeq5U,731
+pymodular/infrastructure/mqtt/__init__.py,sha256=zFZDVJCCYKMSTH6I3PaJwOpoGCyP1sEjCPuKU01QsKI,924
+pymodular/infrastructure/mqtt/client.py,sha256=pwFif7qhnD_QBLTqRSUhpiGFe0k5nYus9mcX1X1kCCE,12044
+pymodular/infrastructure/mqtt/consumers.py,sha256=SWwN4yFBJs6oCDvccb5IMNBBhHZ50QHZnFC6z2Guw34,8661
+pymodular/infrastructure/mqtt/metrics.py,sha256=Kvu77x5klqKJrc0TmjuLoLZVp2_nqkF_RhtpnHzWhwU,692
+pymodular/infrastructure/mqtt/patterns.py,sha256=saiM7-JEi85Jk_Q7ASWKdW8xpWIMU57TG6TUsV66m7w,4733
+pymodular/infrastructure/rabbitmq/__init__.py,sha256=PEdKaF2-x3HABpiffBz0_UADB98PliXTU2CLJdqSZYc,1252
+pymodular/infrastructure/rabbitmq/broker.py,sha256=_27rj0uBGe2bJ0XSnq-jAkGAAfAxiO841leqWZbdkwI,27608
+pymodular/infrastructure/rabbitmq/consumers.py,sha256=HkkO-Br2G2pbpOm3DmCnzYwjrt_4zE_IYyE6LAdlwNo,19521
+pymodular/infrastructure/rabbitmq/metrics.py,sha256=5mkCXLkA94piSn-okYqVcYiw7DKFHcvmEwelR-lKmPE,1447
+pymodular/infrastructure/rabbitmq/patterns.py,sha256=u6BcS4zNIAnBTmOecxC9ZMzcOREdPyy4mvHzO1Kb4oY,2646
+pymodular/infrastructure/redis/__init__.py,sha256=4ob8B-e-uA3NseNcu58l190ctuvGc0--mA3VyYAWgKs,1028
+pymodular/infrastructure/redis/client.py,sha256=4rIjJ-QLl1RG-6_-spauw89VHwD4uWAhL84CYURK880,14500
+pymodular/infrastructure/redis/metrics.py,sha256=JW-FglJf--jqvScsigDAq14wlr3zPdNa6KldOr_2Bg0,880
+pymodular/infrastructure/redis/pubsub.py,sha256=ZAIKryWx3qbNZ4PDg70SRPnMXkIMTSmrnG6IUS_-2MY,10540
+pymodular/middleware/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pymodular/middleware/request_context.py,sha256=Xug7pOdaGS8I6ztf9K4VzOcwL8AEaK7Z4hC7KJTlhCQ,6243
+fastapi_modular-0.1.0.dist-info/METADATA,sha256=VlnFkyPEZtTohiCGD_kX3Zrio_9UWhoaHEKwvs6BXbE,17075
+fastapi_modular-0.1.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+fastapi_modular-0.1.0.dist-info/entry_points.txt,sha256=QpF54ARgRQ58MyF0v8LW0urajkMjZ03Ex6I7JbCdwUA,84
+fastapi_modular-0.1.0.dist-info/licenses/LICENSE,sha256=2GmLoFfZHwTkURvEu7fEPxaciitDK-1elAhNfl_A9Mo,1062
+fastapi_modular-0.1.0.dist-info/RECORD,,

fastapi_modular-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.0
+Root-Is-Purelib: true
+Tag: py3-none-any

fastapi_modular-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+pym = pymodular.cli.main:main
+pymodular = pymodular.cli.main:main

fastapi_modular-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Oryza
+
+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.

pymodular/__init__.py

@@ -0,0 +1,74 @@
+"""pymodular — FastAPI theo kiến trúc module kiểu NestJS.
+
+    from pymodular import create_app
+    app = create_app()
+
+Những thứ hay dùng nhất được xuất thẳng ở đây; phần còn lại nằm trong
+`pymodular.core`, `pymodular.infrastructure`.
+"""
+
+from __future__ import annotations
+
+from pymodular.core.config import Settings, get_settings, use_settings
+from pymodular.core.container import Lazy, Scope, container, entity, injectable
+from pymodular.core.controller import controller, delete, get, patch, post, put
+from pymodular.core.error_handlers import register_error_handlers
+from pymodular.core.exceptions import (
+    AppError,
+    BadRequestError,
+    ComponentNotEnabledError,
+    ConflictError,
+    ForbiddenError,
+    NotFoundError,
+    ServiceUnavailableError,
+    UnauthorizedError,
+)
+from pymodular.core.lifespan import lifespan
+from pymodular.core.logging import configure_logging, get_logger
+from pymodular.core.schemas import Page
+from pymodular.core.websocket import Socket, WebSocketServer, gateway, subscribe
+from pymodular.discovery import DEFAULT_PACKAGE, register_routes
+from pymodular.factory import add_middleware, bind_settings, create_app, new_fastapi
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "DEFAULT_PACKAGE",
+    "AppError",
+    "BadRequestError",
+    "ComponentNotEnabledError",
+    "ConflictError",
+    "ForbiddenError",
+    "Lazy",
+    "NotFoundError",
+    "Page",
+    "Scope",
+    "ServiceUnavailableError",
+    "Settings",
+    "Socket",
+    "UnauthorizedError",
+    "WebSocketServer",
+    "__version__",
+    "add_middleware",
+    "bind_settings",
+    "configure_logging",
+    "container",
+    "controller",
+    "create_app",
+    "delete",
+    "entity",
+    "gateway",
+    "get",
+    "get_logger",
+    "get_settings",
+    "injectable",
+    "lifespan",
+    "new_fastapi",
+    "patch",
+    "post",
+    "put",
+    "register_error_handlers",
+    "register_routes",
+    "subscribe",
+    "use_settings",
+]

pymodular/cli/clean.py

@@ -0,0 +1,39 @@
+"""`pym clean` — xoá cache và bản dựng, không đụng vào code hay dữ liệu."""
+
+from __future__ import annotations
+
+import shutil
+from pathlib import Path
+
+# Cố ý KHÔNG có `data/` hay `*.db`: đó là dữ liệu, không phải rác. Xoá dữ liệu
+# phải là việc người ta gõ tay, không bao giờ là tác dụng phụ của "dọn cache".
+THU_MUC = ("__pycache__", ".pytest_cache", ".ruff_cache", ".mypy_cache",
+           ".pytype", "htmlcov", "build", "dist", ".eggs")
+DUOI_FILE = ("*.pyc", "*.pyo", ".coverage", "coverage.xml")
+
+
+def clean(root: Path | None = None) -> int:
+    goc = (root or Path(".")).resolve()
+    xoa: list[str] = []
+
+    for ten in THU_MUC:
+        for d in goc.rglob(ten):
+            if d.is_dir() and ".venv" not in d.parts:
+                shutil.rmtree(d, ignore_errors=True)
+                xoa.append(str(d.relative_to(goc)))
+    for d in goc.rglob("*.egg-info"):
+        if ".venv" not in d.parts:
+            shutil.rmtree(d, ignore_errors=True) if d.is_dir() else d.unlink()
+            xoa.append(str(d.relative_to(goc)))
+    for mau in DUOI_FILE:
+        for f in goc.rglob(mau):
+            if ".venv" not in f.parts and f.is_file():
+                f.unlink()
+                xoa.append(str(f.relative_to(goc)))
+
+    print(f"Đã xoá {len(xoa)} thứ." if xoa else "Không có gì để xoá.")
+    for d in sorted(xoa)[:20]:
+        print(f"    {d}")
+    if len(xoa) > 20:
+        print(f"    ... và {len(xoa) - 20} thứ nữa")
+    return 0