tango-python 1.1.2__py3-none-any.whl → 1.1.3__py3-none-any.whl

tango/__init__.py

@@ -44,7 +44,7 @@ from .webhooks import (
 )
 from .webhooks.receiver import Delivery, WebhookReceiver
 
-__version__ = "1.1.2"
+__version__ = "1.1.3"
 __all__ = [
     "TangoClient",
     "TangoAPIError",

tango/client.py

@@ -1923,15 +1923,37 @@ class TangoClient:
         )
 
     # Business Types endpoints
-    def list_business_types(self, page: int = 1, limit: int = 25) -> PaginatedResponse:
-        """List business types"""
-        params = {"page": page, "limit": min(limit, 100)}
+    def list_business_types(
+        self,
+        page: int = 1,
+        limit: int = 25,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
+    ) -> PaginatedResponse:
+        """List business types.
+
+        When ``shape`` is omitted the API applies its own default
+        (``name,code``) and results are returned as :class:`BusinessType`
+        instances. When ``shape`` is provided, raw dicts are returned so the
+        caller can rely on the exact shape requested.
+        """
+        params: dict[str, Any] = {"page": page, "limit": min(limit, 100)}
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+            if flat_lists:
+                params["flat_lists"] = "true"
         data = self._get("/api/business_types/", params)
+        results: list[Any] = (
+            list(data["results"]) if shape else [BusinessType(**btype) for btype in data["results"]]
+        )
         return PaginatedResponse(
             count=data["count"],
             next=data.get("next"),
             previous=data.get("previous"),
-            results=[BusinessType(**btype) for btype in data["results"]],
+            results=results,
         )
 
     def list_naics(
@@ -1945,8 +1967,17 @@ class TangoClient:
         revenue_limit_gte: int | None = None,
         revenue_limit_lte: int | None = None,
         search: str | None = None,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
     ) -> PaginatedResponse:
-        """List NAICS codes (`/api/naics/`)."""
+        """List NAICS codes (`/api/naics/`).
+
+        When ``shape`` is omitted the API applies its own default. Passing any
+        of the ``revenue_limit*`` / ``employee_limit*`` filters causes the API
+        to widen the default shape to include ``size_standards`` and
+        ``federal_obligations``.
+        """
         params: dict[str, Any] = {"page": page, "limit": min(limit, 100)}
         if employee_limit is not None:
             params["employee_limit"] = employee_limit
@@ -1962,6 +1993,12 @@ class TangoClient:
             params["revenue_limit_lte"] = revenue_limit_lte
         if search is not None:
             params["search"] = search
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+            if flat_lists:
+                params["flat_lists"] = "true"
         data = self._get("/api/naics/", params)
         return PaginatedResponse(
             count=data.get("count", 0),
@@ -3344,9 +3381,22 @@ class TangoClient:
             raise TangoValidationError("Department code is required")
         return self._get(f"/api/departments/{code}/")
 
-    def list_psc(self, page: int = 1, limit: int = 25) -> PaginatedResponse[dict[str, Any]]:
+    def list_psc(
+        self,
+        page: int = 1,
+        limit: int = 25,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
+    ) -> PaginatedResponse[dict[str, Any]]:
         """List Product Service Codes (`/api/psc/`)."""
         params: dict[str, Any] = {"page": page, "limit": min(limit, 100)}
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+            if flat_lists:
+                params["flat_lists"] = "true"
         data = self._get("/api/psc/", params)
         return PaginatedResponse(
             count=int(data.get("count", 0)),
@@ -3355,11 +3405,24 @@ class TangoClient:
             results=list(data.get("results") or []),
         )
 
-    def get_psc(self, code: str) -> dict[str, Any]:
+    def get_psc(
+        self,
+        code: str,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
+    ) -> dict[str, Any]:
         """Get a Product Service Code by code (`/api/psc/{code}/`)."""
         if not code:
             raise TangoValidationError("PSC code is required")
-        return self._get(f"/api/psc/{code}/")
+        params: dict[str, Any] = {}
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+            if flat_lists:
+                params["flat_lists"] = "true"
+        return self._get(f"/api/psc/{code}/", params)
 
     def get_psc_metrics(self, code: str, months: int, period_grouping: str) -> dict[str, Any]:
         """Get rolling PSC metrics (`/api/psc/{code}/metrics/{months}/{period_grouping}/`).
@@ -3374,11 +3437,24 @@ class TangoClient:
             raise TangoValidationError("PSC code is required")
         return self._get(f"/api/psc/{code}/metrics/{months}/{period_grouping}/")
 
-    def get_naics(self, code: str) -> dict[str, Any]:
+    def get_naics(
+        self,
+        code: str,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
+    ) -> dict[str, Any]:
         """Get a NAICS code by code (`/api/naics/{code}/`)."""
         if not code:
             raise TangoValidationError("NAICS code is required")
-        return self._get(f"/api/naics/{code}/")
+        params: dict[str, Any] = {}
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+            if flat_lists:
+                params["flat_lists"] = "true"
+        return self._get(f"/api/naics/{code}/", params)
 
     def get_naics_metrics(self, code: str, months: int, period_grouping: str) -> dict[str, Any]:
         """Get rolling NAICS metrics (`/api/naics/{code}/metrics/{months}/{period_grouping}/`)."""
@@ -3386,17 +3462,41 @@ class TangoClient:
             raise TangoValidationError("NAICS code is required")
         return self._get(f"/api/naics/{code}/metrics/{months}/{period_grouping}/")
 
-    def get_business_type(self, code: str) -> dict[str, Any]:
+    def get_business_type(
+        self,
+        code: str,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
+    ) -> dict[str, Any]:
         """Get a business type by code (`/api/business_types/{code}/`)."""
         if not code:
             raise TangoValidationError("Business type code is required")
-        return self._get(f"/api/business_types/{code}/")
+        params: dict[str, Any] = {}
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+            if flat_lists:
+                params["flat_lists"] = "true"
+        return self._get(f"/api/business_types/{code}/", params)
 
     def list_assistance_listings(
-        self, page: int = 1, limit: int = 25
+        self,
+        page: int = 1,
+        limit: int = 25,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
     ) -> PaginatedResponse[dict[str, Any]]:
         """List Assistance Listings (CFDA programs) (`/api/assistance_listings/`)."""
         params: dict[str, Any] = {"page": page, "limit": min(limit, 100)}
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+            if flat_lists:
+                params["flat_lists"] = "true"
         data = self._get("/api/assistance_listings/", params)
         return PaginatedResponse(
             count=int(data.get("count", 0)),
@@ -3405,22 +3505,44 @@ class TangoClient:
             results=list(data.get("results") or []),
         )
 
-    def get_assistance_listing(self, number: str) -> dict[str, Any]:
+    def get_assistance_listing(
+        self,
+        number: str,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
+    ) -> dict[str, Any]:
         """Get an Assistance Listing by CFDA number (`/api/assistance_listings/{number}/`)."""
         if not number:
             raise TangoValidationError("Assistance listing number is required")
-        return self._get(f"/api/assistance_listings/{number}/")
+        params: dict[str, Any] = {}
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+            if flat_lists:
+                params["flat_lists"] = "true"
+        return self._get(f"/api/assistance_listings/{number}/", params)
 
     def list_mas_sins(
         self,
         page: int = 1,
         limit: int = 25,
         search: str | None = None,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
     ) -> PaginatedResponse[dict[str, Any]]:
         """List GSA MAS SINs (`/api/mas_sins/`)."""
         params: dict[str, Any] = {"page": page, "limit": min(limit, 100)}
         if search is not None:
             params["search"] = search
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+            if flat_lists:
+                params["flat_lists"] = "true"
         data = self._get("/api/mas_sins/", params)
         return PaginatedResponse(
             count=int(data.get("count", 0)),
@@ -3429,11 +3551,24 @@ class TangoClient:
             results=list(data.get("results") or []),
         )
 
-    def get_mas_sin(self, sin: str) -> dict[str, Any]:
+    def get_mas_sin(
+        self,
+        sin: str,
+        shape: str | None = None,
+        flat: bool = False,
+        flat_lists: bool = False,
+    ) -> dict[str, Any]:
         """Get a MAS SIN by code (`/api/mas_sins/{sin}/`)."""
         if not sin:
             raise TangoValidationError("MAS SIN is required")
-        return self._get(f"/api/mas_sins/{sin}/")
+        params: dict[str, Any] = {}
+        if shape:
+            params["shape"] = shape
+            if flat:
+                params["flat"] = "true"
+            if flat_lists:
+                params["flat_lists"] = "true"
+        return self._get(f"/api/mas_sins/{sin}/", params)
 
     # ============================================================================
     # Entity sub-resources

{tango_python-1.1.2.dist-info → tango_python-1.1.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tango-python
-Version: 1.1.2
+Version: 1.1.3
 Summary: Python SDK for the Tango API
 Project-URL: Homepage, https://github.com/makegov/tango-python
 Project-URL: Documentation, https://docs.makegov.com/tango-python

{tango_python-1.1.2.dist-info → tango_python-1.1.3.dist-info}/RECORD

@@ -1,5 +1,5 @@
-tango/__init__.py,sha256=gg4U46hFhUJwgvbGtOdP3vgooi8US-fLXvpBZ060_H8,1912
-tango/client.py,sha256=9-IfMZwerx4uRsPlDI38uQDv77TNl2qShCHVtP4t7EU,144839
+tango/__init__.py,sha256=GFajAGv2H7jhE0yuU7wJk8qOqEARV7Mg2bFIelwsodE,1912
+tango/client.py,sha256=3rZO03j-it7X0BP1EDJSpj5MVOV8JXtnC7AL2pijobQ,148758
 tango/exceptions.py,sha256=aRvDm0dUCEtNDfRVYCX7SEDdd1WlIVVY6sN78Tzo-a0,3114
 tango/models.py,sha256=QqUPtO7HJJDUaJDAMUkzvqR7pj1YIr8BetbS4palxc0,34261
 tango/shapes/__init__.py,sha256=7ea1WU74jp4znhNw-gXruag6m6eyPZtbVgbDFmFUWro,1072
@@ -15,8 +15,8 @@ tango/webhooks/cli.py,sha256=f_vQbJ2AeSQjKnQo7MxHFyUB2SAKcgHYmGQULS0isqQ,13858
 tango/webhooks/receiver.py,sha256=5yhsVhlLyoxmOCGvmbynWAIlDB2OaCPVf1H4GA1SxmU,9279
 tango/webhooks/signing.py,sha256=92Ee-0B6PR7ZkvY3Np3gzl88-mtfKkh-I7lxqCe2lGw,2374
 tango/webhooks/simulate.py,sha256=g2Osa0FYU5mJuon07T2aUCtmkUoTEzsY261tlp76fF0,3165
-tango_python-1.1.2.dist-info/METADATA,sha256=-wGAubnmnT1ysNyUThjVuYWx3p9IjDPf-4FQrxy756U,20599
-tango_python-1.1.2.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-tango_python-1.1.2.dist-info/entry_points.txt,sha256=kGLUbglUjuaAqEFvOZ1QuSW0vWb6VeSpCIFKaOFkKoQ,50
-tango_python-1.1.2.dist-info/licenses/LICENSE,sha256=j2kYVHMwTkoGn3ZNScnrdIueG0k2XzB_LCPFoyBc2wk,1064
-tango_python-1.1.2.dist-info/RECORD,,
+tango_python-1.1.3.dist-info/METADATA,sha256=dvg8fyZFIcwz6xkS1J40HFHjtAxtIAfsolxz0RIM3aw,20599
+tango_python-1.1.3.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+tango_python-1.1.3.dist-info/entry_points.txt,sha256=kGLUbglUjuaAqEFvOZ1QuSW0vWb6VeSpCIFKaOFkKoQ,50
+tango_python-1.1.3.dist-info/licenses/LICENSE,sha256=j2kYVHMwTkoGn3ZNScnrdIueG0k2XzB_LCPFoyBc2wk,1064
+tango_python-1.1.3.dist-info/RECORD,,