b1sl-python 0.1.0__py3-none-any.whl

b1sl/b1sl/resources/_generated/wizard_payment_methods.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+from typing import TYPE_CHECKING, Any
+from b1sl.b1sl.resources.base import GenericResource
+
+if TYPE_CHECKING:
+    from ...models._generated._types import *
+
+class WizardPaymentMethodsService(GenericResource["WizardPaymentMethod"]):
+    """This entity enables you to manipulate 'WizardPaymentMethods'. It defines various payment methods for various payment means (such as check, bank transfer, and in some localizations, bills of exchange) which can be used in payment wizard runs."""
+    endpoint = "WizardPaymentMethods"
+    
+    def __init__(self, adapter):
+        from ...models._generated._types import WizardPaymentMethod
+        self.model = WizardPaymentMethod
+        super().__init__(adapter)

b1sl/b1sl/resources/_generated/workflow_task_service.py

@@ -0,0 +1,47 @@
+from __future__ import annotations
+from typing import TYPE_CHECKING, Any
+from b1sl.b1sl.resources.base import GenericResource
+
+if TYPE_CHECKING:
+    from ...models._generated._types import *
+
+class WorkflowTaskService(GenericResource[Any]):
+    endpoint = "WorkflowTaskService"
+    
+    def __init__(self, adapter):
+        self.model = None
+        super().__init__(adapter)
+
+    # --- Actions ---
+
+    def complete(self, payload: dict | None = None) -> Any:
+        """POST WorkflowTaskService_Complete
+        Invoke the method 'Complete' on this service by specifying the payload 'WorkflowTaskCompleteParams' in the JSON format.
+
+        Example:
+        ```json
+        {
+            "WorkflowTaskCompleteParams": {
+                "Note": "Default Comment",
+                "TaskID": "4",
+                "TriggerParams": "<Params><Param><Key>Result</Key><Value Type="string">1</Value></Param></Params>"
+            }
+        }
+        ```
+        """
+        return self._adapter.post(f"WorkflowTaskService_Complete", data=payload)
+
+    def get_approval_task_list(self, payload: dict | None = None) -> Any:
+        """POST WorkflowTaskService_GetApprovalTaskList
+        Invoke the method 'GetApprovalTaskList' on this service by specifying the payload 'WorkflowApprovalTaskListParams' in the JSON format.
+
+        Example:
+        ```json
+        {
+            "WorkflowApprovalTaskListParams": {
+                "Status": "G|W"
+            }
+        }
+        ```
+        """
+        return self._adapter.post(f"WorkflowTaskService_GetApprovalTaskList", data=payload)

b1sl/b1sl/resources/async_base.py

@@ -0,0 +1,60 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Generic, TypeVar
+
+from b1sl.b1sl.models.base import B1Model
+from b1sl.b1sl.resources.base import ODataQuery, _build_expand
+
+if TYPE_CHECKING:
+    from b1sl.b1sl.async_rest_adapter import AsyncRestAdapter
+
+T = TypeVar("T", bound=B1Model)
+
+
+class AsyncGenericResource(Generic[T]):
+    """Version asíncrona de GenericResource para uso con AsyncRestAdapter."""
+
+    endpoint: str
+    model: type[T]
+
+    def __init__(self, adapter: AsyncRestAdapter) -> None:
+        self._adapter = adapter
+
+    async def list(self, query: ODataQuery | None = None) -> list[T]:
+        params = query.to_params() if query else {}
+        result = await self._adapter.get(f"{self.endpoint}", ep_params=params)
+        data = result.data or {}
+        return [self.model.model_validate(item) for item in data.get("value", [])]
+
+    async def get(
+        self,
+        key: Any,
+        select: list[str] | None = None,
+        expand: list[str] | dict[str, list[str]] | None = None,
+    ) -> T:
+        params: dict[str, str] = {}
+        if select:
+            params["$select"] = ",".join(str(f) for f in select)
+        if expand:
+            params["$expand"] = _build_expand(expand)
+
+        id_str = f"'{key}'" if isinstance(key, str) else str(key)
+        result = await self._adapter.get(f"{self.endpoint}({id_str})", ep_params=params)
+        return self.model.model_validate(result.data)
+
+    async def create(self, entity: T) -> T:
+        result = await self._adapter.post(
+            f"{self.endpoint}", data=entity.model_dump(exclude_none=True, by_alias=True)
+        )
+        return self.model.model_validate(result.data)
+
+    async def update(self, key: Any, entity: T) -> None:
+        id_str = f"'{key}'" if isinstance(key, str) else str(key)
+        await self._adapter.patch(
+            f"{self.endpoint}({id_str})",
+            data=entity.model_dump(exclude_none=True, by_alias=True),
+        )
+
+    async def delete(self, key: Any) -> None:
+        id_str = f"'{key}'" if isinstance(key, str) else str(key)
+        await self._adapter.delete(f"{self.endpoint}({id_str})")

b1sl/b1sl/resources/base.py

@@ -0,0 +1,159 @@
+"""
+b1sl.b1sl.resources.base
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Unified base classes for SAP B1 resources.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Any, Generic, TypeVar
+
+from b1sl.b1sl.adapter_protocol import RestAdapterProtocol
+from b1sl.b1sl.exceptions.exceptions import B1NotFoundError
+from b1sl.b1sl.models.base import B1Model
+
+T = TypeVar("T", bound=B1Model)
+
+
+def _build_expand(expand: list[str] | dict[str, list[str]] | None) -> str | None:
+    """
+    Normalise $expand parameter to OData string syntax.
+    Supports:
+    - list: ["A", "B"] -> "A,B"
+    - dict: {"Nav": ["F1", "F2"]} -> "Nav($select=F1,F2)"
+    - str: "Activities" -> "Activities" (if passed manually)
+    """
+    if not expand:
+        return None
+    if isinstance(expand, str):
+        return expand
+    if isinstance(expand, list):
+        return ",".join(str(f) for f in expand)
+
+    # dict: {"BusinessPartner": ["CardCode"]} -> "BusinessPartner($select=CardCode)"
+    parts = []
+    for nav, fields in expand.items():
+        nav_str = str(nav)  # StrEnum -> "BusinessPartner"
+        if fields:
+            sel = ",".join(str(f) for f in fields)
+            parts.append(f"{nav_str}($select={sel})")
+        else:
+            parts.append(nav_str)
+    return ",".join(parts)
+
+
+@dataclass
+class ODataQuery:
+    """Typed container for all SAP SL query options."""
+
+    filter: str | None = None
+    orderby: str | None = None
+    select: list[str] | None = None
+    skip: int | None = None
+    top: int | None = None
+    expand: list[str] | dict[str, list[str]] | None = None
+    count: bool = False  # $count=true inline
+
+    def to_params(self) -> dict[str, str]:
+        p: dict[str, str] = {}
+        if self.filter:
+            p["$filter"] = self.filter
+        if self.orderby:
+            p["$orderby"] = self.orderby
+        if self.select:
+            p["$select"] = ",".join(str(f) for f in self.select)
+        if self.skip is not None:
+            p["$skip"] = str(self.skip)
+        if self.top is not None:
+            p["$top"] = str(self.top)
+        if self.expand:
+            p["$expand"] = _build_expand(self.expand)
+        if self.count:
+            p["$count"] = "true"
+        return p
+
+
+class GenericResource(Generic[T]):
+    endpoint: str  # e.g. "BusinessPartners"
+    model: type[T]
+
+    def __init__(self, adapter: RestAdapterProtocol) -> None:
+        self._adapter = adapter
+
+    # ── Collection ───────────────────────────────────────────────────────────
+
+    def list(self, query: ODataQuery | None = None) -> list[T]:
+        params = query.to_params() if query else {}
+        # We assume the adapter returns a RestResponse with a .data dict
+        result = self._adapter.get(f"{self.endpoint}", ep_params=params)
+        data = result.data or {}
+        return [self.model.model_validate(item) for item in data.get("value", [])]
+
+    def count(self) -> int:
+        """GET Endpoint/$count"""
+        result = self._adapter.get(f"{self.endpoint}/$count")
+        return int(result.data)
+
+    # ── Single entity ─────────────────────────────────────────────────────────
+
+    def get(
+        self,
+        key: Any,
+        select: list[str] | None = None,
+        expand: list[str] | dict[str, list[str]] | None = None,
+    ) -> T:
+        params: dict[str, str] = {}
+        if select:
+            params["$select"] = ",".join(str(f) for f in select)
+        if expand:
+            params["$expand"] = _build_expand(expand)
+
+        id_str = f"'{key}'" if isinstance(key, str) else str(key)
+        result = self._adapter.get(f"{self.endpoint}({id_str})", ep_params=params)
+        return self.model.model_validate(result.data)
+
+    def exists(self, key: Any) -> bool:
+        """Check if an entity exists by attempting to fetch its minimal representation."""
+        id_str = f"'{key}'" if isinstance(key, str) else str(key)
+        try:
+            # We use a minimal $select to avoid fetching massive payloads
+            self._adapter.get(f"{self.endpoint}({id_str})", ep_params={"$select": "1"})
+            return True
+        except B1NotFoundError:
+            return False
+
+    # ── Mutations ─────────────────────────────────────────────────────────────
+
+    def create(self, entity: T) -> T:
+        result = self._adapter.post(
+            f"{self.endpoint}", data=entity.model_dump(exclude_none=True, by_alias=True)
+        )
+        return self.model.model_validate(result.data)
+
+    def update(self, key: Any, entity: T) -> None:
+        """PATCH — partial update, SAP SL returns 204 No Content."""
+        id_str = f"'{key}'" if isinstance(key, str) else str(key)
+        self._adapter.patch(
+            f"{self.endpoint}({id_str})",
+            data=entity.model_dump(exclude_none=True, by_alias=True),
+        )
+
+    def delete(self, key: Any) -> None:
+        id_str = f"'{key}'" if isinstance(key, str) else str(key)
+        self._adapter.delete(f"{self.endpoint}({id_str})")
+
+    # ── Actions / Functions ───────────────────────────────────────────────────
+
+    def _action(self, key: Any, name: str, payload: dict | None = None) -> Any:
+        """POST Endpoint(key)/ActionName"""
+        id_str = f"'{key}'" if isinstance(key, str) else str(key)
+        result = self._adapter.post(
+            f"{self.endpoint}({id_str})/{name}", data=payload or {}
+        )
+        return result.data if result else None
+
+    def _function(self, name: str, params: dict | None = None) -> Any:
+        """GET Endpoint/FunctionName(params)"""
+        result = self._adapter.get(f"{self.endpoint}/{name}", ep_params=params or {})
+        return result.data if result else None

b1sl/b1sl/resources/udo.py

@@ -0,0 +1,78 @@
+from __future__ import annotations
+
+from typing import TypeVar
+
+from b1sl.b1sl.models.base import B1Model
+from b1sl.b1sl.resources.async_base import AsyncGenericResource
+from b1sl.b1sl.resources.base import GenericResource, ODataQuery
+
+T = TypeVar("T", bound=B1Model)
+
+
+class UDOResource(GenericResource[B1Model]):
+    """
+    Dynamic resource for any SAP B1 UDO table or User Table.
+
+    Instantiate via ``B1Client.udo(table_name)``.
+    """
+
+    def __init__(self, adapter, *, table_name: str) -> None:
+        self.endpoint = table_name
+        self.model = B1Model
+        super().__init__(adapter)
+        self._table_name = table_name
+
+    def get(
+        self,
+        doc_entry: int,
+        *,
+        select: list[str] | None = None,
+    ) -> B1Model:
+        """Fetch a single UDO record by DocEntry."""
+        return super().get(doc_entry, select=select)
+
+    def list(
+        self,
+        query: ODataQuery | None = None,
+    ) -> list[B1Model]:
+        """Paginated list of UDO records."""
+        return super().list(query)
+
+    def create(self, data: B1Model) -> B1Model:
+        """POST a new UDO record. Returns the created record as a plain B1Model."""
+        return super().create(data)
+
+    def update(self, doc_entry: int, data: B1Model) -> None:
+        """PATCH a UDO record by DocEntry."""
+        super().update(doc_entry, data)
+
+    def delete(self, doc_entry: int) -> None:
+        """DELETE a UDO record by DocEntry."""
+        super().delete(doc_entry)
+
+
+class AsyncUDOResource(AsyncGenericResource[B1Model]):
+    """
+    Versión asíncrona de UDOResource.
+    """
+
+    def __init__(self, adapter, *, table_name: str) -> None:
+        self.endpoint = table_name
+        self.model = B1Model
+        super().__init__(adapter)
+        self._table_name = table_name
+
+    async def get(self, doc_entry: int, *, select: list[str] | None = None) -> B1Model:
+        return await super().get(doc_entry, select=select)
+
+    async def list(self, query: ODataQuery | None = None) -> list[B1Model]:
+        return await super().list(query)
+
+    async def create(self, data: B1Model) -> B1Model:
+        return await super().create(data)
+
+    async def update(self, doc_entry: int, data: B1Model) -> None:
+        await super().update(doc_entry, data)
+
+    async def delete(self, doc_entry: int) -> None:
+        await super().delete(doc_entry)