cnovatech-datamarket 0.1.0__tar.gz

cnovatech_datamarket-0.1.0/.gitignore

@@ -0,0 +1,26 @@
+# Environments and secrets
+.venv/
+.venv-*/
+.env
+.env.*
+!.env.example
+
+# Build output
+dist/
+build/
+*.egg-info/
+
+# Tool caches
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+coverage.xml
+htmlcov/
+__pycache__/
+*.pyc
+
+# Editors and OS
+.idea/
+.vscode/
+.DS_Store

cnovatech_datamarket-0.1.0/CHANGELOG.md

@@ -0,0 +1,49 @@
+# Changelog
+
+All notable changes to `cnovatech-datamarket` are documented here. The format
+follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the
+project uses [Semantic Versioning](https://semver.org/).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-11-06
+
+First release. Rehearsed on TestPyPI as 0.1.0.dev1.
+
+### Added
+
+- `DataMarket` and `AsyncDataMarket` clients with configuration from arguments
+  or `DATAMARKET_API_KEY` / `DATAMARKET_BASE_URL`, connection pooling, context
+  manager support and a `repr` that masks the key. `max_retries` and
+  `max_units_per_request` are enforced by the shared core. A client can be
+  shared between threads; responses, pages and exceptions can be pickled.
+- `health()` on both clients: unauthenticated, free of quota cost, and
+  tolerant of changes in the unversioned health body.
+- Resources covering every read endpoint of the API: `products` (`catalog`,
+  `departments`, `brands`, `by_brand`, `get`, `price_history`, `coverage`),
+  `stores` (`list`, `find`, `assortment`, `competitors`, `competitiveness`,
+  `compare`, `market_position`, `opportunities`), `brands.stores` and
+  `account` (`profile`, `usage`, `logs`, `api_keys`). Each method states its
+  quota cost and estimates it before sending. `coverage()` takes any
+  iterable of codes; store identifiers may be `uuid.UUID` objects.
+- Paginated responses (`CatalogPage`, `AssortmentPage`, ...) with
+  `next_page()`, `iter_pages()` and `iter_all()` capped by `max_pages` or
+  `max_units`, plus `estimate_remaining_cost()`.
+- `stores.find(name)`: reads up to five pages of results until an exact name
+  matches; `StoreNotFoundError` and `AmbiguousStoreError` with the
+  candidates otherwise. A blank name is refused before anything is sent.
+- `to_dataframe()` on every list response, with the `pandas` extra. An
+  envelope field that shares its name with a row field keeps its own column,
+  prefixed by the response's name (`product_image_url`).
+- `client.usage` (units spent through the client, last balance, refreshed
+  by quota errors too) and `client.rate_limit` (per-minute limit from the
+  API's headers).
+- `cnovatech.datamarket.errors` with `DataMarketError` as the root of every
+  exception the SDK raises, plus `EANNotFoundError`, `StoreNotFoundError`,
+  `FilterRequiredError`, `AmbiguousStoreError` and `BudgetExceededError`.
+  Connection errors and timeouts carry the `correlation_id` of the request.
+- `cnovatech.datamarket.models`, one module per resource, and
+  `cnovatech.datamarket.types` with the input enumerations.
+- `__version__`, read from the installed package metadata.
+- Guides under `docs/`: quota and costs, pagination, errors and recipes.
+- Support for Python 3.10 to 3.15.

cnovatech_datamarket-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cnovatech
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cnovatech_datamarket-0.1.0/PKG-INFO

@@ -0,0 +1,235 @@
+Metadata-Version: 2.5
+Name: cnovatech-datamarket
+Version: 0.1.0
+Summary: Official Python SDK for the Cnovatech Data Market API: price, availability and assortment intelligence for Brazilian supermarkets.
+Project-URL: Homepage, https://datamarket.cnovatech.com.br
+Project-URL: Documentation, https://datamarket.cnovatech.com.br/redoc
+Project-URL: Repository, https://github.com/cnovatech-br/sdks
+Project-URL: Changelog, https://github.com/cnovatech-br/sdks/blob/main/datamarket-python/CHANGELOG.md
+Author-email: Cnovatech <suporte@cnovatech.com.br>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: api,assortment,cnovatech,data market,datamarket,ean,pricing,retail,sdk,supermarket
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Topic :: Office/Business
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: cnovatech-sdk-core<0.2,>=0.1.0
+Provides-Extra: pandas
+Requires-Dist: cnovatech-sdk-core[pandas]; extra == 'pandas'
+Description-Content-Type: text/markdown
+
+# cnovatech-datamarket
+
+Official Python SDK for the [Cnovatech Data Market](https://datamarket.cnovatech.com.br)
+API: daily prices, availability and assortment of more than 150,000 products
+across 240+ online supermarkets in 23 Brazilian states.
+
+- Synchronous and asynchronous clients with the same surface
+- Every response carries its quota cost; pagination can be capped by cost
+- Retries only where a repeat cannot be billed twice
+- Typed end to end: pydantic models, `py.typed`, `mypy --strict`
+
+> **Status: 0.x.** Every read endpoint of the API is implemented, validated
+> against production and tested offline against recorded responses. Until 1.0
+> a minor release may change the public surface; every such change is listed
+> in the
+> [changelog](https://github.com/cnovatech-br/sdks/blob/main/datamarket-python/CHANGELOG.md).
+
+## Installation
+
+```bash
+pip install cnovatech-datamarket
+```
+
+Add `[pandas]` for `to_dataframe()` on list responses. Python 3.10 or newer.
+
+## Quick start
+
+```python
+from cnovatech.datamarket import DataMarket
+
+client = DataMarket()  # reads DATAMARKET_API_KEY
+
+product = client.products.get("7894900011517", state="SP")
+
+product.product_name  # "Refrigerante Coca-Cola 2L"
+product.market.median_price  # 9.49
+product.offers[0].store_name  # "Supermercado Modelo"
+product.offers[0].price  # 8.99
+product.offers[0].available  # True
+
+product.usage.query_cost  # 1
+product.usage.remaining  # 994
+```
+
+Get a key at <https://datamarket.cnovatech.com.br>. `client.health()` checks
+the API without a key and without cost.
+
+The first lookup of a product the API has not cached yet can take up to 90
+seconds; after that it answers in under a second. The default timeout allows
+for it.
+
+## Quota
+
+Every call is billed in quota units, and every response says what it cost:
+
+```python
+page = client.products.catalog(search="azeite", limit=50)
+page.usage.query_cost  # 1
+page.usage.remaining  # 993
+client.usage.spent  # 2, through this client
+```
+
+Paginated responses can be walked page by page or item by item, with a ceiling
+on how much to spend:
+
+```python
+position = client.stores.market_position(store_id, limit=1000)  # 8 units per page
+position.meta.pages  # 4
+position.estimate_remaining_cost()  # 24, for the three pages not fetched yet
+
+items = list(position.iter_all(max_units=40))
+items[0].product_name  # "Azeite Extra Virgem 500ml"
+items[0].price_position  # "above"
+```
+
+`iter_all` never requests again the page you already paid for. It stops quietly
+at `max_pages` and raises `BudgetExceededError` before a page that would cross
+`max_units`. To refuse any single call above a budget, build the client with
+`DataMarket(max_units_per_request=20)`.
+
+## Stores and competitors
+
+```python
+store = client.stores.find("Supermercado Modelo", state="SP")  # 1 unit
+store.store_id  # "0f8c7d2e-6b1a-4f3e-9c5d-2a7b8e1f4c63"
+
+competitors = client.stores.competitors(store.store_id, limit=5)  # 1 unit each
+competitors.data[0].store_name  # "Mercado Vizinho"
+competitors.data[0].overlap_pct  # 62.5, share of the assortment in common
+
+comparison = client.stores.compare(store.store_id, competitors.data[0].store_id)
+comparison.data[0].product_name  # "Azeite Extra Virgem 500ml"
+comparison.data[0].price_position  # "above"
+comparison.data[0].price_diff_pct  # 12.3
+```
+
+## Errors
+
+```python
+from cnovatech.datamarket import DataMarket, errors
+
+client = DataMarket()
+
+try:
+    product = client.products.get("0000000000000")
+except errors.EANNotFoundError as exc:
+    exc.hint  # what the API suggests doing next
+except errors.QuotaExceededError as exc:
+    exc.code  # "monthly_limit_exceeded"
+    exc.upgrade_url  # where to change plan
+except errors.APITimeoutError:
+    ...  # may have been billed; check client.account.usage() before repeating
+except errors.DataMarketError as exc:
+    str(exc)  # "HTTP 503 service_unavailable: ... [correlation_id=...]"; never the key
+```
+
+Connection errors, 502/503 and the per-minute 429 are retried with backoff.
+Read timeouts, 504 and quota errors never are: the request may already have
+been processed and billed.
+
+## Async
+
+```python
+import asyncio
+
+from cnovatech.datamarket import AsyncDataMarket
+
+
+async def main() -> None:
+    async with AsyncDataMarket() as client:
+        product = await client.products.get("7894900011517")
+        product.market.median_price  # 9.49
+
+
+asyncio.run(main())
+```
+
+## pandas
+
+```python
+assortment = client.stores.assortment(store.store_id, limit=1000)
+frame = assortment.to_dataframe()  # one row per item; usage and meta as columns
+```
+
+## Configuration
+
+| Argument | Environment variable | Default |
+|---|---|---|
+| `api_key` | `DATAMARKET_API_KEY` | required, except for `health()` |
+| `base_url` | `DATAMARKET_BASE_URL` | `https://datamarket.cnovatech.com.br` |
+| `timeout` | | 150 s read timeout; pass `httpx.Timeout` to set every phase. Applies per request, also through your own `http_client` |
+| `max_retries` | | 2 |
+| `max_units_per_request` | | no limit |
+| `http_client` | | your own `httpx.Client`, for proxies, certificates or a shared pool; never closed, redirects never followed |
+
+## Guides
+
+- [Quota and costs](https://github.com/cnovatech-br/sdks/blob/main/datamarket-python/docs/quota-and-costs.md): the tariff, what each response reports, estimates and caps.
+- [Pagination](https://github.com/cnovatech-br/sdks/blob/main/datamarket-python/docs/pagination.md): pages, walks, `max_pages` and `max_units`.
+- [Errors](https://github.com/cnovatech-br/sdks/blob/main/datamarket-python/docs/errors.md): the hierarchy, what is retried, how to handle each case.
+- [Recipes](https://github.com/cnovatech-br/sdks/blob/main/datamarket-python/docs/recipes.md): coverage of a list, competitors, exports to pandas, when to use `get` and when to export.
+
+## Logging
+
+The SDK logs through the standard `logging` module under the `cnovatech`
+namespace and installs no handler of its own. At DEBUG it records each request's
+method, path, status and duration; retries are logged at INFO, and a WARNING is
+emitted when the remaining quota drops below 10%. Keys, headers and bodies are
+never logged. The `httpx` logger, if the application enables it at INFO, prints
+the full URL with its query string; the key is sent as a header and is not in it.
+
+```python
+import logging
+
+logging.basicConfig(level=logging.INFO)
+logging.getLogger("cnovatech").setLevel(logging.DEBUG)
+```
+
+## Resources
+
+| Resource | Methods | Cost |
+|---|---|---|
+| `client.products` | `catalog`, `departments`, `brands`, `by_brand`, `get`, `price_history` | 1 unit |
+| | `coverage` | ceil(codes / 250) units; up to 500 codes per call |
+| `client.stores` | `list`, `find` | 1 unit |
+| | `competitors`, `competitiveness` | 1 unit per competitor |
+| | `assortment`, `compare`, `market_position`, `opportunities` | ceil(rows / 250) × 2 units per page |
+| `client.brands` | `stores` | 1 unit |
+| `client.account` | `profile`, `usage`, `logs`, `api_keys` | free |
+| `client` | `health`, `usage`, `rate_limit`, `close` | free |
+
+Each method's docstring states its cost. The API reference is at
+<https://datamarket.cnovatech.com.br/redoc>.
+
+## Support
+
+- Issues and feature requests: <https://github.com/cnovatech-br/sdks/issues>
+- Email: <suporte@cnovatech.com.br>
+
+## License
+
+[MIT](https://github.com/cnovatech-br/sdks/blob/main/LICENSE). The API terms
+of use are at <https://cnovatech.com.br/termos-de-uso>.

cnovatech_datamarket-0.1.0/README.md

@@ -0,0 +1,203 @@
+# cnovatech-datamarket
+
+Official Python SDK for the [Cnovatech Data Market](https://datamarket.cnovatech.com.br)
+API: daily prices, availability and assortment of more than 150,000 products
+across 240+ online supermarkets in 23 Brazilian states.
+
+- Synchronous and asynchronous clients with the same surface
+- Every response carries its quota cost; pagination can be capped by cost
+- Retries only where a repeat cannot be billed twice
+- Typed end to end: pydantic models, `py.typed`, `mypy --strict`
+
+> **Status: 0.x.** Every read endpoint of the API is implemented, validated
+> against production and tested offline against recorded responses. Until 1.0
+> a minor release may change the public surface; every such change is listed
+> in the
+> [changelog](https://github.com/cnovatech-br/sdks/blob/main/datamarket-python/CHANGELOG.md).
+
+## Installation
+
+```bash
+pip install cnovatech-datamarket
+```
+
+Add `[pandas]` for `to_dataframe()` on list responses. Python 3.10 or newer.
+
+## Quick start
+
+```python
+from cnovatech.datamarket import DataMarket
+
+client = DataMarket()  # reads DATAMARKET_API_KEY
+
+product = client.products.get("7894900011517", state="SP")
+
+product.product_name  # "Refrigerante Coca-Cola 2L"
+product.market.median_price  # 9.49
+product.offers[0].store_name  # "Supermercado Modelo"
+product.offers[0].price  # 8.99
+product.offers[0].available  # True
+
+product.usage.query_cost  # 1
+product.usage.remaining  # 994
+```
+
+Get a key at <https://datamarket.cnovatech.com.br>. `client.health()` checks
+the API without a key and without cost.
+
+The first lookup of a product the API has not cached yet can take up to 90
+seconds; after that it answers in under a second. The default timeout allows
+for it.
+
+## Quota
+
+Every call is billed in quota units, and every response says what it cost:
+
+```python
+page = client.products.catalog(search="azeite", limit=50)
+page.usage.query_cost  # 1
+page.usage.remaining  # 993
+client.usage.spent  # 2, through this client
+```
+
+Paginated responses can be walked page by page or item by item, with a ceiling
+on how much to spend:
+
+```python
+position = client.stores.market_position(store_id, limit=1000)  # 8 units per page
+position.meta.pages  # 4
+position.estimate_remaining_cost()  # 24, for the three pages not fetched yet
+
+items = list(position.iter_all(max_units=40))
+items[0].product_name  # "Azeite Extra Virgem 500ml"
+items[0].price_position  # "above"
+```
+
+`iter_all` never requests again the page you already paid for. It stops quietly
+at `max_pages` and raises `BudgetExceededError` before a page that would cross
+`max_units`. To refuse any single call above a budget, build the client with
+`DataMarket(max_units_per_request=20)`.
+
+## Stores and competitors
+
+```python
+store = client.stores.find("Supermercado Modelo", state="SP")  # 1 unit
+store.store_id  # "0f8c7d2e-6b1a-4f3e-9c5d-2a7b8e1f4c63"
+
+competitors = client.stores.competitors(store.store_id, limit=5)  # 1 unit each
+competitors.data[0].store_name  # "Mercado Vizinho"
+competitors.data[0].overlap_pct  # 62.5, share of the assortment in common
+
+comparison = client.stores.compare(store.store_id, competitors.data[0].store_id)
+comparison.data[0].product_name  # "Azeite Extra Virgem 500ml"
+comparison.data[0].price_position  # "above"
+comparison.data[0].price_diff_pct  # 12.3
+```
+
+## Errors
+
+```python
+from cnovatech.datamarket import DataMarket, errors
+
+client = DataMarket()
+
+try:
+    product = client.products.get("0000000000000")
+except errors.EANNotFoundError as exc:
+    exc.hint  # what the API suggests doing next
+except errors.QuotaExceededError as exc:
+    exc.code  # "monthly_limit_exceeded"
+    exc.upgrade_url  # where to change plan
+except errors.APITimeoutError:
+    ...  # may have been billed; check client.account.usage() before repeating
+except errors.DataMarketError as exc:
+    str(exc)  # "HTTP 503 service_unavailable: ... [correlation_id=...]"; never the key
+```
+
+Connection errors, 502/503 and the per-minute 429 are retried with backoff.
+Read timeouts, 504 and quota errors never are: the request may already have
+been processed and billed.
+
+## Async
+
+```python
+import asyncio
+
+from cnovatech.datamarket import AsyncDataMarket
+
+
+async def main() -> None:
+    async with AsyncDataMarket() as client:
+        product = await client.products.get("7894900011517")
+        product.market.median_price  # 9.49
+
+
+asyncio.run(main())
+```
+
+## pandas
+
+```python
+assortment = client.stores.assortment(store.store_id, limit=1000)
+frame = assortment.to_dataframe()  # one row per item; usage and meta as columns
+```
+
+## Configuration
+
+| Argument | Environment variable | Default |
+|---|---|---|
+| `api_key` | `DATAMARKET_API_KEY` | required, except for `health()` |
+| `base_url` | `DATAMARKET_BASE_URL` | `https://datamarket.cnovatech.com.br` |
+| `timeout` | | 150 s read timeout; pass `httpx.Timeout` to set every phase. Applies per request, also through your own `http_client` |
+| `max_retries` | | 2 |
+| `max_units_per_request` | | no limit |
+| `http_client` | | your own `httpx.Client`, for proxies, certificates or a shared pool; never closed, redirects never followed |
+
+## Guides
+
+- [Quota and costs](https://github.com/cnovatech-br/sdks/blob/main/datamarket-python/docs/quota-and-costs.md): the tariff, what each response reports, estimates and caps.
+- [Pagination](https://github.com/cnovatech-br/sdks/blob/main/datamarket-python/docs/pagination.md): pages, walks, `max_pages` and `max_units`.
+- [Errors](https://github.com/cnovatech-br/sdks/blob/main/datamarket-python/docs/errors.md): the hierarchy, what is retried, how to handle each case.
+- [Recipes](https://github.com/cnovatech-br/sdks/blob/main/datamarket-python/docs/recipes.md): coverage of a list, competitors, exports to pandas, when to use `get` and when to export.
+
+## Logging
+
+The SDK logs through the standard `logging` module under the `cnovatech`
+namespace and installs no handler of its own. At DEBUG it records each request's
+method, path, status and duration; retries are logged at INFO, and a WARNING is
+emitted when the remaining quota drops below 10%. Keys, headers and bodies are
+never logged. The `httpx` logger, if the application enables it at INFO, prints
+the full URL with its query string; the key is sent as a header and is not in it.
+
+```python
+import logging
+
+logging.basicConfig(level=logging.INFO)
+logging.getLogger("cnovatech").setLevel(logging.DEBUG)
+```
+
+## Resources
+
+| Resource | Methods | Cost |
+|---|---|---|
+| `client.products` | `catalog`, `departments`, `brands`, `by_brand`, `get`, `price_history` | 1 unit |
+| | `coverage` | ceil(codes / 250) units; up to 500 codes per call |
+| `client.stores` | `list`, `find` | 1 unit |
+| | `competitors`, `competitiveness` | 1 unit per competitor |
+| | `assortment`, `compare`, `market_position`, `opportunities` | ceil(rows / 250) × 2 units per page |
+| `client.brands` | `stores` | 1 unit |
+| `client.account` | `profile`, `usage`, `logs`, `api_keys` | free |
+| `client` | `health`, `usage`, `rate_limit`, `close` | free |
+
+Each method's docstring states its cost. The API reference is at
+<https://datamarket.cnovatech.com.br/redoc>.
+
+## Support
+
+- Issues and feature requests: <https://github.com/cnovatech-br/sdks/issues>
+- Email: <suporte@cnovatech.com.br>
+
+## License
+
+[MIT](https://github.com/cnovatech-br/sdks/blob/main/LICENSE). The API terms
+of use are at <https://cnovatech.com.br/termos-de-uso>.

cnovatech_datamarket-0.1.0/pyproject.toml

@@ -0,0 +1,98 @@
+[project]
+name = "cnovatech-datamarket"
+version = "0.1.0"
+description = "Official Python SDK for the Cnovatech Data Market API: price, availability and assortment intelligence for Brazilian supermarkets."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Cnovatech", email = "suporte@cnovatech.com.br" }]
+keywords = [
+    "cnovatech", "datamarket", "data market", "pricing", "retail",
+    "supermarket", "assortment", "ean", "sdk", "api",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Natural Language :: English",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
+    "Topic :: Office/Business",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+# The core and this package are released together; the pin follows the core's
+# minor series and moves with every release.
+dependencies = [
+    "cnovatech-sdk-core>=0.1.0,<0.2",
+]
+
+[project.optional-dependencies]
+pandas = ["cnovatech-sdk-core[pandas]"]
+
+[project.urls]
+Homepage = "https://datamarket.cnovatech.com.br"
+Documentation = "https://datamarket.cnovatech.com.br/redoc"
+Repository = "https://github.com/cnovatech-br/sdks"
+Changelog = "https://github.com/cnovatech-br/sdks/blob/main/datamarket-python/CHANGELOG.md"
+
+[tool.uv.sources]
+cnovatech-sdk-core = { workspace = true }
+
+[build-system]
+requires = ["hatchling>=1.27,<2"]
+build-backend = "hatchling.build"
+
+# `src/cnovatech/` has no __init__.py on purpose: it is a PEP 420 namespace
+# shared with `cnovatech-sdk-core` and the other product SDKs.
+[tool.hatch.build.targets.wheel]
+packages = ["src/cnovatech"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src", "tests", "README.md", "CHANGELOG.md", "LICENSE", "pyproject.toml"]
+
+[tool.mypy]
+python_version = "3.10"
+files = ["src", "tests"]
+mypy_path = "src:../core/src:tests"
+strict = true
+warn_unreachable = true
+namespace_packages = true
+explicit_package_bases = true
+plugins = ["pydantic.mypy"]
+
+[tool.pydantic-mypy]
+init_forbid_extra = true
+init_typed = true
+warn_required_dynamic_aliases = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+addopts = "-q --strict-markers --strict-config"
+markers = [
+    "live: calls the real API; needs --live and only touches free endpoints.",
+]
+filterwarnings = ["error"]
+
+[tool.coverage.run]
+source = ["src/cnovatech/datamarket"]
+branch = true
+
+[tool.coverage.report]
+fail_under = 90
+show_missing = true
+exclude_also = [
+    "if TYPE_CHECKING:",
+    "if sys.version_info",
+    "@overload",
+    "raise NotImplementedError",
+    "\\.\\.\\.$",
+]

cnovatech_datamarket-0.1.0/src/cnovatech/datamarket/__init__.py

@@ -0,0 +1,20 @@
+"""Official Python SDK for the Cnovatech Data Market API.
+
+Typical use::
+
+    from cnovatech.datamarket import DataMarket
+
+    with DataMarket() as client:  # reads DATAMARKET_API_KEY
+        product = client.products.get("7894900011517", state="SP")
+        print(product.market.median_price, product.usage.remaining)
+
+``AsyncDataMarket`` offers the same surface with coroutines.
+"""
+
+from __future__ import annotations
+
+from . import errors, models, types
+from ._client import AsyncDataMarket, DataMarket
+from ._version import __version__
+
+__all__ = ["AsyncDataMarket", "DataMarket", "__version__", "errors", "models", "types"]