cardog 2.3.0__tar.gz → 2.4.0__tar.gz

{cardog-2.3.0 → cardog-2.4.0}/CHANGELOG.md

@@ -2,11 +2,30 @@
 
 All notable changes to the Cardog Python SDK will be documented in this file.
 
-The SDK's major version tracks the API's major version. A contract change
-inside API 2.x, breaking or not, is a minor bump here and names the API
-pre-release it tracks. 3.0.0, published to PyPI on 2026-09-28, broke that
-rule and is yanked: `pip install cardog` no longer resolves to it, and a
-pin on `==3.0.0` still installs. Everything it carried is in 2.1.0.
+The SDK's version follows the API version it pins. A release that pins a
+new API date is a major, so a range like `cardog>=2.4,<3` never crosses a
+breaking API version; additive changes are minors and fixes are patches. The major
+is never below the API's path major (`/v2` → 2). The first pin, 2.4.0, was
+a minor. Before general availability a contract change inside API 2.x was
+a minor bump that named the API pre-release it tracked. 3.0.0, published
+to PyPI on 2026-09-28, broke that rule and is yanked: `pip install cardog`
+no longer resolves to it, and a pin on `==3.0.0` still installs. Everything
+it carried is in 2.1.0.
+
+## [2.4.0] - 2026-10-21
+
+Pins API `2026-10-21`, the general availability of API 2.0 (CRDG-4356).
+The response shapes are the ones 2.3.0 parses (2.0.0-rc.8), so nothing else
+changes.
+
+### Changed
+
+- `cardog.PINNED_API_VERSION` is `"2026-10-21"`, and every v2 request now
+  sends `Cardog-Version: 2026-10-21`. `KNOWN_API_VERSIONS` is
+  `("2026-10-21",)`.
+- The vendored OpenAPI document reports `info.version` `2026-10-21`.
+- A release that pins a new API date from here on is a major: the next
+  breaking API version ships as 3.0.0.
 
 ## [2.3.0] - 2026-10-15
 

{cardog-2.3.0 → cardog-2.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: cardog
-Version: 2.3.0
+Version: 2.4.0
 Summary: Python SDK for the Cardog API — Canadian VIN decode, vehicle specs, live listings, market quotes, and Transport Canada + NHTSA recalls.
 Project-URL: Homepage, https://cardog.app
 Project-URL: Documentation, https://cardog.app/docs

{cardog-2.3.0 → cardog-2.4.0}/openapi/openapi.v2.json

@@ -2,15 +2,17 @@
   "openapi": "3.0.3",
   "info": {
     "title": "Cardog API v2",
-    "version": "2.0.0-rc.8",
+    "version": "2026-10-21",
     "description": "VIN identity, canonical specs, live market data, and recalls — one key.\n\n**The ref is the API.** Every parameter is an entity ref (`make:tesla`, `model-year:honda/cr-v/2026`) or a VIN; every response carries refs plus `links` to adjacent resources. Free text is accepted in exactly one place — `GET /v2/entities/resolve` — and returns refs with confidence, never silently fuzzed results.\n\n**Errors are instructions.** Every non-2xx body is the ErrorEnvelope: `code`, `message`, `hint`, `docs_url`, the offending `refs` named, and nearest-ref `suggestions` where computable.\n\n**Price is machine-readable.** `GET /v2/pricing` is the live rate card; every metered response carries `X-Credits-*` headers.",
     "contact": {
       "name": "Cardog",
       "url": "https://cardog.app",
       "email": "api@cardog.io"
     },
-    "x-cardog-api-versions": [],
-    "x-cardog-latest-version": null
+    "x-cardog-api-versions": [
+      "2026-10-21"
+    ],
+    "x-cardog-latest-version": "2026-10-21"
   },
   "servers": [
     {

{cardog-2.3.0 → cardog-2.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "cardog"
-version = "2.3.0"
+version = "2.4.0"
 description = "Python SDK for the Cardog API — Canadian VIN decode, vehicle specs, live listings, market quotes, and Transport Canada + NHTSA recalls."
 readme = "README.md"
 license = "MIT"

{cardog-2.3.0 → cardog-2.4.0}/src/cardog/_constants.py

@@ -1,4 +1,4 @@
-SDK_VERSION = "2.3.0"
+SDK_VERSION = "2.4.0"
 
 # v1 default — kept for compatibility with existing consumers. v2 requests are
 # issued against the ORIGIN (a trailing "/v1" is stripped), so this default

{cardog-2.3.0 → cardog-2.4.0}/src/cardog/v2/_api_version.py

@@ -9,7 +9,7 @@ from __future__ import annotations
 from typing import Optional, Tuple
 
 #: The dated contract versions the API served when this SDK was generated.
-KNOWN_API_VERSIONS: Tuple[str, ...] = ()
+KNOWN_API_VERSIONS: Tuple[str, ...] = ('2026-10-21',)
 
 #: Sent as ``Cardog-Version`` on every v2 request unless ``api_version`` overrides it.
-PINNED_API_VERSION: Optional[str] = None
+PINNED_API_VERSION: Optional[str] = '2026-10-21'

{cardog-2.3.0 → cardog-2.4.0}/tests/v2/test_v2_urls.py

@@ -230,8 +230,8 @@ def test_headers_api_key_and_sdk_version(httpx_mock, client):
     client.v2.recalls.stats()
     request = httpx_mock.get_requests()[-1]
     assert request.headers["x-api-key"] == "crdg_test"
-    assert request.headers["x-cardog-sdk-version"] == "2.3.0"
-    assert request.headers["user-agent"] == "cardog-python/2.3.0"
+    assert request.headers["x-cardog-sdk-version"] == "2.4.0"
+    assert request.headers["user-agent"] == "cardog-python/2.4.0"
 
 
 def test_unauthenticated_client_sends_no_api_key(httpx_mock):

{cardog-2.3.0 → cardog-2.4.0}/tests/v2/test_v2_version.py

@@ -3,7 +3,8 @@
 Every v2 request carries ``Cardog-Version``: the ``api_version`` the client
 was built with, else ``PINNED_API_VERSION`` (generated from the vendored
 OpenAPI document), else nothing. Before the API's general availability the
-pin is ``None``, so a default client sends no version and gets the latest.
+pin was ``None`` and a default client sent no version; from GA it is the GA
+date.
 """
 
 from __future__ import annotations
@@ -34,15 +35,15 @@ def test_the_pin_is_generated_from_the_vendored_spec():
     assert list(KNOWN_API_VERSIONS) == info["x-cardog-api-versions"]
 
 
-def test_the_pin_is_none_before_general_availability():
-    assert KNOWN_API_VERSIONS == ()
-    assert PINNED_API_VERSION is None
+def test_the_pin_is_the_newest_date_ga_day_at_first():
+    assert KNOWN_API_VERSIONS[0] == "2026-10-21"
+    assert PINNED_API_VERSION == KNOWN_API_VERSIONS[-1]
 
 
-def test_a_default_client_sends_no_version_before_ga(httpx_mock, client):
+def test_a_default_client_sends_the_pinned_date(httpx_mock, client):
     httpx_mock.add_response(json=minimal_component("VinIdentity"))
     client.v2.vin.get_by_vin(VIN)
-    assert "cardog-version" not in httpx_mock.get_request().headers
+    assert httpx_mock.get_request().headers["cardog-version"] == PINNED_API_VERSION
 
 
 def test_api_version_rides_every_v2_request(httpx_mock):