nlbone 0.1.28__py3-none-any.whl → 0.1.30__py3-none-any.whl

nlbone/adapters/db/__init__.py

@@ -1,2 +1,2 @@
 from .sqlalchemy.engine import init_async_engine, async_session, async_ping, init_sync_engine, sync_session, sync_ping
-from .sqlalchemy.query import *
+from .sqlalchemy import *

nlbone/adapters/db/sqlalchemy/__init__.py

@@ -1,3 +1,4 @@
 from .query import apply_pagination, apply_filters, apply_order
+from .base import Base
 
-__all__ = ["apply_pagination", "apply_filters", "apply_order"]
+__all__ = ["apply_pagination", "apply_filters", "apply_order", "Base"]

nlbone/adapters/db/sqlalchemy/base.py

@@ -0,0 +1,5 @@
+from sqlalchemy.orm import declarative_base
+
+Base = declarative_base()
+
+

nlbone/adapters/db/sqlalchemy/engine.py

@@ -112,7 +112,8 @@ def sync_session() -> Generator[Session, None, None]:
 
 
 def sync_ping() -> None:
-    """Health check برای اتصال sync."""
+    """Health check for sync."""
     eng = init_sync_engine()
     with eng.connect() as conn:
         conn.execute(text("SELECT 1"))
+

nlbone/adapters/db/sqlalchemy/schema.py

@@ -0,0 +1,29 @@
+
+import importlib
+from typing import Sequence
+
+from nlbone.adapters.db.sqlalchemy.base import Base
+from nlbone.adapters.db.sqlalchemy.engine import init_async_engine, init_sync_engine
+
+
+DEFAULT_MODEL_MODULES: Sequence[str] = (
+)
+
+def import_model_modules(modules: Sequence[str] | None = None) -> None:
+    for m in (modules or DEFAULT_MODEL_MODULES):
+        importlib.import_module(m)
+
+# --------- Async (SQLAlchemy 2.x) ----------
+async def init_db_async(model_modules: Sequence[str] | None = None) -> None:
+    """Create tables using AsyncEngine (dev/test). Prefer Alembic in prod."""
+    import_model_modules(model_modules)
+    engine = init_async_engine()
+    async with engine.begin() as conn:
+        await conn.run_sync(Base.metadata.create_all)
+
+# --------- Sync ----------
+def init_db_sync(model_modules: Sequence[str] | None = None) -> None:
+    """Create tables using Sync Engine (dev/test). Prefer Alembic in prod."""
+    import_model_modules(model_modules)
+    engine = init_sync_engine()
+    Base.metadata.create_all(bind=engine)

nlbone/adapters/http_clients/uploadchi.py

@@ -0,0 +1,177 @@
+from __future__ import annotations
+
+import json
+from typing import Any, AsyncIterator, Optional
+
+import httpx
+
+from nlbone.core.ports.files import FileServicePort
+from nlbone.config.settings import get_settings
+
+
+class FileServiceException(RuntimeError):
+    def __init__(self, status: int, detail: Any | None = None):
+        super().__init__(f"Uploadchi HTTP {status}: {detail}")
+        self.status = status
+        self.detail = detail
+
+
+def _auth_headers(token: str | None) -> dict[str, str]:
+    return {"Authorization": f"Bearer {token}"} if token else {}
+
+
+def _build_list_query(
+        limit: int,
+        offset: int,
+        filters: dict[str, Any] | None,
+        sort: list[tuple[str, str]] | None,
+) -> dict[str, Any]:
+    q: dict[str, Any] = {"limit": limit, "offset": offset}
+    if filters:
+        # سرور شما `filters` را به صورت string می‌گیرد؛
+        # اگر سمت سرور JSON هم قبول می‌کند، این بهتر است:
+        q["filters"] = json.dumps(filters)
+    if sort:
+        # "created_at:desc,id:asc"
+        q["sort"] = ",".join([f"{f}:{o}" for f, o in sort])
+    return q
+
+
+class UploadchiClient(FileServicePort):
+    """
+    httpx-based client for the Uploadchi microservice.
+
+    Base URL نمونه: http://uploadchi.internal/api/v1/files
+    """
+
+    def __init__(
+            self,
+            base_url: Optional[str] = None,
+            timeout_seconds: Optional[float] = None,
+            client: httpx.AsyncClient | None = None,
+    ) -> None:
+        s = get_settings()
+        self._base_url = base_url or str(s.UPLOADCHI_BASE_URL)
+        self._timeout = timeout_seconds or float(s.HTTP_TIMEOUT_SECONDS)
+        # اگر کلاینت تزریق نشد، خودمان می‌سازیم
+        self._client = client or httpx.AsyncClient(
+            base_url=self._base_url,
+            timeout=self._timeout,
+            follow_redirects=True,
+        )
+
+    async def aclose(self) -> None:
+        await self._client.aclose()
+
+    # ---------- Endpoints ----------
+
+    async def upload_file(
+            self,
+            file_bytes: bytes,
+            filename: str,
+            params: dict[str, Any] | None = None,
+            token: str | None = None,
+    ) -> dict:
+        """
+        POST ""  →  returns FileOut (dict)
+        fields:
+          - file: Upload (multipart)
+          - other params (e.g., bucket, folder, content_type, ...)
+        """
+        files = {"file": (filename, file_bytes)}
+        data = (params or {}).copy()
+        r = await self._client.post(
+            url="",
+            files=files,
+            data=data,
+            headers=_auth_headers(token),
+        )
+        if r.status_code >= 400:
+            raise FileServiceException(r.status_code, r.text)
+        return r.json()
+
+    async def commit_file(
+            self,
+            file_id: int,
+            client_id: str,
+            token: str | None = None,
+    ) -> None:
+        """
+        POST "/{file_id}/commit" 204
+        """
+        r = await self._client.post(
+            f"/{file_id}/commit",
+            headers=_auth_headers(token),
+            params={"client_id": client_id} if client_id else None,
+        )
+        if r.status_code not in (204, 200):
+            raise FileServiceException(r.status_code, r.text)
+
+    async def list_files(
+            self,
+            limit: int = 10,
+            offset: int = 0,
+            filters: dict[str, Any] | None = None,
+            sort: list[tuple[str, str]] | None = None,
+            token: str | None = None,
+    ) -> dict:
+        """
+        GET "" → returns PaginateResponse-like dict
+          { "data": [...], "total_count": int | null, "total_page": int | null }
+        """
+        q = _build_list_query(limit, offset, filters, sort)
+        r = await self._client.get("", params=q, headers=_auth_headers(token))
+        if r.status_code >= 400:
+            raise FileServiceException(r.status_code, r.text)
+        return r.json()
+
+    async def get_file(
+            self,
+            file_id: int,
+            token: str | None = None,
+    ) -> dict:
+        """
+        GET "/{file_id}" → FileOut dict
+        """
+        r = await self._client.get(f"/{file_id}", headers=_auth_headers(token))
+        if r.status_code >= 400:
+            raise FileServiceException(r.status_code, r.text)
+        return r.json()
+
+    async def download_file(
+            self,
+            file_id: int,
+            token: str | None = None,
+    ) -> tuple[AsyncIterator[bytes], str, str]:
+        """
+        GET "/{file_id}/download" → stream + headers (filename, content-type)
+        """
+        r = await self._client.get(f"/{file_id}/download", headers=_auth_headers(token))
+        if r.status_code >= 400:
+            text = await r.aread()
+            raise FileServiceException(r.status_code, text.decode(errors="ignore"))
+
+        disp = r.headers.get("content-disposition", "")
+        filename = (
+            disp.split("filename=", 1)[1].strip("\"'") if "filename=" in disp else f"file-{file_id}"
+        )
+        media_type = r.headers.get("content-type", "application/octet-stream")
+
+        async def _aiter() -> AsyncIterator[bytes]:
+            async for chunk in r.aiter_bytes():
+                yield chunk
+            await r.aclose()
+
+        return _aiter(), filename, media_type
+
+    async def delete_file(
+            self,
+            file_id: int,
+            token: str | None = None,
+    ) -> None:
+        """
+        DELETE "/{file_id}" → 204
+        """
+        r = await self._client.delete(f"/{file_id}", headers=_auth_headers(token))
+        if r.status_code not in (204, 200):
+            raise FileServiceException(r.status_code, r.text)

nlbone/config/settings.py

@@ -54,6 +54,8 @@ class Settings(BaseSettings):
     # ---------------------------
     REDIS_URL: str = Field(default="redis://localhost:6379/0")
 
+    UPLOADCHI_BASE_URL: AnyHttpUrl = Field(default="https://uploadchi.numberland.ir/v1/files")
+
     model_config = SettingsConfigDict(
         env_prefix="NLBONE_",
         env_file=None,

nlbone/core/ports/files.py

@@ -0,0 +1,47 @@
+from __future__ import annotations
+from typing import Protocol, runtime_checkable, AsyncIterator, Any
+
+@runtime_checkable
+class FileServicePort(Protocol):
+    async def upload_file(
+        self,
+        file_bytes: bytes,
+        filename: str,
+        params: dict[str, Any] | None = None,
+        token: str | None = None,
+    ) -> dict: ...
+
+    async def commit_file(
+        self,
+        file_id: int,
+        client_id: str,
+        token: str | None = None,
+    ) -> None: ...
+
+    async def list_files(
+        self,
+        limit: int = 10,
+        offset: int = 0,
+        filters: dict[str, Any] | None = None,
+        sort: list[tuple[str, str]] | None = None,
+        token: str | None = None,
+    ) -> dict: ...
+
+    async def get_file(
+        self,
+        file_id: int,
+        token: str | None = None,
+    ) -> dict: ...
+
+    async def download_file(
+        self,
+        file_id: int,
+        token: str | None = None,
+    ) -> tuple[AsyncIterator[bytes], str, str]:
+        ...
+
+    async def delete_file(
+        self,
+        file_id: int,
+        token: str | None = None,
+    ) -> None: ...

nlbone/di/container.py

@@ -1,7 +1,11 @@
+from nlbone.adapters.http_clients.uploadchi import UploadchiClient
 from nlbone.config.settings import Settings
 from nlbone.adapters.auth.keycloak import KeycloakAuthService
+from nlbone.core.ports.files import FileServicePort
+
 
 class Container:
     def __init__(self, settings: Settings | None = None):
         self.settings = settings or Settings()
-        self.auth: KeycloakAuthService = KeycloakAuthService(self.settings)
+        self.auth: KeycloakAuthService = KeycloakAuthService(self.settings)
+        self.file_service: FileServicePort = UploadchiClient()

nlbone/interfaces/cli/init_db.py

@@ -0,0 +1,17 @@
+import argparse
+import anyio
+
+from nlbone.adapters.db.sqlalchemy.schema import init_db_async, init_db_sync
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description="Initialize database schema (create_all).")
+    parser.add_argument("--async", dest="use_async", action="store_true", help="Use AsyncEngine")
+    args = parser.parse_args()
+
+    if args.use_async:
+        anyio.run(init_db_async)
+    else:
+        init_db_sync()
+
+if __name__ == "__main__":
+    main()

{nlbone-0.1.28.dist-info → nlbone-0.1.30.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nlbone
-Version: 0.1.28
+Version: 0.1.30
 Summary: Backbone package for interfaces and infrastructure in Python projects
 Author-email: Amir Hosein Kahkbazzadeh <a.khakbazzadeh@gmail.com>
 License: MIT

{nlbone-0.1.28.dist-info → nlbone-0.1.30.dist-info}/RECORD

@@ -3,12 +3,14 @@ nlbone/types.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nlbone/adapters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nlbone/adapters/auth/__init__.py,sha256=Eh9kWjY1I8vi17gK0oOzBLJwJX_GFuUcJIN7cLU6lJg,41
 nlbone/adapters/auth/keycloak.py,sha256=W5siUCFtOANDHZH9eDHsXIQ5cC6BDTk_Zv5mh3STSGo,2416
-nlbone/adapters/db/__init__.py,sha256=c37FCZ-Yv49gZNMyG-3HFrmt5tuQUl2Rzg80p5DXDdI,150
+nlbone/adapters/db/__init__.py,sha256=aHur2GuykZd26RpEmIbkAfflkksZuKWAlYLJMIYotQE,144
 nlbone/adapters/db/memory.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nlbone/adapters/db/postgres.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nlbone/adapters/db/query_builder.py,sha256=qL2Ppe39X7pnKpHfWZZanxfEKqQW3grZv5bQLS52mfU,6066
-nlbone/adapters/db/sqlalchemy/__init__.py,sha256=bq_dIuk4JqT-68k6p0aMb7DY2GqcsvvsuZT5uZDuTBU,127
-nlbone/adapters/db/sqlalchemy/engine.py,sha256=baEByNlB8NFuGVnMMz7xJqNa1_1E7DbLJ0vUo9vFarg,3045
+nlbone/adapters/db/sqlalchemy/__init__.py,sha256=REK4P8SF6kvDNYgkZIbSowhHPivyFVnMCYGfYT1dlxk,158
+nlbone/adapters/db/sqlalchemy/base.py,sha256=-5FnCMKETJ2xykhViHQuNBdbRMaxuieuatgiEl4Lllw,73
+nlbone/adapters/db/sqlalchemy/engine.py,sha256=m3nVY7KU12ksM3vK9fEgYEobrz9L8hfsgjI8cSNtBMY,3030
+nlbone/adapters/db/sqlalchemy/schema.py,sha256=iiE42UT-DJh-ohezLFBWTBFN5WtrfZdtKToQDNLvoOs,1044
 nlbone/adapters/db/sqlalchemy/query/__init__.py,sha256=9SFkoNkklaji6kZt_Nl6X6vqMFE92GiqW36Zezr5PuE,129
 nlbone/adapters/db/sqlalchemy/query/builder.py,sha256=AzUX2MlfrMGY-EITzVJoq9naM5sTL9h9yzI7cCeEBRk,886
 nlbone/adapters/db/sqlalchemy/query/coercion.py,sha256=uYClfEuew_W4r-vbwj2c5MVpayejhpOMl6h4iUrMotQ,2142
@@ -17,15 +19,16 @@ nlbone/adapters/db/sqlalchemy/query/ordering.py,sha256=THbuxZmoFZzJIa28KfDQ6ioS8
 nlbone/adapters/db/sqlalchemy/query/types.py,sha256=M2j6SOSyFkLuyXq4kvPYgZQYz5TKCBe3osoIIN1yfBI,287
 nlbone/adapters/http_clients/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nlbone/adapters/http_clients/email_gateway.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nlbone/adapters/http_clients/uploadchi.py,sha256=tr-huESnVDg08FQh3QTFST7_JQz7dPShr2CAX9CQYLU,5737
 nlbone/adapters/messaging/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nlbone/adapters/messaging/redis.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nlbone/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nlbone/config/logging.py,sha256=68WRQejEpL6eHEY_cOgdlOjndKc-RWth0n4YmXnceC8,5041
-nlbone/config/settings.py,sha256=jkaVzlKuQKASd6-xT69RAEbMcbol6PUKa86QPpjami0,2272
+nlbone/config/settings.py,sha256=ElE--1waYQ2o_5u7HzHi800zsK9n_oJBz1VnewYm-Y0,2368
 nlbone/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-nlbone/core/{__init__.py},sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nlbone/core/application/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nlbone/core/application/services.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nlbone/core/application/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nlbone/core/application/use_cases/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nlbone/core/application/use_cases/register_user.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nlbone/core/domain/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -33,25 +36,28 @@ nlbone/core/domain/events.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,
 nlbone/core/domain/models.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nlbone/core/ports/__init__.py,sha256=J24ldeLIQ_AWqKpdNbtaEWq4-G4cyWx8XEG0Dt6keao,29
 nlbone/core/ports/auth.py,sha256=v2NiH8FzKXZ1MabzQxaK7AQvnt-GQindYIki90swTE4,492
+nlbone/core/ports/files.py,sha256=dYBMFsaesyIVaWxzTShGFMFzRZWbWcQtPdzhELY6t4A,1119
 nlbone/core/ports/messaging.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nlbone/core/ports/repo.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nlbone/di/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-nlbone/di/container.py,sha256=7-lcrH1q9NmNLY7VMpLfPJZYKsvNuXP2U6gOYcCwgPo,304
+nlbone/di/container.py,sha256=nzWx8nctyBMAERoqjolt0vWS38H2JH2QhqVaLvAvF8U,488
 nlbone/interfaces/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nlbone/interfaces/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-nlbone/interfaces/api/dependencies.py,sha256=IqDVq1lcCCxd22FBUg523lVANM_j71BYAQtsbrHc4M8,465
 nlbone/interfaces/api/exceptions.py,sha256=OczR1FND2nbCngwbfgaPrgDbDaz4Pc47mFSHgtL7tW8,313
 nlbone/interfaces/api/routers.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nlbone/interfaces/api/schemas.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nlbone/interfaces/api/dependencies/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nlbone/interfaces/api/dependencies/db.py,sha256=IqDVq1lcCCxd22FBUg523lVANM_j71BYAQtsbrHc4M8,465
 nlbone/interfaces/api/pagination/__init__.py,sha256=fdTqy5efdYIcUWbK1mVPQMieGd3HV1lZ8vmIhhsuUKs,58
 nlbone/interfaces/api/pagination/offset_base.py,sha256=W0SJ0rHLMIqoyiPEAjnoKqY57LBXEyT5J-_5bS8r-NY,4535
 nlbone/interfaces/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nlbone/interfaces/cli/init_db.py,sha256=6Q05gwcPa6ywwz3Dzi0hiV8bycg0zU_3eWGsL6VNVRk,479
 nlbone/interfaces/cli/main.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nlbone/interfaces/jobs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nlbone/interfaces/jobs/sync_tokens.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nlbone/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nlbone/utils/time.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-nlbone-0.1.28.dist-info/METADATA,sha256=wLV-hD2zpMxiftxKAZyi7edCHJtFtkO-OqM41_3wp1M,2256
-nlbone-0.1.28.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-nlbone-0.1.28.dist-info/licenses/LICENSE,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-nlbone-0.1.28.dist-info/RECORD,,
+nlbone-0.1.30.dist-info/METADATA,sha256=hQwj8vQ4nzW0BYq5H4HIH9ezBEAvLzAtdWMzJCpPrXY,2256
+nlbone-0.1.30.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+nlbone-0.1.30.dist-info/licenses/LICENSE,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nlbone-0.1.30.dist-info/RECORD,,