tango-python 1.5.0__tar.gz → 1.5.1__tar.gz

{tango_python-1.5.0 → tango_python-1.5.1}/CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.5.1] - 2026-08-10
+
+### Documentation
+- Documented (and pinned with tests) the OR syntax `list_entities(socioeconomic=...)` has always supported: pipe-separated values match entities holding any of the listed designations, e.g. `socioeconomic="OY|A2"`; values are SAM business-type codes (e.g. `OY` Black American Owned, `A6` SBA-certified 8(a), `A2` Woman Owned), not set-aside codes.
+
+### Changed
+- The sdist no longer packages `.github/workflows`, so CI-only commits stop changing the sdist hash. ([#58](https://github.com/makegov/tango-python/pull/58))
+
 ## [1.5.0] - 2026-08-04
 
 ### Added

{tango_python-1.5.0 → tango_python-1.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tango-python
-Version: 1.5.0
+Version: 1.5.1
 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.5.0 → tango_python-1.5.1}/docs/API_REFERENCE.md

@@ -713,7 +713,7 @@ entities = client.list_entities(
 - `name` - Filter by entity name
 - `psc` - Filter by PSC code
 - `purpose_of_registration_code` - Filter by registration purpose
-- `socioeconomic` - Filter by socioeconomic status
+- `socioeconomic` - Filter by socioeconomic status; takes SAM business-type codes (e.g. `OY` Black American Owned, `A6` SBA-certified 8(a), `A2` Woman Owned — see `GET /api/business_types/`), not set-aside codes; accepts pipe-separated values for OR semantics, e.g. `socioeconomic="OY|A2"`
 - `state` - Filter by state
 - `total_awards_obligated_gte` / `total_awards_obligated_lte` - Obligation amount range
 - `uei` - Filter by UEI

{tango_python-1.5.0 → tango_python-1.5.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "tango-python"
-version = "1.5.0"
+version = "1.5.1"
 description = "Python SDK for the Tango API"
 readme = "README.md"
 requires-python = ">=3.12"
@@ -126,13 +126,14 @@ packages = ["tango"]
 # diaries, scratch reports, etc.) when anyone runs `uv publish` locally.
 # The explicit whitelist is belt-and-suspenders for that foot-gun: even
 # from a developer laptop, only these paths can ever end up on PyPI.
+#
+# `.github/workflows` is excluded on purpose: shipping it moves the sdist hash on every CI-only commit, which breaks `--check-url`.
 [tool.hatch.build.targets.sdist]
 include = [
     "/tango",
     "/tests",
     "/docs",
     "/scripts",
-    "/.github/workflows",
     "/README.md",
     "/LICENSE",
     "/CHANGELOG.md",

{tango_python-1.5.0 → tango_python-1.5.1}/tango/__init__.py

@@ -50,7 +50,7 @@ from .webhooks import (
 )
 from .webhooks.receiver import Delivery, WebhookReceiver
 
-__version__ = "1.5.0"
+__version__ = "1.5.1"
 __all__ = [
     "TangoClient",
     "TangoAPIError",

{tango_python-1.5.0 → tango_python-1.5.1}/tango/client.py

@@ -2081,7 +2081,7 @@ class TangoClient:
             name: Entity name filter
             psc: PSC code filter
             purpose_of_registration_code: Purpose of registration code
-            socioeconomic: Socioeconomic status filter
+            socioeconomic: Socioeconomic status filter; takes SAM business-type codes (e.g. "OY" Black American Owned, "A6" SBA-certified 8(a), "A2" Woman Owned — see `GET /api/business_types/`), not set-aside codes, and accepts pipe-separated values for OR semantics, e.g. ``socioeconomic="OY|A2"``
             state: State filter
             total_awards_obligated_gte: Total awards obligated >=
             total_awards_obligated_lte: Total awards obligated <=

{tango_python-1.5.0 → tango_python-1.5.1}/tests/test_client.py

@@ -1992,6 +1992,22 @@ class TestPscFilters:
         assert "has_awards" not in mock_request.call_args[1]["params"]
 
 
+class TestEntityFilters:
+    """The server ORs pipe-separated `socioeconomic` values; the SDK's job is to forward the string verbatim."""
+
+    @patch("tango.client.httpx.Client.request")
+    def test_list_entities_forwards_pipe_separated_socioeconomic(self, mock_request):
+        _stub_empty_page(mock_request)
+        TangoClient(api_key="test-key").list_entities(socioeconomic="OY|A2")
+        assert mock_request.call_args[1]["params"]["socioeconomic"] == "OY|A2"
+
+    @patch("tango.client.httpx.Client.request")
+    def test_list_entities_omits_unset_socioeconomic(self, mock_request):
+        _stub_empty_page(mock_request)
+        TangoClient(api_key="test-key").list_entities()
+        assert "socioeconomic" not in mock_request.call_args[1]["params"]
+
+
 class TestAgencyFilterDiagnostics:
     """`meta` from the API's agency-filter diagnostics.
 

tango_python-1.5.0/.github/workflows/docs-dispatch.yml

@@ -1,58 +0,0 @@
-name: Docs dispatch
-
-# Fires on push to main when content that affects the published docs site
-# changes (docs/, README, or CHANGELOG). Notifies makegov/docs via
-# repository_dispatch so the docs site rebuilds without waiting for someone
-# to push to the composer.
-#
-# tango-python is a `coloc-source` repo: its docs/ folder is the authoritative
-# source for the Python SDK pages on docs.makegov.com (see makegov/docs#15).
-#
-# Required secrets:
-#   DOCS_DISPATCH_TOKEN — GitHub token with contents:write on makegov/docs.
-#
-# Required variables (optional):
-#   DOCS_TARGET_REPO — override the dispatch target (default: makegov/docs).
-
-on:
-  push:
-    branches:
-      - main
-    paths:
-      - "docs/**"
-      - "README.md"
-      - "CHANGELOG.md"
-  workflow_dispatch:
-
-jobs:
-  dispatch:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-    steps:
-      - uses: actions/checkout@v6
-        with:
-          fetch-depth: 2
-
-      - name: Detect changed paths
-        id: changes
-        run: |
-          set -euo pipefail
-          base=$(git rev-parse HEAD~1 2>/dev/null || git rev-parse HEAD)
-          external=$(git diff --name-only "$base" HEAD -- 'docs' 'README.md' 'CHANGELOG.md' | paste -sd, -)
-          {
-            echo "external=$external"
-            echo "has_external=$([ -n "$external" ] && echo true || echo false)"
-          } >> "$GITHUB_OUTPUT"
-
-      - name: Dispatch to docs composer (makegov/docs)
-        if: steps.changes.outputs.has_external == 'true'
-        env:
-          GH_TOKEN: ${{ secrets.DOCS_DISPATCH_TOKEN }}
-          TARGET: ${{ vars.DOCS_TARGET_REPO || 'makegov/docs' }}
-        run: |
-          gh api "repos/$TARGET/dispatches" \
-            -f event_type=external_updated \
-            -f "client_payload[source_repo]=${{ github.repository }}" \
-            -f "client_payload[source_ref]=${{ github.sha }}" \
-            -f "client_payload[changed_paths]=${{ steps.changes.outputs.external }}"

tango_python-1.5.0/.github/workflows/lint.yml

@@ -1,110 +0,0 @@
-name: Linting
-
-# Lint gate runs on every PR and push to main.
-#
-# - ruff format + ruff check are HARD gates (block the PR).
-# - mypy is a HARD gate: the package type-checks cleanly under strict mypy.
-#   (The earlier ~28-error burn-down is complete.)
-# - The SDK filter/shape conformance check is a HARD gate: it runs against the
-#   vendored contract at contracts/filter_shape_contract.json on every run (no
-#   secrets needed, works on forks). A second, token-gated step compares the
-#   vendored contract against the tango repo's HEAD and emits a staleness
-#   notice (never a failure — tango HEAD may carry unreleased changes).
-#   Refresh the vendored contract with scripts/refresh_contract.py.
-# - Reverse shape-coverage is a HARD gate: check_shape_coverage.py fails when
-#   Tango's shape trees expose a field/expand the SDK schema doesn't capture and
-#   it isn't in contracts/shape_coverage_baseline.json. Also offline (vendored
-#   contract), so it runs on forks. Burn the baseline down with the generator.
-on:
-  workflow_dispatch:
-  push:
-    branches: [ main ]
-  pull_request:
-    branches: [ main ]
-
-jobs:
-  lint:
-    runs-on: ubuntu-latest
-
-    steps:
-    - uses: actions/checkout@v6
-
-    - name: Install uv
-      uses: astral-sh/setup-uv@v8.1.0
-      with:
-        version: "latest"
-
-    - name: Set up Python
-      run: uv python install 3.12
-
-    - name: Install dependencies
-      run: uv sync --all-extras
-
-    - name: Check formatting with ruff
-      run: uv run ruff format --check tango/
-
-    - name: Lint with ruff
-      run: uv run ruff check tango/
-
-    - name: Type check with mypy
-      run: uv run mypy tango/
-
-  conformance:
-    # Hard gate against the vendored contract (contracts/filter_shape_contract.json).
-    # Runs unconditionally — no secrets required, so forks and tokenless runs
-    # get the full check instead of a silent skip.
-    runs-on: ubuntu-latest
-
-    steps:
-    - uses: actions/checkout@v6
-
-    - name: Install uv
-      uses: astral-sh/setup-uv@v8.1.0
-      with:
-        version: "latest"
-
-    - name: Set up Python
-      run: uv python install 3.12
-
-    - name: Install dependencies
-      run: uv sync --all-extras
-
-    - name: Check SDK filter/shape conformance (vendored contract)
-      run: uv run python scripts/check_filter_shape_conformance.py
-
-    - name: Check reverse shape coverage (Tango exposes -> SDK captures)
-      # Complements the conformance check with the OTHER direction: fails when
-      # Tango's shape trees expose a field/expand the SDK schema doesn't capture
-      # and it isn't in contracts/shape_coverage_baseline.json. Also offline
-      # against the vendored contract — no secrets, works on forks.
-      run: uv run python scripts/check_shape_coverage.py
-
-    # --- Staleness notice (best-effort, never fails the job) ---------------
-    - name: Determine token availability
-      id: gate
-      env:
-        TANGO_API_REPO_ACCESS_TOKEN: ${{ secrets.TANGO_API_REPO_ACCESS_TOKEN }}
-      run: |
-        if [ -n "$TANGO_API_REPO_ACCESS_TOKEN" ]; then
-          echo "ready=true" >> "$GITHUB_OUTPUT"
-        else
-          echo "ready=false" >> "$GITHUB_OUTPUT"
-          echo "::notice::Contract staleness check skipped — TANGO_API_REPO_ACCESS_TOKEN not configured."
-        fi
-
-    - name: Checkout tango API repo (contract source)
-      if: steps.gate.outputs.ready == 'true'
-      uses: actions/checkout@v6
-      with:
-        repository: makegov/tango
-        path: tango-api
-        token: ${{ secrets.TANGO_API_REPO_ACCESS_TOKEN }}
-
-    - name: Compare vendored contract against tango HEAD
-      if: steps.gate.outputs.ready == 'true'
-      run: |
-        if ! diff -q contracts/filter_shape_contract.json tango-api/contracts/filter_shape_contract.json >/dev/null; then
-          echo "::warning::Vendored contract differs from makegov/tango HEAD. Refresh with: uv run python scripts/refresh_contract.py"
-        else
-          echo "Vendored contract matches makegov/tango HEAD."
-        fi

tango_python-1.5.0/.github/workflows/publish.yml

@@ -1,29 +0,0 @@
-name: Publish to PyPI
-
-on:
-  release:
-    types: [published]
-  workflow_dispatch:
-
-jobs:
-  build-and-publish:
-    runs-on: ubuntu-latest
-    
-    steps:
-    - uses: actions/checkout@v6
-    
-    - name: Install uv
-      uses: astral-sh/setup-uv@v8.1.0
-      with:
-        version: 'latest'
-    
-    - name: Set up Python
-      run: uv python install 3.12
-    
-    - name: Build package
-      run: uv build
-    
-    - name: Publish to PyPI
-      env:
-        UV_PUBLISH_TOKEN: ${{ secrets.TANGO_PYPI_TOKEN }}
-      run: uv publish

tango_python-1.5.0/.github/workflows/test.yml

@@ -1,44 +0,0 @@
-name: Tests
-
-on:
-  push:
-    branches: [ main, develop ]
-  pull_request:
-    branches: [ main, develop ]
-
-jobs:
-  test:
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ubuntu-latest, macos-latest, windows-latest]
-        python-version: ["3.12", "3.13"]
-
-    steps:
-    - name: Enable Git long paths (Windows)
-      if: matrix.os == 'windows-latest'
-      run: git config --global core.longpaths true
-    
-    - uses: actions/checkout@v6
-    
-    - name: Install uv
-      uses: astral-sh/setup-uv@v8.1.0
-      with:
-        version: "latest"
-    
-    - name: Set up Python ${{ matrix.python-version }}
-      run: uv python install ${{ matrix.python-version }}
-    
-    - name: Install dependencies
-      run: uv sync --all-extras
-    
-    - name: Test with pytest
-      run: uv run pytest
-    
-    - name: Upload coverage to Codecov
-      uses: codecov/codecov-action@v5
-      with:
-        files: ./coverage.xml
-        flags: unittests
-        name: codecov-${{ matrix.os }}-py${{ matrix.python-version }}