nlbone 0.1.37__py3-none-any.whl → 0.2.0__py3-none-any.whl

nlbone/adapters/auth/keycloak.py

@@ -11,7 +11,7 @@ class KeycloakAuthService(AuthService):
             server_url=s.KEYCLOAK_SERVER_URL.__str__(),
             client_id=s.KEYCLOAK_CLIENT_ID,
             realm_name=s.KEYCLOAK_REALM_NAME,
-            client_secret_key=s.KEYCLOAK_CLIENT_SECRET.__str__(),
+            client_secret_key=s.KEYCLOAK_CLIENT_SECRET.get_secret_value().strip(),
         )
 
     def has_access(self, token, permissions):

nlbone/adapters/db/query_builder.py

@@ -6,7 +6,7 @@ from sqlalchemy.orm import Session, Query
 from sqlalchemy.dialects.postgresql import ENUM as PGEnum
 
 from nlbone.interfaces.api.exceptions import UnprocessableEntityException
-from nlbone.interfaces.api.pagination import PaginateRequest
+from nlbone.interfaces.api.pagination import PaginateRequest, PaginateResponse
 
 NULL_SENTINELS = {"None", "null", ""}
 
@@ -15,7 +15,7 @@ class _InvalidEnum(Exception):
     pass
 
 
-def _apply_order(pagination, entity, query):
+def _apply_order(pagination: PaginateRequest, entity, query):
     if pagination.sort:
         order_clauses = []
         for sort in pagination.sort:
@@ -177,3 +177,13 @@ def apply_pagination(pagination: PaginateRequest, entity, session: Session, limi
     if limit:
         query = query.limit(pagination.limit).offset(pagination.offset)
     return query
+
+
+def get_paginated_response(pagination: PaginateRequest, entity, session: Session, with_count=True) -> PaginateResponse:
+    query = apply_pagination(pagination, entity, session, not with_count)
+    total_count = None
+    if with_count:
+        total_count = query.count()
+        query = query.limit(pagination.limit).offset(pagination.offset)
+    return PaginateResponse(total_count=total_count, data=query.all(), limit=pagination.limit,
+                            offset=pagination.offset).to_dict()

nlbone/config/settings.py

@@ -15,8 +15,8 @@ def _guess_env_file() -> str | None:
     if cwd_env.exists():
         return str(cwd_env)
 
-    for i in range(1, 8):
-        p = Path(__file__).resolve().parents[i]
+    for i in range(0, 8):
+        p = Path.cwd().resolve().parents[i]
         f = p / ".env"
         if f.exists():
             return str(f)

nlbone/interfaces/api/dependencies/auth.py

@@ -0,0 +1,48 @@
+import functools
+
+from nlbone.adapters.auth import KeycloakAuthService
+from nlbone.interfaces.api.exceptions import ForbiddenException, UnauthorizedException
+from nlbone.utils.context import current_request
+
+
+def client_has_access(*, permissions=None):
+    def decorator(func):
+        @functools.wraps(func)
+        def wrapper(*args, **kwargs):
+            request = current_request()
+            if not KeycloakAuthService().client_has_access(request.state.token, permissions=permissions):
+                raise ForbiddenException(f"Forbidden {permissions}")
+
+            return func(*args, **kwargs)
+
+        return wrapper
+    return decorator
+
+
+
+def user_authenticated(func):
+    @functools.wraps(func)
+    async def wrapper(*args, **kwargs):
+        request = current_request()
+        if not request.state.user_id:
+            raise UnauthorizedException()
+        return await func(*args, **kwargs)
+
+    return wrapper
+
+
+def has_access(*, permissions=None):
+    def decorator(func):
+        @functools.wraps(func)
+        def wrapper(*args, **kwargs):
+            request = current_request()
+            if not request.state.user_id:
+                raise UnauthorizedException()
+            if not KeycloakAuthService().has_access(request.state.token, permissions=permissions):
+                raise ForbiddenException(f"Forbidden {permissions}")
+
+            return func(*args, **kwargs)
+
+        return wrapper
+    return decorator
+

nlbone/interfaces/api/exceptions.py

@@ -1,8 +1,67 @@
+from typing import Any, Iterable
 from fastapi import HTTPException, status
 
+
+def _error_entry(loc: Iterable[Any] | None, msg: str, type_: str) -> dict:
+    return {
+        "loc": list(loc) if loc else [],
+        "msg": msg,
+        "type": type_,
+    }
+
+
+def _errors(loc: Iterable[Any] | None, msg: str, type_: str) -> list[dict]:
+    return [_error_entry(loc, msg, type_)]
+
+
+class BadRequestException(HTTPException):
+    def __init__(self, msg: str):
+        super().__init__(
+            status_code=status.HTTP_400_BAD_REQUEST,
+            detail=msg,
+        )
+
+
+class UnauthorizedException(HTTPException):
+    def __init__(self, msg: str = "unauthorized"):
+        super().__init__(
+            status_code=status.HTTP_401_UNAUTHORIZED,
+            detail=msg,
+        )
+
+
+class ForbiddenException(HTTPException):
+    def __init__(self, msg: str = "forbidden"):
+        super().__init__(
+            status_code=status.HTTP_403_FORBIDDEN,
+            detail=msg,
+        )
+
+
+class NotFoundException(HTTPException):
+    def __init__(self, msg: str = "not found"):
+        super().__init__(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=msg,
+        )
+
+
+class ConflictException(HTTPException):
+    def __init__(self, msg: str = "conflict"):
+        super().__init__(
+            status_code=status.HTTP_409_CONFLICT,
+            detail=msg,
+        )
+
+
 class UnprocessableEntityException(HTTPException):
-    def __init__(self, detail: str, loc: list[str] | None = None):
+    def __init__(self, msg: str, loc: Iterable[Any] | None = None, type_: str = "unprocessable_entity"):
         super().__init__(
             status_code=status.HTTP_422_UNPROCESSABLE_ENTITY,
-            detail={"msg": detail, "loc": loc or []},
+            detail=_errors(loc, msg, type_),
         )
+
+
+class LogicalValidationException(UnprocessableEntityException):
+    def __init__(self, msg: str, loc: Iterable[Any] | None = None, type_: str = "logical_error"):
+        super().__init__(msg=msg, loc=loc, type_=type_)

nlbone/interfaces/api/pagination/__init__.py

@@ -1 +1,9 @@
-from .offset_base import PaginateResponse, PaginateRequest
+from fastapi import Depends
+
+from .offset_base import PaginateResponse, PaginateRequest
+
+
+def get_pagination(
+        req: PaginateRequest = Depends(PaginateRequest)
+) -> PaginateRequest:
+    return req

nlbone/interfaces/api/pagination/offset_base.py

@@ -1,6 +1,3 @@
-# src/nlbone/interfaces/api/pagination.py
-from __future__ import annotations
-
 import json
 from math import ceil
 from typing import Any, Optional
@@ -21,7 +18,7 @@ class PaginateRequest:
         limit: int = 10,
         offset: int = 0,
         sort: Optional[str] = None,
-        filters: Optional[str] = Query(None, description="e.g. title:abc or JSON"),
+        filters: Optional[str] = Query(None, description="e.g. title:abc"),
     ) -> None:
         self.limit = max(0, limit)
         self.offset = max(0, offset)
@@ -78,26 +75,6 @@ class PaginateRequest:
             filters_dict[key] = value_cast
         return filters_dict
 
-    # Helpers for SQLAlchemy usage:
-    def build_order_by(self, model) -> list[Any]:
-        """
-        Translate parsed sort to SQLAlchemy order_by list.
-        Example: model.created_at.desc(), model.id.asc()
-        """
-        items: list[Any] = []
-        for item in self.sort:
-            field = getattr(model, item["field"], None)
-            if field is None:
-                continue
-            items.append(desc(field) if item["order"] == "desc" else asc(field))
-        return items
-
-    def filter_kwargs(self) -> dict[str, Any]:
-        """
-        Return simple equality filters (for model.filter_by(**kwargs)).
-        For advanced ops, extend this to parse operators (gt, lt, like, in, etc.).
-        """
-        return {k: v for k, v in self.filters.items() if k != "$"}
 
 
 class PaginateResponse:

{nlbone-0.1.37.dist-info → nlbone-0.2.0.dist-info}/METADATA

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

{nlbone-0.1.37.dist-info → nlbone-0.2.0.dist-info}/RECORD

@@ -3,11 +3,11 @@ nlbone/container.py,sha256=KO8y8hfEt0graWhUi-FU_rG-WPckl-uF7H9JGcwEu38,1321
 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=kTjndbDtoCfDohJi59kbXb8JhoEXo8Na_OzraaOVotw,2434
+nlbone/adapters/auth/keycloak.py,sha256=lPmRmCwBuDj9fUJsGMUCOuk_MsuLBQYBrO3QvBBaV8I,2451
 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/query_builder.py,sha256=xrhBiWRSsyLHzGft0weHwqRPOiP2i6ajqcxJOruHOF4,6606
 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
@@ -26,7 +26,7 @@ nlbone/adapters/messaging/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJW
 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=i89s5Jbb3qzW8vYXjxrm__bx0OKhFvEfqltwE95lVMc,3278
+nlbone/config/settings.py,sha256=2PEGXJwmhjHK9wuX2AKCfPZWz3F1dvJ5ig4Sad7jqlc,3274
 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
@@ -43,17 +43,18 @@ nlbone/core/ports/messaging.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuF
 nlbone/core/ports/repo.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nlbone/interfaces/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nlbone/interfaces/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-nlbone/interfaces/api/exceptions.py,sha256=OczR1FND2nbCngwbfgaPrgDbDaz4Pc47mFSHgtL7tW8,313
+nlbone/interfaces/api/exceptions.py,sha256=mw0nZHO2oKml3-d7cdSBTQeVGKFQCjLn_TJy6rxcrU0,1901
 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=XrTGkHS8xqryfyr8XSm_s9sIzp4E0b44XQ40sVWcKMY,46
+nlbone/interfaces/api/dependencies/auth.py,sha256=XwzKga9GkcvCKUg37zEnVw8m30MbR-4wh1CTeLG2jH8,1445
 nlbone/interfaces/api/dependencies/db.py,sha256=IqDVq1lcCCxd22FBUg523lVANM_j71BYAQtsbrHc4M8,465
 nlbone/interfaces/api/middleware/__init__.py,sha256=Xcxg9Oy8uToPXaTSdBTKhst-hZwsaIEhqxx4mmo1bZI,157
 nlbone/interfaces/api/middleware/access_log.py,sha256=dEjk_m4fyQ72S2xLzDydDoaw2F9Tvmfl_acat1YThE0,972
 nlbone/interfaces/api/middleware/add_request_context.py,sha256=i8EV4BvZyrBcNfU-uTkybr7J7ypYvJq8mXSntM6oel4,1816
 nlbone/interfaces/api/middleware/authentication.py,sha256=-jfV-Ry04qsFd1cJh7KGoGpfnUKIogPF2fK42ZTFgBk,1806
-nlbone/interfaces/api/pagination/__init__.py,sha256=fdTqy5efdYIcUWbK1mVPQMieGd3HV1lZ8vmIhhsuUKs,58
-nlbone/interfaces/api/pagination/offset_base.py,sha256=W0SJ0rHLMIqoyiPEAjnoKqY57LBXEyT5J-_5bS8r-NY,4535
+nlbone/interfaces/api/pagination/__init__.py,sha256=dduTd8cOUnKOipqpbsi5gANXKsD3uUttdzu4S5ObS_U,203
+nlbone/interfaces/api/pagination/offset_base.py,sha256=2MINXX4wXoynOTPgn28lp_UQufBUluLh_qjF-5AYFxk,3655
 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
@@ -62,7 +63,7 @@ nlbone/interfaces/jobs/sync_tokens.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJW
 nlbone/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nlbone/utils/context.py,sha256=AUiN1jM0ebNMopZQoJSqWTfUHuVrp-HV8x6g7QsbEJ8,1601
 nlbone/utils/time.py,sha256=dC0ucyAmHdNf3wpA_JPinl2VJRubWqx2vcRpJsT3-0k,102
-nlbone-0.1.37.dist-info/METADATA,sha256=X4wipUdAO0zS_LfafPT1U3HGmJ8dlxkgLX-iyH-y7Mg,2299
-nlbone-0.1.37.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-nlbone-0.1.37.dist-info/licenses/LICENSE,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-nlbone-0.1.37.dist-info/RECORD,,
+nlbone-0.2.0.dist-info/METADATA,sha256=VVTESRwO-HZwMfXeb_EszCLS52Jv7y-zXWC54Wtmt8w,2298
+nlbone-0.2.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+nlbone-0.2.0.dist-info/licenses/LICENSE,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nlbone-0.2.0.dist-info/RECORD,,