productmapper 1.2.1__py3-none-any.whl

productmapper/__init__.py

@@ -0,0 +1,70 @@
+"""Official Python client for the ProductMapper API.
+
+Resolve a UPC, EAN, GTIN, ASIN or free-text title into a live Amazon catalog listing.
+
+    from productmapper import ProductMapper
+
+    client = ProductMapper(api_key="pm_live_...")
+    result = client.lookup(value="079361039905", type="UPC")
+    print(result.title, result.price)
+
+See https://product-mapper.com/docs for the full API reference.
+"""
+
+from ._version import __version__
+from .client import DEFAULT_BASE_URL, AsyncProductMapper, ProductMapper
+from .exceptions import (
+    AuthenticationError,
+    ConnectionError,
+    CreditsExhaustedError,
+    JobFailedError,
+    NotFoundError,
+    PermissionError,
+    ProductMapperError,
+    RateLimitError,
+    ServerError,
+    TimeoutError,
+    ValidationError,
+)
+from .models import (
+    IDENTIFIER_TYPES,
+    REGIONS,
+    AmazonListing,
+    BatchItem,
+    BatchJob,
+    HistoryPage,
+    HistoryRow,
+    JobStatus,
+    ListingIdentifiers,
+    MappingResult,
+    QueuedLookup,
+)
+
+__all__ = [
+    "DEFAULT_BASE_URL",
+    "IDENTIFIER_TYPES",
+    "REGIONS",
+    "AmazonListing",
+    "AsyncProductMapper",
+    "AuthenticationError",
+    "BatchItem",
+    "BatchJob",
+    "ConnectionError",
+    "CreditsExhaustedError",
+    "HistoryPage",
+    "HistoryRow",
+    "JobFailedError",
+    "JobStatus",
+    "ListingIdentifiers",
+    "MappingResult",
+    "NotFoundError",
+    "PermissionError",
+    "ProductMapper",
+    "ProductMapperError",
+    "QueuedLookup",
+    "RateLimitError",
+    "ServerError",
+    "TimeoutError",
+    "ValidationError",
+    "__version__",
+]

productmapper/_version.py

@@ -0,0 +1,21 @@
+"""Single source of truth for the package version.
+
+The version is declared once, in ``pyproject.toml``, and read back from the installed
+package metadata at import time. Nothing else in the codebase hardcodes it, so a release
+cannot ship a User-Agent or ``__version__`` that disagrees with the published version.
+
+The fallback only matters when the package is imported from a source tree that was never
+installed (for example a plain ``sys.path`` manipulation), where no metadata exists.
+"""
+
+from __future__ import annotations
+
+from importlib.metadata import PackageNotFoundError
+from importlib.metadata import version as _metadata_version
+
+__all__ = ["__version__"]
+
+try:
+    __version__: str = _metadata_version("productmapper")
+except PackageNotFoundError:  # pragma: no cover - only hit in an uninstalled source tree
+    __version__ = "0.0.0.dev0"