proxyrequest-sdk 4.2.1__tar.gz → 4.3.0__tar.gz

{proxyrequest_sdk-4.2.1 → proxyrequest_sdk-4.3.0}/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to the ProxyRequest Python SDK are documented here.
 
 ## Unreleased
 
+## 4.3.0 (2026-10-07)
+
+- Add `include_geo` to synchronous and asynchronous `locations.list_asns()`. Set it to `True` to request country, region, and city scopes in each ASN's `geo` list; the API returns an empty list by default.
+- Expose the always-present `country_codes` summary on `LocationASNRecord`.
+- Regenerate the SDK and reference from the latest public API contract while preserving existing arguments.
+
 ## 4.2.1 (2026-10-05)
 
 - Allow an explicit zero invoice total for free product purchases; setting any explicit total requires superuser authorization.

{proxyrequest_sdk-4.2.1 → proxyrequest_sdk-4.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: proxyrequest-sdk
-Version: 4.2.1
+Version: 4.3.0
 Summary: Official sync and async Python SDK for the ProxyRequest public API.
 Project-URL: Homepage, https://proxyrequest.com
 Project-URL: Documentation, https://proxyrequest.com/docs/
@@ -370,3 +370,5 @@ for balance in page.results:
 Provider byte amounts are exact decimal **strings**, including history entries; calculated usage and remaining amounts can be `null`. The response includes observation and calculation times, freshness, errors, and recent checkpoint history. History is limited by the server's `PROVIDER_DATA_BALANCE_HISTORY_LIMIT` setting (default 10). Standard pagination applies to providers.
 
 Country, region, and city methods also support `include_asns`. Set it to `true` to populate nested ASN arrays; omitted or false uses the API's empty-array default.
+
+`client.locations.list_asns(package_id=package_id, include_geo=True)` includes country, region, and city scopes in each ASN's `geo` list. Without `include_geo`, `geo` is empty; `country_codes` still lists the available country codes. The same option is available on `AsyncClient`.

{proxyrequest_sdk-4.2.1 → proxyrequest_sdk-4.3.0}/README.md

@@ -340,3 +340,5 @@ for balance in page.results:
 Provider byte amounts are exact decimal **strings**, including history entries; calculated usage and remaining amounts can be `null`. The response includes observation and calculation times, freshness, errors, and recent checkpoint history. History is limited by the server's `PROVIDER_DATA_BALANCE_HISTORY_LIMIT` setting (default 10). Standard pagination applies to providers.
 
 Country, region, and city methods also support `include_asns`. Set it to `true` to populate nested ASN arrays; omitted or false uses the API's empty-array default.
+
+`client.locations.list_asns(package_id=package_id, include_geo=True)` includes country, region, and city scopes in each ASN's `geo` list. Without `include_geo`, `geo` is empty; `country_codes` still lists the available country codes. The same option is available on `AsyncClient`.

{proxyrequest_sdk-4.2.1 → proxyrequest_sdk-4.3.0}/docs/reference/sdk-reference.json

@@ -4,12 +4,12 @@
     "id": "python",
     "label": "Python",
     "language": "Python",
-    "version": "4.2.1",
+    "version": "4.3.0",
     "package": "proxyrequest-sdk",
     "runtime": "Python 3.11 or later",
     "install": "python -m pip install proxyrequest-sdk",
     "openapi": {
-      "commit": "3bd7c30b6727264a0eae42f6d536e1cce34b3b5b",
+      "commit": "19f5f67335bbd888e9454914eca4a59acfce270c",
       "excludedOperations": [
         "sessions_destroy",
         "sessions_list"
@@ -17,7 +17,7 @@
       "operations": 85,
       "repository": "papaproxy/api",
       "schemas": 142,
-      "sha256": "44538b2e5f651dc95ff0883b62239bb06b8803caf537d78e5a815e289a6545e5",
+      "sha256": "b787e51bd6b990ad492a97c3ff09d823a6d3269855fb46ddc82a02a2becaac9d",
       "source": "openapi.yml"
     }
   },
@@ -4797,23 +4797,23 @@
           "operationId": "locations_asn_list",
           "name": "list_asns",
           "summary": "List available autonomous systems",
-          "description": "Returns targetable ASNs for the selected package. Geo-scoped records include the country, region, or city where the ASN can be selected.",
+          "description": "Returns targetable ASNs for the selected package. The geo field is empty unless include_geo=true; then it contains targetable geographic scopes.",
           "httpMethod": "GET",
           "path": "/locations/asn",
           "signatures": [
             {
               "label": "Sync",
-              "signature": "client.locations.list_asns(*, code: str | Unset=UNSET, country_code: str | Unset=UNSET, global_: bool | Unset=UNSET, limit: int | Unset=UNSET, name: str | Unset=UNSET, offset: int | Unset=UNSET, ordering: str | Unset=UNSET, package_id: UUID, search: str | Unset=UNSET, accept_language: str | Unset=UNSET) -> PaginatedLocationASNRecordList"
+              "signature": "client.locations.list_asns(*, code: str | Unset=UNSET, country_code: str | Unset=UNSET, global_: bool | Unset=UNSET, include_geo: bool | Unset=False, limit: int | Unset=UNSET, name: str | Unset=UNSET, offset: int | Unset=UNSET, ordering: str | Unset=UNSET, package_id: UUID, search: str | Unset=UNSET, accept_language: str | Unset=UNSET) -> PaginatedLocationASNRecordList"
             },
             {
               "label": "Async",
-              "signature": "await async_client.locations.list_asns(*, code: str | Unset=UNSET, country_code: str | Unset=UNSET, global_: bool | Unset=UNSET, limit: int | Unset=UNSET, name: str | Unset=UNSET, offset: int | Unset=UNSET, ordering: str | Unset=UNSET, package_id: UUID, search: str | Unset=UNSET, accept_language: str | Unset=UNSET) -> PaginatedLocationASNRecordList"
+              "signature": "await async_client.locations.list_asns(*, code: str | Unset=UNSET, country_code: str | Unset=UNSET, global_: bool | Unset=UNSET, include_geo: bool | Unset=False, limit: int | Unset=UNSET, name: str | Unset=UNSET, offset: int | Unset=UNSET, ordering: str | Unset=UNSET, package_id: UUID, search: str | Unset=UNSET, accept_language: str | Unset=UNSET) -> PaginatedLocationASNRecordList"
             }
           ],
           "variants": [
             {
               "name": "list_asns_with_response",
-              "signature": "client.locations.list_asns_with_response(*, code: str | Unset=UNSET, country_code: str | Unset=UNSET, global_: bool | Unset=UNSET, limit: int | Unset=UNSET, name: str | Unset=UNSET, offset: int | Unset=UNSET, ordering: str | Unset=UNSET, package_id: UUID, search: str | Unset=UNSET, accept_language: str | Unset=UNSET) -> ApiResponse[PaginatedLocationASNRecordList]",
+              "signature": "client.locations.list_asns_with_response(*, code: str | Unset=UNSET, country_code: str | Unset=UNSET, global_: bool | Unset=UNSET, include_geo: bool | Unset=False, limit: int | Unset=UNSET, name: str | Unset=UNSET, offset: int | Unset=UNSET, ordering: str | Unset=UNSET, package_id: UUID, search: str | Unset=UNSET, accept_language: str | Unset=UNSET) -> ApiResponse[PaginatedLocationASNRecordList]",
               "description": "Returns response status, headers, ETag and idempotency metadata with the decoded data."
             }
           ],
@@ -4851,6 +4851,17 @@
               "example": false,
               "modelRefs": []
             },
+            {
+              "name": "include_geo",
+              "wireName": "include_geo",
+              "in": "query",
+              "required": false,
+              "type": "bool",
+              "default": false,
+              "description": "Include geographic scopes for each ASN. By default geo is an empty list.",
+              "example": false,
+              "modelRefs": []
+            },
             {
               "name": "limit",
               "wireName": "limit",
@@ -14707,10 +14718,19 @@
           "enum": null,
           "modelRefs": []
         },
+        {
+          "name": "country_codes",
+          "type": "list[str]",
+          "required": true,
+          "default": null,
+          "description": "",
+          "enum": null,
+          "modelRefs": []
+        },
         {
           "name": "geo",
           "type": "list[LocationASNGeoItem]",
-          "required": false,
+          "required": true,
           "default": null,
           "description": "",
           "enum": null,

{proxyrequest_sdk-4.2.1 → proxyrequest_sdk-4.3.0}/openapi/openapi.yaml

@@ -6984,8 +6984,8 @@ paths:
   /locations/asn:
     get:
       operationId: locations_asn_list
-      description: Returns targetable ASNs for the selected package. Geo-scoped records
-        include the country, region, or city where the ASN can be selected.
+      description: Returns targetable ASNs for the selected package. The geo field is
+        empty unless include_geo=true; then it contains targetable geographic scopes.
       summary: List available autonomous systems
       parameters:
       - in: query
@@ -7001,6 +7001,16 @@ paths:
         schema:
           type: boolean
         description: Set to true to return only globally targetable ASNs.
+      - in: query
+        name: include_geo
+        schema:
+          type: boolean
+          default: false
+        description: Include geographic scopes for each ASN. By default geo is an empty list.
+        examples:
+          IncludeASNGeography:
+            value: true
+            summary: Include ASN geography
       - name: limit
         required: false
         in: query
@@ -7076,16 +7086,9 @@ paths:
                     results:
                     - code: '7922'
                       name: Comcast Cable Communications
-                      geo:
-                      - country:
-                          code: us
-                          name: United States
-                        region:
-                          code: california
-                          name: California
-                        city:
-                          code: los_angeles
-                          name: Los Angeles
+                      country_codes:
+                      - us
+                      geo: []
                   summary: Available ASNs
           description: The operation completed successfully.
         '400':
@@ -19084,12 +19087,18 @@ components:
           type: string
         name:
           type: string
+        country_codes:
+          type: array
+          items:
+            type: string
         geo:
           type: array
           items:
             $ref: '#/components/schemas/LocationASNGeoItem'
       required:
       - code
+      - country_codes
+      - geo
       - name
     LocationCodeName:
       type: object

{proxyrequest_sdk-4.2.1 → proxyrequest_sdk-4.3.0}/openapi/source.json

@@ -1,5 +1,5 @@
 {
-  "commit": "3bd7c30b6727264a0eae42f6d536e1cce34b3b5b",
+  "commit": "19f5f67335bbd888e9454914eca4a59acfce270c",
   "excludedOperations": [
     "sessions_destroy",
     "sessions_list"
@@ -7,6 +7,6 @@
   "operations": 85,
   "repository": "papaproxy/api",
   "schemas": 142,
-  "sha256": "44538b2e5f651dc95ff0883b62239bb06b8803caf537d78e5a815e289a6545e5",
+  "sha256": "b787e51bd6b990ad492a97c3ff09d823a6d3269855fb46ddc82a02a2becaac9d",
   "source": "openapi.yml"
 }

{proxyrequest_sdk-4.2.1 → proxyrequest_sdk-4.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "proxyrequest-sdk"
-version = "4.2.1"
+version = "4.3.0"
 description = "Official sync and async Python SDK for the ProxyRequest public API."
 readme = "README.md"
 requires-python = ">=3.11"

{proxyrequest_sdk-4.2.1 → proxyrequest_sdk-4.3.0}/src/proxyrequest_sdk/_generated/api/locations/locations_asn_list.py

@@ -24,6 +24,7 @@ def _get_kwargs(
     code: str | Unset = UNSET,
     country_code: str | Unset = UNSET,
     global_: bool | Unset = UNSET,
+    include_geo: bool | Unset = False,
     limit: int | Unset = UNSET,
     name: str | Unset = UNSET,
     offset: int | Unset = UNSET,
@@ -44,6 +45,8 @@ def _get_kwargs(
 
     params["global"] = global_
 
+    params["include_geo"] = include_geo
+
     params["limit"] = limit
 
     params["name"] = name
@@ -127,6 +130,7 @@ def sync_detailed(
     code: str | Unset = UNSET,
     country_code: str | Unset = UNSET,
     global_: bool | Unset = UNSET,
+    include_geo: bool | Unset = False,
     limit: int | Unset = UNSET,
     name: str | Unset = UNSET,
     offset: int | Unset = UNSET,
@@ -142,13 +146,14 @@ def sync_detailed(
 ]:
     """List available autonomous systems
 
-     Returns targetable ASNs for the selected package. Geo-scoped records include the country, region, or
-    city where the ASN can be selected.
+     Returns targetable ASNs for the selected package. The geo field is empty unless include_geo=true;
+    then it contains targetable geographic scopes.
 
     Args:
         code (str | Unset):
         country_code (str | Unset):
         global_ (bool | Unset):
+        include_geo (bool | Unset):  Default: False.
         limit (int | Unset):
         name (str | Unset):
         offset (int | Unset):
@@ -169,6 +174,7 @@ def sync_detailed(
         code=code,
         country_code=country_code,
         global_=global_,
+        include_geo=include_geo,
         limit=limit,
         name=name,
         offset=offset,
@@ -191,6 +197,7 @@ def sync(
     code: str | Unset = UNSET,
     country_code: str | Unset = UNSET,
     global_: bool | Unset = UNSET,
+    include_geo: bool | Unset = False,
     limit: int | Unset = UNSET,
     name: str | Unset = UNSET,
     offset: int | Unset = UNSET,
@@ -207,13 +214,14 @@ def sync(
 ):
     """List available autonomous systems
 
-     Returns targetable ASNs for the selected package. Geo-scoped records include the country, region, or
-    city where the ASN can be selected.
+     Returns targetable ASNs for the selected package. The geo field is empty unless include_geo=true;
+    then it contains targetable geographic scopes.
 
     Args:
         code (str | Unset):
         country_code (str | Unset):
         global_ (bool | Unset):
+        include_geo (bool | Unset):  Default: False.
         limit (int | Unset):
         name (str | Unset):
         offset (int | Unset):
@@ -235,6 +243,7 @@ def sync(
         code=code,
         country_code=country_code,
         global_=global_,
+        include_geo=include_geo,
         limit=limit,
         name=name,
         offset=offset,
@@ -251,6 +260,7 @@ async def asyncio_detailed(
     code: str | Unset = UNSET,
     country_code: str | Unset = UNSET,
     global_: bool | Unset = UNSET,
+    include_geo: bool | Unset = False,
     limit: int | Unset = UNSET,
     name: str | Unset = UNSET,
     offset: int | Unset = UNSET,
@@ -266,13 +276,14 @@ async def asyncio_detailed(
 ]:
     """List available autonomous systems
 
-     Returns targetable ASNs for the selected package. Geo-scoped records include the country, region, or
-    city where the ASN can be selected.
+     Returns targetable ASNs for the selected package. The geo field is empty unless include_geo=true;
+    then it contains targetable geographic scopes.
 
     Args:
         code (str | Unset):
         country_code (str | Unset):
         global_ (bool | Unset):
+        include_geo (bool | Unset):  Default: False.
         limit (int | Unset):
         name (str | Unset):
         offset (int | Unset):
@@ -293,6 +304,7 @@ async def asyncio_detailed(
         code=code,
         country_code=country_code,
         global_=global_,
+        include_geo=include_geo,
         limit=limit,
         name=name,
         offset=offset,
@@ -313,6 +325,7 @@ async def asyncio(
     code: str | Unset = UNSET,
     country_code: str | Unset = UNSET,
     global_: bool | Unset = UNSET,
+    include_geo: bool | Unset = False,
     limit: int | Unset = UNSET,
     name: str | Unset = UNSET,
     offset: int | Unset = UNSET,
@@ -329,13 +342,14 @@ async def asyncio(
 ):
     """List available autonomous systems
 
-     Returns targetable ASNs for the selected package. Geo-scoped records include the country, region, or
-    city where the ASN can be selected.
+     Returns targetable ASNs for the selected package. The geo field is empty unless include_geo=true;
+    then it contains targetable geographic scopes.
 
     Args:
         code (str | Unset):
         country_code (str | Unset):
         global_ (bool | Unset):
+        include_geo (bool | Unset):  Default: False.
         limit (int | Unset):
         name (str | Unset):
         offset (int | Unset):
@@ -358,6 +372,7 @@ async def asyncio(
             code=code,
             country_code=country_code,
             global_=global_,
+            include_geo=include_geo,
             limit=limit,
             name=name,
             offset=offset,

{proxyrequest_sdk-4.2.1 → proxyrequest_sdk-4.3.0}/src/proxyrequest_sdk/_generated/models/location_asn_record.py

@@ -8,7 +8,6 @@ from attrs import field as _attrs_field
 
 from ..types import UNSET, Unset
 
-from ..types import UNSET, Unset
 from typing import cast
 
 if TYPE_CHECKING:
@@ -22,7 +21,8 @@ T = TypeVar("T", bound="LocationASNRecord")
 class LocationASNRecord:
     code: str
     name: str
-    geo: list[LocationASNGeoItem] | Unset = UNSET
+    country_codes: list[str]
+    geo: list[LocationASNGeoItem]
     additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
 
     def to_dict(self) -> dict[str, Any]:
@@ -32,12 +32,12 @@ class LocationASNRecord:
 
         name = self.name
 
-        geo: list[dict[str, Any]] | Unset = UNSET
-        if not isinstance(self.geo, Unset):
-            geo = []
-            for geo_item_data in self.geo:
-                geo_item = geo_item_data.to_dict()
-                geo.append(geo_item)
+        country_codes = self.country_codes
+
+        geo = []
+        for geo_item_data in self.geo:
+            geo_item = geo_item_data.to_dict()
+            geo.append(geo_item)
 
         field_dict: dict[str, Any] = {}
         field_dict.update(self.additional_properties)
@@ -45,10 +45,10 @@ class LocationASNRecord:
             {
                 "code": code,
                 "name": name,
+                "country_codes": country_codes,
+                "geo": geo,
             }
         )
-        if geo is not UNSET:
-            field_dict["geo"] = geo
 
         return field_dict
 
@@ -61,18 +61,19 @@ class LocationASNRecord:
 
         name = d.pop("name")
 
-        _geo = d.pop("geo", UNSET)
-        geo: list[LocationASNGeoItem] | Unset = UNSET
-        if _geo is not UNSET:
-            geo = []
-            for geo_item_data in _geo:
-                geo_item = LocationASNGeoItem.from_dict(geo_item_data)
+        country_codes = cast(list[str], d.pop("country_codes"))
+
+        geo = []
+        _geo = d.pop("geo")
+        for geo_item_data in _geo:
+            geo_item = LocationASNGeoItem.from_dict(geo_item_data)
 
-                geo.append(geo_item)
+            geo.append(geo_item)
 
         location_asn_record = cls(
             code=code,
             name=name,
+            country_codes=country_codes,
             geo=geo,
         )
 

{proxyrequest_sdk-4.2.1 → proxyrequest_sdk-4.3.0}/src/proxyrequest_sdk/resources/locations.py

@@ -190,6 +190,7 @@ class LocationsResource:
         code: str | Unset = UNSET,
         country_code: str | Unset = UNSET,
         global_: bool | Unset = UNSET,
+        include_geo: bool | Unset = False,
         limit: int | Unset = UNSET,
         name: str | Unset = UNSET,
         offset: int | Unset = UNSET,
@@ -206,6 +207,7 @@ class LocationsResource:
                 code=code,
                 country_code=country_code,
                 global_=global_,
+                include_geo=include_geo,
                 limit=limit,
                 name=name,
                 offset=offset,
@@ -222,6 +224,7 @@ class LocationsResource:
         code: str | Unset = UNSET,
         country_code: str | Unset = UNSET,
         global_: bool | Unset = UNSET,
+        include_geo: bool | Unset = False,
         limit: int | Unset = UNSET,
         name: str | Unset = UNSET,
         offset: int | Unset = UNSET,
@@ -238,6 +241,7 @@ class LocationsResource:
                 code=code,
                 country_code=country_code,
                 global_=global_,
+                include_geo=include_geo,
                 limit=limit,
                 name=name,
                 offset=offset,
@@ -715,6 +719,7 @@ class AsyncLocationsResource:
         code: str | Unset = UNSET,
         country_code: str | Unset = UNSET,
         global_: bool | Unset = UNSET,
+        include_geo: bool | Unset = False,
         limit: int | Unset = UNSET,
         name: str | Unset = UNSET,
         offset: int | Unset = UNSET,
@@ -731,6 +736,7 @@ class AsyncLocationsResource:
                 code=code,
                 country_code=country_code,
                 global_=global_,
+                include_geo=include_geo,
                 limit=limit,
                 name=name,
                 offset=offset,
@@ -747,6 +753,7 @@ class AsyncLocationsResource:
         code: str | Unset = UNSET,
         country_code: str | Unset = UNSET,
         global_: bool | Unset = UNSET,
+        include_geo: bool | Unset = False,
         limit: int | Unset = UNSET,
         name: str | Unset = UNSET,
         offset: int | Unset = UNSET,
@@ -763,6 +770,7 @@ class AsyncLocationsResource:
                 code=code,
                 country_code=country_code,
                 global_=global_,
+                include_geo=include_geo,
                 limit=limit,
                 name=name,
                 offset=offset,

proxyrequest_sdk-4.3.0/tests/test_asn_geo.py

@@ -0,0 +1,39 @@
+from __future__ import annotations
+
+from typing import Any
+from uuid import UUID
+
+import httpx
+import pytest
+from test_backend_compatibility import mocked_client, result
+
+from proxyrequest_sdk.models import LocationASNRecord
+
+
+@pytest.mark.asyncio
+@pytest.mark.parametrize("asynchronous", [False, True])
+@pytest.mark.parametrize("include_geo", [None, False, True])
+async def test_asn_geography_is_opt_in(asynchronous: bool, include_geo: bool | None) -> None:
+    geo = [{"country": {"code": "us", "name": "United States"}}] if include_geo else []
+    payload: dict[str, Any] = {
+        "count": 1,
+        "next": None,
+        "previous": None,
+        "results": [{"code": "7922", "name": "Example ASN", "country_codes": ["us"], "geo": geo}],
+    }
+    async with mocked_client(asynchronous, [httpx.Response(200, json=payload)]) as (
+        client,
+        requests,
+    ):
+        options = {} if include_geo is None else {"include_geo": include_geo}
+        page = await result(
+            client.locations.list_asns(
+                package_id=UUID("550e8400-e29b-41d4-a716-446655440002"), **options
+            )
+        )
+        record = page.results[0]
+        assert isinstance(record, LocationASNRecord)
+        assert record.country_codes == ["us"]
+        assert len(record.geo) == len(geo)
+        assert record.to_dict() == payload["results"][0]
+        assert requests[0].url.params.get("include_geo") == str(bool(include_geo)).lower()

{proxyrequest_sdk-4.2.1 → proxyrequest_sdk-4.3.0}/tests/test_contract.py

@@ -138,7 +138,7 @@ def test_generated_reference_covers_public_operations_and_examples_parse() -> No
         manifest["sdk"]["openapi"]["excludedOperations"]
     )
     assert manifest["schemaVersion"] == 3
-    assert manifest["sdk"]["version"] == "4.2.1"
+    assert manifest["sdk"]["version"] == "4.3.0"
     assert len(methods) == expected
     assert len({method["operationId"] for method in methods}) == len(methods)
     assert len(manifest["models"]) > 100

{proxyrequest_sdk-4.2.1 → proxyrequest_sdk-4.3.0}/uv.lock

@@ -870,7 +870,7 @@ wheels = [
 
 [[package]]
 name = "proxyrequest-sdk"
-version = "4.2.1"
+version = "4.3.0"
 source = { editable = "." }
 dependencies = [
     { name = "attrs" },