unique_toolkit 1.16.1__py3-none-any.whl → 1.16.2__py3-none-any.whl

unique_toolkit/_common/api_calling/human_verification_manager.py

@@ -280,9 +280,9 @@ if __name__ == "__main__":
     class CombinedParams(GetUserPathParams, GetUserRequestBody):
         pass
 
-    UserEndpoint = build_api_operation(
+    UserApiOperation = build_api_operation(
         method=EndpointMethods.GET,
-        url_template=Template("https://api.example.com/users/{user_id}"),
+        path_template=Template("/users/{user_id}"),
         path_params_constructor=GetUserPathParams,
         payload_constructor=GetUserRequestBody,
         response_model_type=UserResponse,
@@ -290,7 +290,7 @@ if __name__ == "__main__":
 
     human_verification_manager = HumanVerificationManagerForApiCalling(
         logger=logging.getLogger(__name__),
-        operation=UserEndpoint,
+        operation=UserApiOperation,
         requestor_type=RequestorType.FAKE,
         return_value={"id": 100, "name": "John Doe"},
     )

unique_toolkit/_common/endpoint_builder.py

@@ -4,7 +4,7 @@ the endpoints without having to know the details of the endpoints.
 """
 
 from enum import StrEnum
-from string import Formatter, Template
+from string import Template
 from typing import (
     Any,
     Callable,
@@ -16,7 +16,6 @@ from typing import (
 )
 
 from pydantic import BaseModel
-from typing_extensions import deprecated
 
 # Paramspecs
 PayloadParamSpec = ParamSpec("PayloadParamSpec")
@@ -67,13 +66,12 @@ class ApiOperationProtocol(
     def response_model() -> type[ResponseType]: ...
 
     @staticmethod
-    def create_url(
+    def create_path(
         *args: PathParamsSpec.args, **kwargs: PathParamsSpec.kwargs
     ) -> str: ...
 
     @staticmethod
-    def create_url_from_model(path_params: PathParamsType) -> str: ...
-
+    def create_path_from_model(path_params: PathParamsType) -> str: ...
     @staticmethod
     def create_payload(
         *args: PayloadParamSpec.args, **kwargs: PayloadParamSpec.kwargs
@@ -98,7 +96,7 @@ class ApiOperationProtocol(
 def build_api_operation(
     *,
     method: HttpMethods,
-    url_template: Template,
+    path_template: Template,
     path_params_constructor: Callable[PathParamsSpec, PathParamsType],
     payload_constructor: Callable[PayloadParamSpec, PayloadType],
     response_model_type: type[ResponseType],
@@ -143,33 +141,19 @@ def build_api_operation(
             return response_model_type
 
         @staticmethod
-        def create_url(
-            *args: PathParamsSpec.args,
-            **kwargs: PathParamsSpec.kwargs,
-        ) -> str:
-            """Create URL from path parameters."""
-            path_model = Operation.path_params_model()(*args, **kwargs)
-            path_dict = path_model.model_dump(**dump_options)
-
-            # Extract expected path parameters from template
-            template_params = [
-                fname
-                for _, fname, _, _ in Formatter().parse(url_template.template)
-                if fname is not None
-            ]
-
-            # Verify all required path parameters are present
-            missing_params = [
-                param for param in template_params if param not in path_dict
-            ]
-            if missing_params:
-                raise ValueError(f"Missing path parameters: {missing_params}")
-
-            return url_template.substitute(**path_dict)
+        def path_template() -> Template:
+            return path_template
 
         @staticmethod
-        def create_url_from_model(path_params: PathParamsType) -> str:
-            return url_template.substitute(**path_params.model_dump(**dump_options))
+        def create_path_from_model(path_params: PathParamsType) -> str:
+            return path_template.substitute(**path_params.model_dump(**dump_options))
+
+        @staticmethod
+        def create_path(
+            *args: PathParamsSpec.args, **kwargs: PathParamsSpec.kwargs
+        ) -> str:
+            model = Operation.path_params_model()(*args, **kwargs)
+            return Operation.create_path_from_model(model)
 
         @staticmethod
         def create_payload(
@@ -204,81 +188,3 @@ def build_api_operation(
             return path_params, payload
 
     return Operation
-
-
-@deprecated("Use ApiOperationProtocol instead")
-class EndpointClassProtocol(ApiOperationProtocol):
-    pass
-
-
-@deprecated("Use build_api_operation instead")
-def build_endpoint_class(
-    *,
-    method: HttpMethods,
-    url_template: Template,
-    path_params_constructor: Callable[PathParamsSpec, PathParamsType],
-    payload_constructor: Callable[PayloadParamSpec, PayloadType],
-    response_model_type: type[ResponseType],
-    dump_options: dict | None = None,
-) -> type[
-    ApiOperationProtocol[
-        PathParamsSpec,
-        PathParamsType,
-        PayloadParamSpec,
-        PayloadType,
-        ResponseType,
-    ]
-]:
-    return build_api_operation(
-        method=method,
-        url_template=url_template,
-        path_params_constructor=path_params_constructor,
-        payload_constructor=payload_constructor,
-        response_model_type=response_model_type,
-        dump_options=dump_options,
-    )
-
-
-if __name__ == "__main__":
-    # Example models
-    class GetUserPathParams(BaseModel):
-        """Path parameters for the user endpoint."""
-
-        user_id: int
-
-    class GetUserRequestBody(BaseModel):
-        """Request body/query parameters for the user endpoint."""
-
-        include_profile: bool = False
-
-    class UserResponse(BaseModel):
-        """Response model for user data."""
-
-        id: int
-        name: str
-
-    # Example usage of make_endpoint_class
-    UserOperation = build_endpoint_class(
-        url_template=Template("/users/${user_id}"),
-        path_params_constructor=GetUserPathParams,
-        payload_constructor=GetUserRequestBody,
-        response_model_type=UserResponse,
-        method=EndpointMethods.GET,
-    )
-
-    # Create URL from path parameters
-    url = UserOperation.create_url(user_id=123)
-    print(f"URL: {url}")
-
-    # Create payload from request body parameters
-    payload = UserOperation.create_payload(include_profile=True)
-    print(f"Payload: {payload}")
-
-    # Create response from endpoint
-    response = UserOperation.handle_response(
-        {
-            "id": 123,
-            "name": "John Doe",
-        }
-    )
-    print(f"Response: {response}")

unique_toolkit/_common/endpoint_requestor.py

@@ -2,7 +2,7 @@ from enum import StrEnum
 from typing import Any, Callable, Generic, Protocol, TypeVar
 from urllib.parse import urljoin, urlparse
 
-from pydantic import BaseModel
+from pydantic import BaseModel, Field
 from typing_extensions import ParamSpec
 
 from unique_toolkit._common.endpoint_builder import (
@@ -25,25 +25,15 @@ CombinedParamsType = TypeVar("CombinedParamsType", bound=BaseModel)
 ResponseT_co = TypeVar("ResponseT_co", bound=BaseModel, covariant=True)
 
 
-def _construct_full_url(base_url: str, url: str) -> str:
-    """
-    Construct full URL from base_url and url.
-    If base_url is provided and url is absolute, strip the scheme/netloc from url.
-    """
-    if not base_url:
-        return url
-
-    parsed = urlparse(url)
-    if parsed.scheme:
-        # URL is absolute, extract only path + query + fragment
-        url = parsed._replace(scheme="", netloc="").geturl()
+class RequestContext(BaseModel):
+    base_url: str
+    headers: dict[str, str] = Field(default_factory=dict)
 
-    return urljoin(base_url, url)
 
-
-class RequestContext(BaseModel):
-    base_url: str = ""
-    headers: dict[str, str] | None = None
+def _verify_url(url: str) -> None:
+    parse_result = urlparse(url)
+    if not (parse_result.netloc and parse_result.scheme):
+        raise ValueError("Scheme and netloc are required for url")
 
 
 class EndpointRequestorProtocol(Protocol, Generic[CombinedParamsSpec, ResponseT_co]):
@@ -142,12 +132,15 @@ def build_request_requestor(
                 combined=kwargs
             )
 
-            url = cls._operation.create_url_from_model(path_params)
+            path = cls._operation.create_path_from_model(path_params)
+            url = urljoin(context.base_url, path)
+            _verify_url(url)
+
             payload = cls._operation.create_payload_from_model(payload_model)
 
             response = requests.request(
                 method=cls._operation.request_method(),
-                url=_construct_full_url(context.base_url, url),
+                url=url,
                 headers=context.headers,
                 json=payload,
             )
@@ -198,13 +191,13 @@ def build_httpx_requestor(
                 combined=kwargs
             )
 
+            path = cls._operation.create_path_from_model(path_params)
+            url = urljoin(context.base_url, path)
+            _verify_url(url)
             with httpx.Client() as client:
                 response = client.request(
                     method=cls._operation.request_method(),
-                    url=_construct_full_url(
-                        base_url=context.base_url,
-                        url=cls._operation.create_url_from_model(path_params),
-                    ),
+                    url=url,
                     headers=headers,
                     json=cls._operation.create_payload_from_model(payload_model),
                 )
@@ -223,13 +216,13 @@ def build_httpx_requestor(
                 combined=kwargs
             )
 
+            path = cls._operation.create_path_from_model(path_params)
+            url = urljoin(context.base_url, path)
+            _verify_url(url)
             async with httpx.AsyncClient() as client:
                 response = await client.request(
                     method=cls._operation.request_method(),
-                    url=_construct_full_url(
-                        base_url=context.base_url,
-                        url=cls._operation.create_url_from_model(path_params),
-                    ),
+                    url=url,
                     headers=headers,
                     json=cls._operation.create_payload_from_model(payload_model),
                 )
@@ -279,14 +272,14 @@ def build_aiohttp_requestor(
             path_params, payload_model = cls._operation.models_from_combined(
                 combined=kwargs
             )
+            path = cls._operation.create_path_from_model(path_params)
+            url = urljoin(context.base_url, path)
+            _verify_url(url)
 
             async with aiohttp.ClientSession() as session:
                 response = await session.request(
                     method=cls._operation.request_method(),
-                    url=_construct_full_url(
-                        base_url=context.base_url,
-                        url=cls._operation.create_url_from_model(path_params),
-                    ),
+                    url=url,
                     headers=headers,
                     json=cls._operation.create_payload_from_model(payload_model),
                 )
@@ -360,7 +353,7 @@ if __name__ == "__main__":
 
     UserEndpoint = build_api_operation(
         method=HttpMethods.GET,
-        url_template=Template("https://api.example.com/users/{user_id}"),
+        path_template=Template("/users/{user_id}"),
         path_params_constructor=GetUserPathParams,
         payload_constructor=GetUserRequestBody,
         response_model_type=UserResponse,

{unique_toolkit-1.16.1.dist-info → unique_toolkit-1.16.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: unique_toolkit
-Version: 1.16.1
+Version: 1.16.2
 Summary: 
 License: Proprietary
 Author: Cedric Klinkert
@@ -117,6 +117,8 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), 
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+## [1.16.2] - 2025-10-16
+- Reduce operation dependency on path instead of full url
 
 ## [1.16.1] - 2025-10-16
 - Update debug info for better tool call tracking

{unique_toolkit-1.16.1.dist-info → unique_toolkit-1.16.2.dist-info}/RECORD

@@ -1,7 +1,7 @@
 unique_toolkit/__init__.py,sha256=qrQ0kgAZnmGR6-UpWOpAL4yd-2ic5Jjwh6s8et-7ZTc,1372
 unique_toolkit/_common/_base_service.py,sha256=S8H0rAebx7GsOldA7xInLp3aQJt9yEPDQdsGSFRJsGg,276
 unique_toolkit/_common/_time_utils.py,sha256=ztmTovTvr-3w71Ns2VwXC65OKUUh-sQlzbHdKTQWm-w,135
-unique_toolkit/_common/api_calling/human_verification_manager.py,sha256=ZgWThDHdTNFmgNdE4dwR7L7qPV73nSe5wOLpcB1QbWM,11919
+unique_toolkit/_common/api_calling/human_verification_manager.py,sha256=AeGzaGYlo8RHwEp7jhWM7gdx32dRyLUIioZRfrVbgUI,11905
 unique_toolkit/_common/base_model_type_attribute.py,sha256=7rzVqjXa0deYEixeo_pJSJcQ7nKXpWK_UGpOiEH3yZY,10382
 unique_toolkit/_common/chunk_relevancy_sorter/config.py,sha256=tHETuMIC4CA_TPwU0oaHbckaKhvMFMYdO_d4lNRKnRc,1806
 unique_toolkit/_common/chunk_relevancy_sorter/exception.py,sha256=1mY4zjbvnXsd5oIxwiVsma09bS2XRnHrxW8KJBGtgCM,126
@@ -9,8 +9,8 @@ unique_toolkit/_common/chunk_relevancy_sorter/schemas.py,sha256=YAyvXzVk8h5q6FEs
 unique_toolkit/_common/chunk_relevancy_sorter/service.py,sha256=ZX1pxcy53zh3Ha0_pN6yYIbMX1acRxcvqKTPTKpGKwA,13938
 unique_toolkit/_common/chunk_relevancy_sorter/tests/test_service.py,sha256=giD9b5W8A0xP18dZCcrLUruoGi38BeBvPnO1phY7Sp0,8892
 unique_toolkit/_common/default_language_model.py,sha256=XCZu6n270QkxEeTpj5NZJda6Ok_IR-GcS8w30DU21aI,343
-unique_toolkit/_common/endpoint_builder.py,sha256=WzJrJ7azUQhvQRd-vsFFoyj6omJpHiVYrh1UFxNQvVg,8242
-unique_toolkit/_common/endpoint_requestor.py,sha256=7rDpeEvmQbLtn3iNW8NftyvAqDkLFGHoYN1h5AFDxho,12319
+unique_toolkit/_common/endpoint_builder.py,sha256=09Y8rC83oNsmxBLAf7WiHqK_OjZmeKb82TPzF0SLSVM,5499
+unique_toolkit/_common/endpoint_requestor.py,sha256=3B7ekfiTmgCEc2h1_m94DsfPwigE2yfiFUmbAAdjuVc,12039
 unique_toolkit/_common/exception.py,sha256=hwh60UUawHDyPFNs-Wom-Gc6Yb09gPelftAuW1tXE6o,779
 unique_toolkit/_common/feature_flags/schema.py,sha256=F1NdVJFNU8PKlS7bYzrIPeDu2LxRqHSM9pyw622a1Kk,547
 unique_toolkit/_common/pydantic/rjsf_tags.py,sha256=T3AZIF8wny3fFov66s258nEl1GqfKevFouTtG6k9PqU,31219
@@ -165,7 +165,7 @@ unique_toolkit/short_term_memory/service.py,sha256=5PeVBu1ZCAfyDb2HLVvlmqSbyzBBu
 unique_toolkit/smart_rules/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 unique_toolkit/smart_rules/compile.py,sha256=Ozhh70qCn2yOzRWr9d8WmJeTo7AQurwd3tStgBMPFLA,1246
 unique_toolkit/test_utilities/events.py,sha256=_mwV2bs5iLjxS1ynDCjaIq-gjjKhXYCK-iy3dRfvO3g,6410
-unique_toolkit-1.16.1.dist-info/LICENSE,sha256=GlN8wHNdh53xwOPg44URnwag6TEolCjoq3YD_KrWgss,193
-unique_toolkit-1.16.1.dist-info/METADATA,sha256=bgeCiumOrLKNtqV3xQoDz7Yktvb0z_W8EJnv6pTUVc4,37517
-unique_toolkit-1.16.1.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-unique_toolkit-1.16.1.dist-info/RECORD,,
+unique_toolkit-1.16.2.dist-info/LICENSE,sha256=GlN8wHNdh53xwOPg44URnwag6TEolCjoq3YD_KrWgss,193
+unique_toolkit-1.16.2.dist-info/METADATA,sha256=x7WrizUo_LYUUzuW5XwaOATe89GBQpT0v2_KQUlAXAo,37600
+unique_toolkit-1.16.2.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+unique_toolkit-1.16.2.dist-info/RECORD,,