tigrbl_client 0.2.2.dev27__tar.gz → 0.2.12.dev1__tar.gz

tigrbl_client-0.2.12.dev1/PKG-INFO

@@ -0,0 +1,49 @@
+Metadata-Version: 2.4
+Name: tigrbl_client
+Version: 0.2.12.dev1
+Summary: A client for Tigrbl servers by Swarmauri.
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: tigrbl,sdk,standards,client
+Author: Jacob Stewart
+Author-email: jacob@swarmauri.com
+Requires-Python: >=3.10,<3.14
+Classifier: Development Status :: 3 - Alpha
+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: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Dist: fastapi (>=0.100.0)
+Requires-Dist: pydantic (>=2.0.0)
+Requires-Dist: swarmauri_base
+Requires-Dist: swarmauri_core
+Requires-Dist: swarmauri_standard
+Description-Content-Type: text/markdown
+
+# tigrbl_client
+
+This file is a package-local distribution entry point.
+It is not the authoritative location for repository governance, current target status, current state reporting, certification claims, or release evidence.
+
+## Canonical repository docs
+
+- `README.md`
+- `docs/README.md`
+- `docs/conformance/CURRENT_TARGET.md`
+- `docs/conformance/CURRENT_STATE.md`
+- `docs/conformance/NEXT_STEPS.md`
+- `docs/governance/DOC_POINTERS.md`
+- `docs/developer/PACKAGE_CATALOG.md`
+- `docs/developer/PACKAGE_LAYOUT.md`
+
+## Package identity
+
+- workspace path: `pkgs/core/tigrbl_client`
+- workspace class: core Python package
+- implementation layout: `tigrbl_client/`
+
+Long-form repository documentation is governed from `docs/`.
+

tigrbl_client-0.2.12.dev1/README.md

@@ -0,0 +1,23 @@
+# tigrbl_client
+
+This file is a package-local distribution entry point.
+It is not the authoritative location for repository governance, current target status, current state reporting, certification claims, or release evidence.
+
+## Canonical repository docs
+
+- `README.md`
+- `docs/README.md`
+- `docs/conformance/CURRENT_TARGET.md`
+- `docs/conformance/CURRENT_STATE.md`
+- `docs/conformance/NEXT_STEPS.md`
+- `docs/governance/DOC_POINTERS.md`
+- `docs/developer/PACKAGE_CATALOG.md`
+- `docs/developer/PACKAGE_LAYOUT.md`
+
+## Package identity
+
+- workspace path: `pkgs/core/tigrbl_client`
+- workspace class: core Python package
+- implementation layout: `tigrbl_client/`
+
+Long-form repository documentation is governed from `docs/`.

{tigrbl_client-0.2.2.dev27 → tigrbl_client-0.2.12.dev1}/pyproject.toml

@@ -1,17 +1,17 @@
 [project]
 name = "tigrbl_client"
-version = "0.2.2.dev27"
+version = "0.2.12.dev1"
 description = "A client for Tigrbl servers by Swarmauri."
 license = "Apache-2.0"
 readme = "README.md"
 repository = "http://github.com/swarmauri/swarmauri-sdk"
-requires-python = ">=3.10,<3.13"
+requires-python = ">=3.10,<3.14"
 classifiers = [
-    "License :: OSI Approved :: Apache Software License",
     "Development Status :: 3 - Alpha",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
@@ -31,11 +31,6 @@ keywords = [
     'client',
 ]
 
-[tool.uv.sources]
-swarmauri_core = { workspace = true }
-swarmauri_base = { workspace = true }
-swarmauri_standard = { workspace = true }
-
 [tool.pytest.ini_options]
 norecursedirs = ["combined", "scripts"]
 markers = [
@@ -72,4 +67,4 @@ dev = [
     "pytest-timeout>=2.3.1",
     "ruff>=0.9.9",
     "pytest-benchmark>=4.0.0",
-]
+]

{tigrbl_client-0.2.2.dev27 → tigrbl_client-0.2.12.dev1}/tigrbl_client/__init__.py

@@ -12,7 +12,7 @@ T = TypeVar("T")
 
 
 # Re-export the Schema protocol for public use
-__all__ = ["TigrblClient", "_Schema"]
+__all__ = ["TigrblClient", "NestedCRUDMixin", "_Schema"]
 
 
 class TigrblClient(RPCMixin, CRUDMixin, NestedCRUDMixin):
@@ -25,7 +25,7 @@ class TigrblClient(RPCMixin, CRUDMixin, NestedCRUDMixin):
     * Async versions of all operations (aget, apost, aput, apatch, adelete)
     * Connection pooling via httpx.Client
     * Optional Pydantic schema validation for requests and responses
-    * Placeholder for future nested CRUD operations
+    * Nested REST helpers for hierarchical resources
     * Works with Tigrbl services that expose operations via resource-based
       namespaces (e.g., ``api.core.Users.create`` or ``api.rpc.Users.login``)
 
@@ -72,7 +72,7 @@ class TigrblClient(RPCMixin, CRUDMixin, NestedCRUDMixin):
         self._async_client = httpx.AsyncClient(timeout=10.0)
         self._own_async = True  # we always own the async client
 
-        # Initialize nested CRUD placeholder
+        # Enable nested resource helpers.
         NestedCRUDMixin.__init__(self)
 
     @property

tigrbl_client-0.2.12.dev1/tigrbl_client/_nested_crud.py

@@ -0,0 +1,87 @@
+# tigrbl_client/_nested_crud.py
+from __future__ import annotations
+
+from typing import Any, Iterable, TypeVar
+
+T = TypeVar("T")
+
+
+class NestedCRUDMixin:
+    """Helpers for hierarchical REST resource paths."""
+
+    def __init__(self) -> None:
+        self._nested_crud_enabled = True
+
+    @staticmethod
+    def _normalize_segment(value: Any) -> str:
+        raw = str(value).strip("/")
+        if not raw:
+            raise ValueError("Nested resource segments must be non-empty")
+        return raw
+
+    def nested_path(self, *segments: Any) -> str:
+        """Build a normalized nested resource path.
+
+        Examples:
+            ``nested_path("users", 1, "posts", 2) -> "/users/1/posts/2"``
+        """
+
+        if not segments:
+            raise ValueError("At least one nested segment is required")
+        normalized = [self._normalize_segment(segment) for segment in segments]
+        return "/" + "/".join(normalized)
+
+    def nested_collection_path(
+        self,
+        *parents: Any,
+        resource: str,
+    ) -> str:
+        """Build a nested collection path under one or more parent pairs."""
+
+        parent_segments = tuple(parents)
+        if len(parent_segments) % 2 != 0:
+            raise ValueError("parents must be resource/id pairs")
+        return self.nested_path(*parent_segments, resource)
+
+    def nested_member_path(
+        self,
+        *parents: Any,
+        resource: str,
+        item_id: Any,
+    ) -> str:
+        """Build a nested member path under one or more parent pairs."""
+
+        return self.nested_path(*parents, resource, item_id)
+
+    def nested_get(self, *segments: Any, **kwargs: Any) -> Any:
+        return self.get(self.nested_path(*segments), **kwargs)
+
+    def nested_post(self, *segments: Any, **kwargs: Any) -> Any:
+        return self.post(self.nested_path(*segments), **kwargs)
+
+    def nested_put(self, *segments: Any, **kwargs: Any) -> Any:
+        return self.put(self.nested_path(*segments), **kwargs)
+
+    def nested_patch(self, *segments: Any, **kwargs: Any) -> Any:
+        return self.patch(self.nested_path(*segments), **kwargs)
+
+    def nested_delete(self, *segments: Any, **kwargs: Any) -> Any:
+        return self.delete(self.nested_path(*segments), **kwargs)
+
+    async def anested_get(self, *segments: Any, **kwargs: Any) -> Any:
+        return await self.aget(self.nested_path(*segments), **kwargs)
+
+    async def anested_post(self, *segments: Any, **kwargs: Any) -> Any:
+        return await self.apost(self.nested_path(*segments), **kwargs)
+
+    async def anested_put(self, *segments: Any, **kwargs: Any) -> Any:
+        return await self.aput(self.nested_path(*segments), **kwargs)
+
+    async def anested_patch(self, *segments: Any, **kwargs: Any) -> Any:
+        return await self.apatch(self.nested_path(*segments), **kwargs)
+
+    async def anested_delete(self, *segments: Any, **kwargs: Any) -> Any:
+        return await self.adelete(self.nested_path(*segments), **kwargs)
+
+
+__all__ = ["NestedCRUDMixin"]

tigrbl_client-0.2.2.dev27/PKG-INFO

@@ -1,80 +0,0 @@
-Metadata-Version: 2.4
-Name: tigrbl_client
-Version: 0.2.2.dev27
-Summary: A client for Tigrbl servers by Swarmauri.
-License-Expression: Apache-2.0
-License-File: LICENSE
-Keywords: tigrbl,sdk,standards,client
-Author: Jacob Stewart
-Author-email: jacob@swarmauri.com
-Requires-Python: >=3.10,<3.13
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Development Status :: 3 - Alpha
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Requires-Dist: fastapi (>=0.100.0)
-Requires-Dist: pydantic (>=2.0.0)
-Requires-Dist: swarmauri_base
-Requires-Dist: swarmauri_core
-Requires-Dist: swarmauri_standard
-Description-Content-Type: text/markdown
-
-![Tigrbl Logo](https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/tigrbl_full_logo.png)
-
-<p align="center">
-    <a href="https://pypi.org/project/tigrbl_client/">
-        <img src="https://img.shields.io/pypi/v/tigrbl_client?label=tigrbl_client&color=green" alt="PyPI - tigrbl_client"/>
-    </a>
-    <a href="https://pypi.org/project/tigrbl_client/">
-        <img src="https://img.shields.io/pypi/dm/tigrbl_client" alt="PyPI - Downloads"/>
-    </a>
-    <a href="https://pypi.org/project/tigrbl_client/">
-        <img src="https://img.shields.io/pypi/pyversions/tigrbl_client" alt="PyPI - Python Version"/>
-    </a>
-    <a href="https://pypi.org/project/tigrbl_client/">
-        <img src="https://img.shields.io/pypi/l/tigrbl_client" alt="PyPI - License"/>
-    </a>
-    <a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/tigrbl_client/">
-        <img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/tigrbl_client.svg"/>
-    </a>
-</p>
-
----
-
-# Tigrbl Client 🐅
-
-A lightweight HTTP client for interacting with Tigrbl services.
-Tigrbl exposes operations under resource-based namespaces such as
-`api.core.Users.create` or `api.rpc.Users.login`, all accessible via
-this client.
-
-## Features ✨
-
-- Minimal dependencies with friendly typing
-- Automatic JSON serialization / deserialization
-- Simple namespace-based method access
-
-## Installation 📦
-
-```bash
-pip install tigrbl_client
-```
-
-## Quick Start 🚀
-
-```python
-from tigrbl_client import Client
-
-client = Client("https://api.tigrbl.io", token="your-token")
-response = client.api.core.Users.read(id=1)
-print(response)
-```
-
-## License 📝
-
-This project is licensed under the terms of the [MIT license](LICENSE).
-

tigrbl_client-0.2.2.dev27/README.md

@@ -1,54 +0,0 @@
-![Tigrbl Logo](https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/tigrbl_full_logo.png)
-
-<p align="center">
-    <a href="https://pypi.org/project/tigrbl_client/">
-        <img src="https://img.shields.io/pypi/v/tigrbl_client?label=tigrbl_client&color=green" alt="PyPI - tigrbl_client"/>
-    </a>
-    <a href="https://pypi.org/project/tigrbl_client/">
-        <img src="https://img.shields.io/pypi/dm/tigrbl_client" alt="PyPI - Downloads"/>
-    </a>
-    <a href="https://pypi.org/project/tigrbl_client/">
-        <img src="https://img.shields.io/pypi/pyversions/tigrbl_client" alt="PyPI - Python Version"/>
-    </a>
-    <a href="https://pypi.org/project/tigrbl_client/">
-        <img src="https://img.shields.io/pypi/l/tigrbl_client" alt="PyPI - License"/>
-    </a>
-    <a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/tigrbl_client/">
-        <img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/tigrbl_client.svg"/>
-    </a>
-</p>
-
----
-
-# Tigrbl Client 🐅
-
-A lightweight HTTP client for interacting with Tigrbl services.
-Tigrbl exposes operations under resource-based namespaces such as
-`api.core.Users.create` or `api.rpc.Users.login`, all accessible via
-this client.
-
-## Features ✨
-
-- Minimal dependencies with friendly typing
-- Automatic JSON serialization / deserialization
-- Simple namespace-based method access
-
-## Installation 📦
-
-```bash
-pip install tigrbl_client
-```
-
-## Quick Start 🚀
-
-```python
-from tigrbl_client import Client
-
-client = Client("https://api.tigrbl.io", token="your-token")
-response = client.api.core.Users.read(id=1)
-print(response)
-```
-
-## License 📝
-
-This project is licensed under the terms of the [MIT license](LICENSE).

tigrbl_client-0.2.2.dev27/tigrbl_client/_nested_crud.py

@@ -1,50 +0,0 @@
-# tigrbl_client/_nested_crud.py
-"""
-Placeholder module for nested CRUD operations.
-
-This module will be developed in the future to support nested resource paths
-and more complex CRUD operations with hierarchical data structures.
-
-Examples of future functionality:
-- /users/{user_id}/posts/{post_id}/comments
-- /organizations/{org_id}/teams/{team_id}/members
-- Complex resource relationships and nested operations
-"""
-
-from __future__ import annotations
-
-from typing import Any, TypeVar, Protocol
-from typing import runtime_checkable
-
-T = TypeVar("T")
-
-
-@runtime_checkable
-class _Schema(Protocol[T]):  # anything with Pydantic-v2 interface
-    @classmethod
-    def model_validate(cls, data: Any) -> T: ...
-    @classmethod
-    def model_dump_json(cls, **kw) -> str: ...
-
-
-class NestedCRUDMixin:
-    """
-    Placeholder mixin class for nested CRUD functionality.
-
-    This will be developed to support complex nested resource paths
-    and hierarchical data operations.
-    """
-
-    def __init__(self):
-        """Initialize the NestedCRUDMixin."""
-        # Placeholder for future initialization
-        pass
-
-    def _placeholder_method(self) -> str:
-        """
-        Placeholder method to demonstrate future functionality.
-
-        Returns:
-            A message indicating this is a placeholder
-        """
-        return "This is a placeholder for future nested CRUD functionality"