vtexpy 0.0.0b25__py3-none-any.whl → 0.0.0b27__py3-none-any.whl

vtex/_api/__init__.py

@@ -6,4 +6,5 @@ from .logistics import LogisticsAPI
 from .master_data import MasterDataAPI
 from .orders import OrdersAPI
 from .payments_gateway import PaymentsGatewayAPI
+from .pricing import PricingAPI
 from .promotions_and_taxes import PromotionsAndTaxesAPI

vtex/_api/base.py

@@ -1,7 +1,7 @@
 from http import HTTPStatus
 from json import JSONDecodeError
+from time import sleep
 from typing import Any, Type, Union, cast
-from urllib.parse import urljoin
 
 from httpx import (
     Client,
@@ -18,6 +18,7 @@ from httpx._types import (
     RequestData,
     RequestFiles,
 )
+from limits import RateLimitItem, storage, strategies
 from tenacity import (
     retry,
     retry_if_exception_type,
@@ -31,7 +32,7 @@ from .._dto import VTEXDataResponse, VTEXResponseType
 from .._exceptions import VTEXRequestError, VTEXResponseError
 from .._logging import disable_loggers, get_logger, log_before_retry
 from .._types import HTTPMethodType
-from .._utils import redact_headers, to_snake_case, to_snake_case_deep
+from .._utils import join_url, redact_headers, to_snake_case, to_snake_case_deep
 from .._vtex import VTEX
 
 
@@ -50,8 +51,8 @@ class BaseAPI:
     def _request(
         self,
         method: HTTPMethodType,
-        environment: str,
         endpoint: str,
+        environment: Union[str, None] = None,
         headers: Union[HeaderTypes, None] = None,
         cookies: Union[CookieTypes, None] = None,
         params: Union[QueryParamTypes, None] = None,
@@ -60,15 +61,23 @@ class BaseAPI:
         content: Union[RequestContent, None] = None,
         files: Union[RequestFiles, None] = None,
         config: Union[VTEXConfig, None] = None,
+        rate_limit: Union[RateLimitItem, None] = None,
         response_class: Union[Type[VTEXResponseType], None] = None,
         **kwargs: Any,
     ) -> VTEXResponseType:
         request_config = (config or self.client.config).with_overrides(**kwargs)
 
-        url = urljoin(
-            f"https://{request_config.account_name}.{environment}.com.br",
-            endpoint,
-        )
+        if environment:
+            url = join_url(
+                f"https://{request_config.account_name}.{environment}.com.br",
+                endpoint,
+            )
+        else:
+            url = join_url(
+                "https://api.vtex.com/",
+                request_config.account_name,
+                endpoint,
+            )
 
         headers = Headers(headers=headers)
         headers[APP_KEY_HEADER] = request_config.app_key.get_secret_value()
@@ -76,6 +85,14 @@ class BaseAPI:
         headers["Content-Type"] = "application/json; charset=utf-8"
         headers["Accept"] = "application/json"
 
+        rate_limiter = (
+            None
+            if not (rate_limit and request_config.rate_limit_storage_url)
+            else strategies.MovingWindowRateLimiter(
+                storage.storage_from_string(request_config.rate_limit_storage_url),
+            )
+        )
+
         @retry(
             stop=stop_after_attempt(
                 max_attempt_number=request_config.retry_attempts + 1,
@@ -102,17 +119,36 @@ class BaseAPI:
         def send_vtex_request() -> Response:
             with Client(timeout=request_config.timeout) as client:
                 with disable_loggers(["httpcore", "httpx"]):
-                    response = client.request(
-                        method.upper(),
-                        url,
-                        headers=headers,
-                        cookies=cookies,
-                        params=params,
-                        json=json,
-                        data=data,
-                        content=content,
-                        files=files,
-                    )
+                    while (
+                        rate_limiter
+                        and rate_limit
+                        and not rate_limiter.test(
+                            rate_limit,
+                            request_config.account_name,
+                            endpoint,
+                        )
+                    ):
+                        sleep(1)
+
+                    try:
+                        response = client.request(
+                            method.upper(),
+                            url,
+                            headers=headers,
+                            cookies=cookies,
+                            params=params,
+                            json=json,
+                            data=data,
+                            content=content,
+                            files=files,
+                        )
+                    finally:
+                        if rate_limiter and rate_limit:
+                            rate_limiter.hit(
+                                rate_limit,
+                                request_config.account_name,
+                                endpoint,
+                            )
 
                 response.request.headers = Headers(
                     redact_headers(dict(response.request.headers)),
@@ -183,7 +219,7 @@ class BaseAPI:
                 method=str(response.request.method).upper(),
                 url=str(response.request.url),
                 request_headers=response.request.headers,
-                status=response.status_code,
+                status_code=response.status_code,
                 data=data,
                 response_headers=response.headers,
             ) from None

vtex/_api/catalog.py

@@ -32,8 +32,8 @@ class CatalogAPI(BaseAPI):
     ) -> VTEXItemsResponse[List[Seller], Seller]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint="/api/catalog_system/pvt/seller/list",
+            environment=self.ENVIRONMENT,
             params=omitting_undefined({
                 "sc": sales_channel,
                 "sellerType": seller_type,
@@ -49,8 +49,8 @@ class CatalogAPI(BaseAPI):
     ) -> VTEXItemsResponse[List[SalesChannel], SalesChannel]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint="/api/catalog_system/pvt/saleschannel/list",
+            environment=self.ENVIRONMENT,
             config=self.client.config.with_overrides(**kwargs),
             response_class=VTEXItemsResponse[Any, Any],
         )
@@ -63,8 +63,8 @@ class CatalogAPI(BaseAPI):
     ) -> VTEXItemsResponse[List[int], int]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint="/api/catalog_system/pvt/sku/stockkeepingunitids",
+            environment=self.ENVIRONMENT,
             params={
                 "page": max(page, LIST_SKU_IDS_START_PAGE),
                 "pagesize": max(
@@ -83,8 +83,8 @@ class CatalogAPI(BaseAPI):
     ) -> VTEXDataResponse[Any]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint=f"/api/catalog_system/pvt/sku/stockkeepingunitbyid/{sku_id}",
+            environment=self.ENVIRONMENT,
             config=self.client.config.with_overrides(**kwargs),
             response_class=VTEXDataResponse[Any],
         )
@@ -97,8 +97,8 @@ class CatalogAPI(BaseAPI):
     ) -> VTEXPaginatedItemsResponse[Any, Any]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint="/api/catalog/pvt/category",
+            environment=self.ENVIRONMENT,
             params={
                 "page": max(page, LIST_CATEGORIES_START_PAGE),
                 "pagesize": max(
@@ -117,8 +117,8 @@ class CatalogAPI(BaseAPI):
     ) -> VTEXDataResponse[Any]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint=f"/api/catalog_system/pub/category/tree/{levels}",
+            environment=self.ENVIRONMENT,
             config=self.client.config.with_overrides(**kwargs),
             response_class=VTEXDataResponse[Any],
         )
@@ -130,8 +130,8 @@ class CatalogAPI(BaseAPI):
     ) -> VTEXDataResponse[Any]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint=f"/api/catalog/pvt/category/{category_id}",
+            environment=self.ENVIRONMENT,
             config=self.client.config.with_overrides(**kwargs),
             response_class=VTEXDataResponse[Any],
         )

vtex/_api/checkout.py

@@ -27,8 +27,8 @@ class CheckoutAPI(BaseAPI):
     ) -> VTEXDataResponse[Any]:
         return self._request(
             method="POST",
-            environment=self.ENVIRONMENT,
             endpoint="/api/checkout/pub/orderForms/simulation",
+            environment=self.ENVIRONMENT,
             params=omitting_undefined({
                 "RnbBehavior": rnb_behavior,
                 "sc": sales_channel,

vtex/_api/custom.py

@@ -28,8 +28,8 @@ class CustomAPI(BaseAPI):
     def request(
         self,
         method: HTTPMethodType,
-        environment: str,
         endpoint: str,
+        environment: Union[str, None] = None,
         headers: Union[HeaderTypes, None] = None,
         cookies: Union[CookieTypes, None] = None,
         params: Union[QueryParamTypes, None] = None,
@@ -42,8 +42,8 @@ class CustomAPI(BaseAPI):
     ) -> VTEXResponseType:
         return self._request(
             method=method,
-            environment=environment,
             endpoint=endpoint,
+            environment=environment,
             headers=headers,
             cookies=cookies,
             params=params,

vtex/_api/license_manager.py

@@ -27,8 +27,8 @@ class LicenseManagerAPI(BaseAPI):
     def get_account(self, **kwargs: Any) -> VTEXDataResponse[GetAccountData]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint="/api/vlm/account",
+            environment=self.ENVIRONMENT,
             config=self.client.config.with_overrides(**kwargs),
             response_class=VTEXDataResponse[GetAccountData],
         )
@@ -50,8 +50,8 @@ class LicenseManagerAPI(BaseAPI):
 
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint=f"/api/license-manager/users/{user_id}/roles",
+            environment=self.ENVIRONMENT,
             config=config,
             response_class=VTEXItemsResponse[List[UserRole], UserRole],
         )
@@ -66,8 +66,8 @@ class LicenseManagerAPI(BaseAPI):
     ) -> VTEXPaginatedItemsResponse[ListRolesData, Role]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint="/api/license-manager/site/pvt/roles/list/paged",
+            environment=self.ENVIRONMENT,
             params={
                 "sort": order_by_field,
                 "sortType": order_by_direction,

vtex/_api/logistics.py

@@ -29,8 +29,8 @@ class LogisticsAPI(BaseAPI):
     ) -> VTEXPaginatedItemsResponse[Any, Any]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint="/api/logistics/pvt/shipping-policies",
+            environment=self.ENVIRONMENT,
             params={
                 "page": max(page, LIST_SHIPPING_POLICIES_START_PAGE),
                 "perPage": max(
@@ -49,8 +49,8 @@ class LogisticsAPI(BaseAPI):
     ) -> VTEXDataResponse[Any]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint=f"/api/logistics/pvt/shipping-policies/{shipping_policy_id}",
+            environment=self.ENVIRONMENT,
             config=self.client.config.with_overrides(**kwargs),
             response_class=VTEXDataResponse[Any],
         )
@@ -63,8 +63,8 @@ class LogisticsAPI(BaseAPI):
     ) -> VTEXPaginatedItemsResponse[Any, Any]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint="/api/logistics/pvt/configuration/carriers",
+            environment=self.ENVIRONMENT,
             params={
                 "page": max(page, LIST_CARRIERS_START_PAGE),
                 "perPage": max(
@@ -83,8 +83,8 @@ class LogisticsAPI(BaseAPI):
     ) -> VTEXDataResponse[Any]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint=f"/api/logistics/pvt/configuration/carriers/{carrier_id}",
+            environment=self.ENVIRONMENT,
             config=self.client.config.with_overrides(**kwargs),
             response_class=VTEXDataResponse[Any],
         )
@@ -97,8 +97,8 @@ class LogisticsAPI(BaseAPI):
     ) -> VTEXPaginatedItemsResponse[Any, Any]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint="/api/logistics/pvt/configuration/docks",
+            environment=self.ENVIRONMENT,
             params={
                 "page": max(page, LIST_DOCKS_START_PAGE),
                 "perPage": max(
@@ -113,8 +113,8 @@ class LogisticsAPI(BaseAPI):
     def get_dock(self, dock_id: str, **kwargs: Any) -> VTEXDataResponse[Any]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint=f"/api/logistics/pvt/configuration/docks/{dock_id}",
+            environment=self.ENVIRONMENT,
             config=self.client.config.with_overrides(**kwargs),
             response_class=VTEXDataResponse[Any],
         )
@@ -127,11 +127,11 @@ class LogisticsAPI(BaseAPI):
     ) -> VTEXItemsResponse[Any, Any]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint=(
                 f"/api/logistics/pvt/configuration/freights/{carrier_id}/{zip_code}"
                 f"/values"
             ),
+            environment=self.ENVIRONMENT,
             config=self.client.config.with_overrides(**kwargs),
             response_class=VTEXItemsResponse[Any, Any],
         )
@@ -143,8 +143,8 @@ class LogisticsAPI(BaseAPI):
     ) -> VTEXDataResponse[Any]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint=f"/api/logistics/pvt/inventory/skus/{sku_id}",
+            environment=self.ENVIRONMENT,
             config=self.client.config.with_overrides(**kwargs),
             response_class=VTEXDataResponse[Any],
         )

vtex/_api/master_data.py

@@ -51,8 +51,8 @@ class MasterDataAPI(BaseAPI):
 
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint=f"/api/dataentities/{entity_name}/search",
+            environment=self.ENVIRONMENT,
             params=omitting_undefined(params),
             headers={
                 "REST-Range": f"resources={(page - 1) * page_size}-{page * page_size}",

vtex/_api/orders.py

@@ -1,6 +1,8 @@
 from datetime import datetime, timedelta, timezone
 from typing import Any, Dict, List, Union
 
+from limits import parse
+
 from .._constants import (
     LIST_FEED_ORDERS_MAX_PAGE_SIZE,
     LIST_ORDERS_MAX_PAGE,
@@ -82,10 +84,11 @@ class OrdersAPI(BaseAPI):
 
         response = self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint="/api/oms/pvt/orders/",
+            environment=self.ENVIRONMENT,
             params=params,
             config=self.client.config.with_overrides(**kwargs),
+            rate_limit=parse("80 per second"),
             response_class=VTEXPaginatedItemsResponse[Any, Any],
         )
 
@@ -98,8 +101,8 @@ class OrdersAPI(BaseAPI):
     def get_order(self, order_id: str, **kwargs: Any) -> VTEXDataResponse[Any]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint=f"/api/oms/pvt/orders/{order_id}",
+            environment=self.ENVIRONMENT,
             config=self.client.config.with_overrides(**kwargs),
             response_class=VTEXDataResponse[Any],
         )
@@ -111,8 +114,8 @@ class OrdersAPI(BaseAPI):
     ) -> VTEXItemsResponse[Any, Any]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint="/api/orders/feed/",
+            environment=self.ENVIRONMENT,
             params={
                 "maxlot": max(
                     min(page_size, LIST_FEED_ORDERS_MAX_PAGE_SIZE),
@@ -140,8 +143,8 @@ class OrdersAPI(BaseAPI):
 
         return self._request(
             method="POST",
-            environment=self.ENVIRONMENT,
             endpoint="/api/orders/feed/",
+            environment=self.ENVIRONMENT,
             json={"handles": handles},
             config=self.client.config.with_overrides(**kwargs),
             response_class=VTEXDataResponse[Any],

vtex/_api/payments_gateway.py

@@ -1,5 +1,7 @@
 from typing import Any
 
+from limits import parse
+
 from .._dto import VTEXDataResponse, VTEXItemsResponse
 from .base import BaseAPI
 
@@ -19,8 +21,8 @@ class PaymentsGatewayAPI(BaseAPI):
     ) -> VTEXDataResponse[Any]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint=f"/api/pvt/transactions/{transaction_id}",
+            environment=self.ENVIRONMENT,
             config=self.client.config.with_overrides(**kwargs),
             response_class=VTEXDataResponse[Any],
         )
@@ -32,9 +34,10 @@ class PaymentsGatewayAPI(BaseAPI):
     ) -> VTEXItemsResponse[Any, Any]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint=f"/api/pvt/transactions/{transaction_id}/interactions",
+            environment=self.ENVIRONMENT,
             config=self.client.config.with_overrides(**kwargs),
+            rate_limit=parse("60 per second"),
             response_class=VTEXItemsResponse[Any, Any],
         )
 
@@ -45,8 +48,8 @@ class PaymentsGatewayAPI(BaseAPI):
     ) -> VTEXItemsResponse[Any, Any]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint=f"/api/pvt/transactions/{transaction_id}/payments",
+            environment=self.ENVIRONMENT,
             config=self.client.config.with_overrides(**kwargs),
             response_class=VTEXItemsResponse[Any, Any],
         )
@@ -59,8 +62,8 @@ class PaymentsGatewayAPI(BaseAPI):
     ) -> VTEXDataResponse[Any]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint=f"/api/pvt/transactions/{transaction_id}/payments/{payment_id}",
+            environment=self.ENVIRONMENT,
             config=self.client.config.with_overrides(**kwargs),
             response_class=VTEXDataResponse[Any],
         )
@@ -72,8 +75,8 @@ class PaymentsGatewayAPI(BaseAPI):
     ) -> VTEXDataResponse[Any]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint=f"/api/pvt/transactions/{transaction_id}/capabilities",
+            environment=self.ENVIRONMENT,
             config=self.client.config.with_overrides(**kwargs),
             response_class=VTEXDataResponse[Any],
         )
@@ -85,8 +88,8 @@ class PaymentsGatewayAPI(BaseAPI):
     ) -> VTEXDataResponse[Any]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint=f"/api/pvt/transactions/{transaction_id}/cancellations",
+            environment=self.ENVIRONMENT,
             config=self.client.config.with_overrides(**kwargs),
             response_class=VTEXDataResponse[Any],
         )
@@ -98,8 +101,8 @@ class PaymentsGatewayAPI(BaseAPI):
     ) -> VTEXDataResponse[Any]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint=f"/api/pvt/transactions/{transaction_id}/refunds",
+            environment=self.ENVIRONMENT,
             config=self.client.config.with_overrides(**kwargs),
             response_class=VTEXDataResponse[Any],
         )
@@ -111,8 +114,8 @@ class PaymentsGatewayAPI(BaseAPI):
     ) -> VTEXDataResponse[Any]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint=f"/api/pvt/transactions/{transaction_id}/settlements",
+            environment=self.ENVIRONMENT,
             config=self.client.config.with_overrides(**kwargs),
             response_class=VTEXDataResponse[Any],
         )

vtex/_api/pricing.py

@@ -0,0 +1,19 @@
+from typing import Any
+
+from .._dto import VTEXDataResponse
+from .base import BaseAPI
+
+
+class PricingAPI(BaseAPI):
+    """
+    Client for the Pricing API.
+    https://developers.vtex.com/docs/api-reference/pricing-api
+    """
+
+    def get_price(self, sku_id: str, **kwargs: Any) -> VTEXDataResponse[Any]:
+        return self._request(
+            method="GET",
+            endpoint=f"/pricing/prices/{sku_id}",
+            config=self.client.config.with_overrides(**kwargs),
+            response_class=VTEXDataResponse[Any],
+        )

vtex/_api/promotions_and_taxes.py

@@ -18,8 +18,8 @@ class PromotionsAndTaxesAPI(BaseAPI):
     ) -> VTEXItemsResponse[Any, Any]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint="api/rnb/pvt/archive/benefits/calculatorconfiguration",
+            environment=self.ENVIRONMENT,
             config=self.client.config.with_overrides(**kwargs),
             response_class=VTEXItemsResponse[Any, Any],
         )
@@ -27,8 +27,8 @@ class PromotionsAndTaxesAPI(BaseAPI):
     def get_promotions(self, **kwargs: Any) -> VTEXDataResponse[Any]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint="api/rnb/pvt/benefits/calculatorconfiguration",
+            environment=self.ENVIRONMENT,
             config=self.client.config.with_overrides(**kwargs),
             response_class=VTEXDataResponse[Any],
         )
@@ -36,8 +36,8 @@ class PromotionsAndTaxesAPI(BaseAPI):
     def get_taxes(self, **kwargs: Any) -> VTEXDataResponse[Any]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint="api/rnb/pvt/taxes/calculatorconfiguration",
+            environment=self.ENVIRONMENT,
             config=self.client.config.with_overrides(**kwargs),
             response_class=VTEXDataResponse[Any],
         )
@@ -49,8 +49,8 @@ class PromotionsAndTaxesAPI(BaseAPI):
     ) -> VTEXDataResponse[Any]:
         return self._request(
             method="GET",
-            environment=self.ENVIRONMENT,
             endpoint=f"/api/rnb/pvt/calculatorconfiguration/{promotion_or_tax_id}",
+            environment=self.ENVIRONMENT,
             config=self.client.config.with_overrides(**kwargs),
             response_class=VTEXDataResponse[Any],
         )

vtex/_config.py

@@ -15,6 +15,7 @@ from ._constants import (
     DEFAULT_LOG_5XX,
     DEFAULT_LOG_RETRIES,
     DEFAULT_RAISE_FOR_STATUS_CODE,
+    DEFAULT_RATE_LIMIT_STORAGE_URL,
     DEFAULT_RETRY_ATTEMPTS,
     DEFAULT_RETRY_BACKOFF_MAX,
     DEFAULT_RETRY_BACKOFF_MIN,
@@ -27,6 +28,7 @@ from ._constants import (
     LOG_5XX_ENV_VAR,
     LOG_RETRIES_ENV_VAR,
     RAISE_FOR_STATUS_CODE_ENV_VAR,
+    RATE_LIMIT_STORAGE_URL_ENV_VAR,
     RETRY_ATTEMPTS_ENV_VAR,
     RETRY_BACKOFF_MAX_ENV_VAR,
     RETRY_BACKOFF_MIN_ENV_VAR,
@@ -55,6 +57,8 @@ class VTEXConfig(BaseModel):
 
     raise_for_status_code: bool = Field(UNDEFINED, validate_default=True)
 
+    rate_limit_storage_url: Union[str, None] = Field(UNDEFINED, validate_default=True)
+
     log_retries: FalseOrLogLevel = Field(UNDEFINED, validate_default=True)
     log_1xx: FalseOrLogLevel = Field(UNDEFINED, validate_default=True)
     log_2xx: FalseOrLogLevel = Field(UNDEFINED, validate_default=True)
@@ -73,6 +77,7 @@ class VTEXConfig(BaseModel):
         retry_backoff_max: Union[float, int, UndefinedSentinel] = UNDEFINED,
         retry_status_codes: Union[List[int], UndefinedSentinel] = UNDEFINED,
         raise_for_status_code: Union[bool, UndefinedSentinel] = UNDEFINED,
+        rate_limit_storage_url: Union[str, UndefinedSentinel] = UNDEFINED,
         log_retries: FalseOrLogLevelOrUndefined = UNDEFINED,
         log_1xx: FalseOrLogLevelOrUndefined = UNDEFINED,
         log_2xx: FalseOrLogLevelOrUndefined = UNDEFINED,
@@ -93,6 +98,7 @@ class VTEXConfig(BaseModel):
                     "retry_backoff_max": retry_backoff_max,
                     "retry_status_codes": retry_status_codes,
                     "raise_for_status_code": raise_for_status_code,
+                    "rate_limit_storage_url": rate_limit_storage_url,
                     "log_retries": log_retries,
                     "log_1xx": log_1xx,
                     "log_2xx": log_2xx,
@@ -218,6 +224,25 @@ class VTEXConfig(BaseModel):
 
         raise cls._prepare_value_error(value, RAISE_FOR_STATUS_CODE_ENV_VAR)
 
+    @field_validator("rate_limit_storage_url", mode="before")
+    @classmethod
+    def validate_rate_limit_storage_url(cls, value: Any) -> Union[str, None]:
+        if isinstance(value, UndefinedSentinel):
+            value = getenv(
+                RATE_LIMIT_STORAGE_URL_ENV_VAR,
+                DEFAULT_RATE_LIMIT_STORAGE_URL,
+            )
+
+        if value is None:
+            return None
+        elif isinstance(value, str):
+            if value.lower() in {"", "none", "null"}:
+                return None
+
+            return value
+
+        raise cls._prepare_value_error(value, RATE_LIMIT_STORAGE_URL_ENV_VAR)
+
     @field_validator("log_retries", mode="before")
     @classmethod
     def validate_log_retries(cls, value: Any) -> FalseOrLogLevel:

vtex/_constants.py

@@ -20,6 +20,7 @@ RETRY_BACKOFF_MIN_ENV_VAR = "VTEX_RETRY_BACKOFF_MIN"
 RETRY_BACKOFF_MAX_ENV_VAR = "VTEX_RETRY_BACKOFF_MAX"
 RETRY_STATUS_CODES_ENV_VAR = "VTEX_RETRY_STATUS_CODES"
 RAISE_FOR_STATUS_CODE_ENV_VAR = "VTEX_RAISE_FOR_STATUS_CODE"
+RATE_LIMIT_STORAGE_URL_ENV_VAR = "VTEX_RATE_LIMIT_STORAGE_URL"
 LOG_RETRIES_ENV_VAR = "VTEX_LOG_RETRIES"
 LOG_1XX_ENV_VAR = "VTEX_LOG_1XX"
 LOG_2XX_ENV_VAR = "VTEX_LOG_2XX"
@@ -46,6 +47,7 @@ DEFAULT_RETRY_STATUS_CODES = [
     525,
 ]
 DEFAULT_RAISE_FOR_STATUS_CODE = True
+DEFAULT_RATE_LIMIT_STORAGE_URL = None
 DEFAULT_LOG_RETRIES = WARNING
 DEFAULT_LOG_1XX = INFO
 DEFAULT_LOG_2XX = INFO

vtex/_utils.py

@@ -109,3 +109,7 @@ def redact_headers(headers: Mapping[str, str]) -> Dict[str, str]:
             redacted_headers[key] = value
 
     return redacted_headers
+
+
+def join_url(base: str, *paths: str) -> str:
+    return "/".join(part.strip("/") for part in [base, *paths])

vtex/_vtex.py

@@ -14,6 +14,7 @@ if TYPE_CHECKING:
         MasterDataAPI,
         OrdersAPI,
         PaymentsGatewayAPI,
+        PricingAPI,
         PromotionsAndTaxesAPI,
     )
 
@@ -76,6 +77,12 @@ class VTEX:
 
         return OrdersAPI(client=self)
 
+    @cached_property
+    def pricing(self) -> "PricingAPI":
+        from ._api import PricingAPI
+
+        return PricingAPI(client=self)
+
     @cached_property
     def payments_gateway(self) -> "PaymentsGatewayAPI":
         from ._api import PaymentsGatewayAPI

{vtexpy-0.0.0b25.dist-info → vtexpy-0.0.0b27.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: vtexpy
-Version: 0.0.0b25
+Version: 0.0.0b27
 Summary: Unofficial VTEX API's Python SDK
 Home-page: https://github.com/lvieirajr/vtex-python
 License: Apache
@@ -27,6 +27,7 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Dist: cachetools (>=5.0,<6.0)
 Requires-Dist: httpx (>=0.17,<1.0)
+Requires-Dist: limits (>=3.7,<4.0)
 Requires-Dist: pydantic (>=2.0,<3.0)
 Requires-Dist: python-dateutil (>=2.9,<3.0)
 Requires-Dist: tenacity (>=8.0,<10.0)

vtexpy-0.0.0b27.dist-info/RECORD

@@ -0,0 +1,31 @@
+vtex/__init__.py,sha256=SLnqpZa19ISSQ9LDaCVLDAj-OxFlgVkQyEknydu20VU,636
+vtex/_api/__init__.py,sha256=2OarRhTDq1Oj65v7WkMr3Bi7EAnQMPm2Ypgv9flzE6c,385
+vtex/_api/base.py,sha256=E9Daq7El9wb2df9kjG4RtERchVfYPxgGJR19QM8WIyk,8225
+vtex/_api/catalog.py,sha256=UaVWI9Vhhu6wHejO851hVSDmcLUDtfwcnsGasZGEKiw,4661
+vtex/_api/checkout.py,sha256=ViFJq2GZRAA6yyjaFC3rz0oMYKxzBIsi8tzGKCWRxQ0,1693
+vtex/_api/custom.py,sha256=3yIwTj1Ikf30oq0GzdNz0P9APYxjBeoRvdlbh0rT9gs,2930
+vtex/_api/license_manager.py,sha256=GAdRpizeGUFem-up-SYNzehs5uBY0elTElJ9bEQUlFo,2805
+vtex/_api/logistics.py,sha256=bd55wipbnql3OFnDCBsjP0-jp7OY6FP10Yz5acOsG2o,5052
+vtex/_api/master_data.py,sha256=HGoWr908iQYb0kzq_KNvKyWKtaNQ9vTv7CXxvKey0AM,2046
+vtex/_api/orders.py,sha256=hItiCL79ZnhrjrEwm3oMzc0bu2qezTIyq2uZMHUnaog,5209
+vtex/_api/payments_gateway.py,sha256=06X8XkkfijeMMI3nUPhpceg2sC5V-l9ChWGsjg9HQtw,3877
+vtex/_api/pricing.py,sha256=gZX9MmUKsj0iPjJKT2-Ko9dzT6rZR_DR4ruqs1c9IdY,535
+vtex/_api/promotions_and_taxes.py,sha256=wtNxTrc36u10AMbOq2NMtOVp1HLzrBWxqJDmBYpdXXY,1893
+vtex/_api/types/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+vtex/_api/types/catalog.py,sha256=O_qLoiGMyBxRdmxPclbbPobUxJSzViqzHiKf8tgfm_I,394
+vtex/_api/types/generic.py,sha256=m1lFTPeyBNi-K0shvK4uxE5SUyvhTTX_5Ls2VockkdI,344
+vtex/_api/types/license_manager.py,sha256=KYISnKdQ548g6x5cNieoaN6gh9C1LQVFv4sH-II1maI,1015
+vtex/_config.py,sha256=UwKVinxMqpLsJAStqTmNZutDO9x9tT0ADUNX1hzZxI0,12631
+vtex/_constants.py,sha256=H-Yz57uzb-nG8bj5zQJck3KFWkQJf8Cc2VZ3dqSnbKY,2148
+vtex/_dto.py,sha256=6CSgQfQp94tA5M9rKxgWf_ftRyoZB804iABIpB5Ff6Y,6479
+vtex/_exceptions.py,sha256=dNRhdk6k4capnsUSHPOKsvACwLfG8cwTNXltao3t344,2152
+vtex/_logging.py,sha256=zahPJIk10YvNs6qoNqhUy7OoDG7dr634CPwiGjT0aEk,2246
+vtex/_sentinels.py,sha256=HLkYBJVHTx9GoyACPO1SuINaGlU2YiqOPuFXUa7iG8A,1120
+vtex/_types.py,sha256=xrqHzmrc0IhE5fc1aGf0StCm3BQbVFyk3LG4Hd7Wd2Q,631
+vtex/_utils.py,sha256=ngC2rRdhBO5cjAAByS0_2LMeXKsI6rnfiHGP96U0m88,3215
+vtex/_vtex.py,sha256=IBPVQ__xiQGJEoht4oCnd-pAYKNJDrKoU06yieQL84o,2342
+vtex/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+vtexpy-0.0.0b27.dist-info/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
+vtexpy-0.0.0b27.dist-info/METADATA,sha256=-4f37ForqFRK7IZcu29zliSA7PIo7QtfLwatbnLftyc,3528
+vtexpy-0.0.0b27.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
+vtexpy-0.0.0b27.dist-info/RECORD,,

vtexpy-0.0.0b25.dist-info/RECORD

@@ -1,30 +0,0 @@
-vtex/__init__.py,sha256=SLnqpZa19ISSQ9LDaCVLDAj-OxFlgVkQyEknydu20VU,636
-vtex/_api/__init__.py,sha256=V4n0SQrqCcVFWtm8J7jbmwIRI9mCSURwdD_8uHGueAI,353
-vtex/_api/base.py,sha256=8KKUfM5S32oaBNqHkLqb-2tW45Jw9XfxlY06vYuTnbs,6854
-vtex/_api/catalog.py,sha256=0nYieUaEe2marzyDVpa23-XgtIXciK7n9rw8UqI9MU4,4661
-vtex/_api/checkout.py,sha256=AMhSzyjAu5sZUpqevRorV706yXjNafqGDgbnq2wxVpg,1693
-vtex/_api/custom.py,sha256=oW4dkHr1xuqVD7oby7ca9Qlhfzq7AeAIzcuKQ3eiUdc,2910
-vtex/_api/license_manager.py,sha256=rzsQnxUT96EBmj3G6Fxy4pWH_wmLObGR6XsEhqTyr2c,2805
-vtex/_api/logistics.py,sha256=wKSbV2BnDxfhj04d3yQ39errOwml3zNYlXkqcIE2fqI,5052
-vtex/_api/master_data.py,sha256=JdMA_dWpbSY7TAJY5MobmQ7OsnoofJA60Qbx8IA6pe0,2046
-vtex/_api/orders.py,sha256=klT9cMWTr0bjyyGCAVoFhYICi3vwpzWdbVMg9sS02y4,5136
-vtex/_api/payments_gateway.py,sha256=5XkxbXGI7OEQEaykL-y-3PKnfloy380fjUQ18Ctts9E,3804
-vtex/_api/promotions_and_taxes.py,sha256=yi9EDlOTop77_DqUF-E9SjblfgF4FyXyerA0_QZplJ4,1893
-vtex/_api/types/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-vtex/_api/types/catalog.py,sha256=O_qLoiGMyBxRdmxPclbbPobUxJSzViqzHiKf8tgfm_I,394
-vtex/_api/types/generic.py,sha256=m1lFTPeyBNi-K0shvK4uxE5SUyvhTTX_5Ls2VockkdI,344
-vtex/_api/types/license_manager.py,sha256=KYISnKdQ548g6x5cNieoaN6gh9C1LQVFv4sH-II1maI,1015
-vtex/_config.py,sha256=0wKEGQWiNv8WrvMqleqglZPF_eJFfAZeUt7to5HU0FI,11706
-vtex/_constants.py,sha256=Oijo8dlWaC9m_liGlqFMWdh0HN7pPtFs75sTA2CjJOA,2047
-vtex/_dto.py,sha256=6CSgQfQp94tA5M9rKxgWf_ftRyoZB804iABIpB5Ff6Y,6479
-vtex/_exceptions.py,sha256=dNRhdk6k4capnsUSHPOKsvACwLfG8cwTNXltao3t344,2152
-vtex/_logging.py,sha256=zahPJIk10YvNs6qoNqhUy7OoDG7dr634CPwiGjT0aEk,2246
-vtex/_sentinels.py,sha256=HLkYBJVHTx9GoyACPO1SuINaGlU2YiqOPuFXUa7iG8A,1120
-vtex/_types.py,sha256=xrqHzmrc0IhE5fc1aGf0StCm3BQbVFyk3LG4Hd7Wd2Q,631
-vtex/_utils.py,sha256=slBhhZN3h2S_qopVLGP0MS6nTfsoOcsqaOhLwbCiFwQ,3104
-vtex/_vtex.py,sha256=yr8ICPX0gDpPdcoSDJaokMuwFZWWEQ7Wi8z6XibYdos,2184
-vtex/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-vtexpy-0.0.0b25.dist-info/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
-vtexpy-0.0.0b25.dist-info/METADATA,sha256=GS4YmEp6ATaL77x6_x_SU7lwusWC2T9fNOnUz_8xsKA,3493
-vtexpy-0.0.0b25.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
-vtexpy-0.0.0b25.dist-info/RECORD,,