keepa 1.3.8__tar.gz → 1.3.9__tar.gz

{keepa-1.3.8 → keepa-1.3.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: keepa
-Version: 1.3.8
+Version: 1.3.9
 Summary: Interfaces with keepa.com's API.
 Keywords: keepa
 Author-email: Alex Kaszynski <akascap@gmail.com>
@@ -17,9 +17,8 @@ Classifier: Programming Language :: Python :: 3.12
 Requires-Dist: numpy >=1.9.3
 Requires-Dist: requests >=2.2
 Requires-Dist: tqdm
-Requires-Dist: aiohttp; python_version!='3.12.*'
-Requires-Dist: aiohttp==3.9.0b0; python_version=='3.12.*'
-Requires-Dist: pandas
+Requires-Dist: aiohttp
+Requires-Dist: pandas <= 3.0
 Requires-Dist: sphinx==6.1.2 ; extra == "doc"
 Requires-Dist: pydata-sphinx-theme==0.14.2 ; extra == "doc"
 Requires-Dist: matplotlib ; extra == "test"
@@ -328,7 +327,6 @@ Unit testing will automatically enforce minimum code coverage standards.
 
 Next, to ensure your code meets minimum code styling standards, run::
 
-  pip install pre-commit
   pre-commit run --all-files
 
 Finally, `create a pull request`_ from your fork and I'll be sure to review it.

{keepa-1.3.8 → keepa-1.3.9}/README.rst

@@ -294,7 +294,6 @@ Unit testing will automatically enforce minimum code coverage standards.
 
 Next, to ensure your code meets minimum code styling standards, run::
 
-  pip install pre-commit
   pre-commit run --all-files
 
 Finally, `create a pull request`_ from your fork and I'll be sure to review it.

{keepa-1.3.8 → keepa-1.3.9}/pyproject.toml

@@ -26,9 +26,8 @@ dependencies = [
     "numpy >=1.9.3",
     "requests >=2.2",
     "tqdm",
-    "aiohttp; python_version!='3.12.*'",
-    "aiohttp==3.9.0b0; python_version=='3.12.*'",  # until aiohttp gets upgraded
-    "pandas",
+    "aiohttp",
+    "pandas <= 3.0",
 ]
 
 [project.urls]
@@ -61,10 +60,5 @@ combine_as_imports = true
 
 [tool.ruff]
 line-length = 100
-
-[tool.ruff.lint]
-# Enable Pyflakes (`F`) and a subset of the pycodestyle (`E`)  codes by default.
-# Unlike Flake8, Ruff doesn't enable pycodestyle warnings (`W`) or
-# McCabe complexity (`C901`) by default.
-select = ["E4", "E7", "E9", "F"]
+select = ["E", "F", "W", "I001"]  # pyflakes, pycodestyle, isort
 ignore = []

{keepa-1.3.8 → keepa-1.3.9}/src/keepa/__init__.py

@@ -1,6 +1,6 @@
 """Keepaapi module."""
 
-__version__ = "1.3.8"
+__version__ = "1.3.9"
 from keepa.interface import (  # noqa: F401
     DCODES,
     KEEPA_ST_ORDINAL,

{keepa-1.3.8 → keepa-1.3.9}/src/keepa/interface.py

@@ -1,4 +1,5 @@
 """Interface module to download Amazon product and history data from keepa.com."""
+
 import asyncio
 import datetime
 import json
@@ -43,8 +44,8 @@ SCODES = {
 
 # domain codes
 # Valid values: [ 1: com | 2: co.uk | 3: de | 4: fr | 5:
-#                 co.jp | 6: ca | 7: cn | 8: it | 9: es | 10: in | 11: com.mx ]
-DCODES = ["RESERVED", "US", "GB", "DE", "FR", "JP", "CA", "CN", "IT", "ES", "IN", "MX"]
+#                 co.jp | 6: ca | 7: cn | 8: it | 9: es | 10: in | 11: com.mx | 12: com.br ]
+DCODES = ["RESERVED", "US", "GB", "DE", "FR", "JP", "CA", "CN", "IT", "ES", "IN", "MX", "BR"]
 
 # csv indices. used when parsing csv and stats fields.
 # https://github.com/keepacom/api_backend
@@ -505,9 +506,9 @@ class Keepa:
             timestamps (unix epoch time milliseconds) or two date
             strings (ISO8601, with or without time in UTC).
 
-        domain : str, optional
+        domain : str, default: "US"
             One of the following Amazon domains: RESERVED, US, GB, DE,
-            FR, JP, CA, CN, IT, ES, IN, MX Defaults to US.
+            FR, JP, CA, CN, IT, ES, IN, MX, BR.
 
         offers : int, optional
             Adds available offers to product data. Default 0.  Must be between
@@ -885,7 +886,7 @@ class Keepa:
 
         domain : str
             One of the following Amazon domains:
-            RESERVED, US, GB, DE, FR, JP, CA, CN, IT, ES, IN, MX
+            RESERVED, US, GB, DE, FR, JP, CA, CN, IT, ES, IN, MX, BR.
 
         offers : bool, optional
             Adds product offers to product data.
@@ -1021,10 +1022,9 @@ class Keepa:
             the best sellers list for. You can find category node ids
             via the category search "search_for_categories".
 
-        domain : str
-            Amazon locale you want to access. Must be one of the following
-            RESERVED, US, GB, DE, FR, JP, CA, CN, IT, ES, IN, MX
-            Default US.
+        domain : str, default: "US"
+            Amazon locale you want to access. Must be one of the following:
+            RESERVED, US, GB, DE, FR, JP, CA, CN, IT, ES, IN, MX, BR.
 
         wait : bool, optional
             Wait available token before doing effective query.
@@ -1077,7 +1077,10 @@ class Keepa:
         ...
 
         """
-        assert domain in DCODES, "Invalid domain code"
+        if domain not in DCODES:
+            raise ValueError(
+                f"Invalid domain code {domain}. Should be one of the following:\n{DCODES}"
+            )
 
         payload = {
             "key": self.accesskey,
@@ -1100,10 +1103,9 @@ class Keepa:
         searchterm : str
             Input search term.
 
-        domain : str, default: 'US'
-            Amazon locale you want to access. Must be one of the following
-            RESERVED, US, GB, DE, FR, JP, CA, CN, IT, ES, IN, MX
-            Default US.
+        domain : str, default: "US"
+            Amazon locale you want to access. Must be one of the following:
+            RESERVED, US, GB, DE, FR, JP, CA, CN, IT, ES, IN, MX, BR.
 
         wait : bool, default: True
             Wait available token before doing effective query.
@@ -1136,7 +1138,10 @@ class Keepa:
         144 Science Fiction & Fantasy
 
         """
-        assert domain in DCODES, "Invalid domain code"
+        if domain not in DCODES:
+            raise ValueError(
+                f"Invalid domain code {domain}. Should be one of the following:\n{DCODES}"
+            )
 
         payload = {
             "key": self.accesskey,
@@ -1162,9 +1167,8 @@ class Keepa:
             categories.
 
         domain : str, default: "US"
-            Amazon locale you want to access. Must be one of the following
-            RESERVED, US, GB, DE, FR, JP, CA, CN, IT, ES, IN, MX
-            Default US
+            Amazon locale you want to access. Must be one of the following:
+            RESERVED, US, GB, DE, FR, JP, CA, CN, IT, ES, IN, MX, BR.
 
         include_parents : bool, default: False
             Include parents.
@@ -1211,7 +1215,9 @@ class Keepa:
 
         """
         if domain not in DCODES:
-            raise ValueError("Invalid domain code")
+            raise ValueError(
+                f"Invalid domain code {domain}. Should be one of the following:\n{DCODES}"
+            )
 
         payload = {
             "key": self.accesskey,
@@ -2884,7 +2890,10 @@ class AsyncKeepa:
     @is_documented_by(Keepa.best_sellers_query)
     async def best_sellers_query(self, category, rank_avg_range=0, domain="US", wait=True):
         """Documented by Keepa.best_sellers_query."""
-        assert domain in DCODES, "Invalid domain code"
+        if domain not in DCODES:
+            raise ValueError(
+                f"Invalid domain code {domain}. Should be one of the following:\n{DCODES}"
+            )
 
         payload = {
             "key": self.accesskey,
@@ -2902,7 +2911,10 @@ class AsyncKeepa:
     @is_documented_by(Keepa.search_for_categories)
     async def search_for_categories(self, searchterm, domain="US", wait=True):
         """Documented by Keepa.search_for_categories."""
-        assert domain in DCODES, "Invalid domain code"
+        if domain not in DCODES:
+            raise ValueError(
+                f"Invalid domain code {domain}. Should be one of the following:\n{DCODES}"
+            )
 
         payload = {
             "key": self.accesskey,
@@ -2922,7 +2934,10 @@ class AsyncKeepa:
     @is_documented_by(Keepa.category_lookup)
     async def category_lookup(self, category_id, domain="US", include_parents=0, wait=True):
         """Documented by Keepa.category_lookup."""
-        assert domain in DCODES, "Invalid domain code"
+        if domain not in DCODES:
+            raise ValueError(
+                f"Invalid domain code {domain}. Should be one of the following:\n{DCODES}"
+            )
 
         payload = {
             "key": self.accesskey,

{keepa-1.3.8 → keepa-1.3.9}/src/keepa/plotting.py

@@ -1,4 +1,5 @@
 """Plotting module product data returned from keepa interface module."""
+
 import numpy as np
 
 from keepa.interface import keepa_minutes_to_time, parse_csv