python3-discogs-client 2.8__py3-none-any.whl → 2.9__py3-none-any.whl

discogs_client/__init__.py

@@ -1,4 +1,4 @@
-__version__ = '2.8'
+__version__ = '2.9'
 __version_info__ = tuple(int(i) for i in __version__.split('.') if i.isdigit())
 
 from discogs_client.client import Client

discogs_client/client.py

@@ -19,6 +19,7 @@ class Client:
         self.user_agent = user_agent
         self.verbose = False
         self._fetcher = RequestsFetcher()
+        self._trust_per_page = True  # Default: True
 
         if consumer_key and consumer_secret:
             self.set_consumer_key(consumer_key, consumer_secret)
@@ -219,3 +220,13 @@ class Client:
         """
         self._fetcher.connect_timeout = connect
         self._fetcher.read_timeout = read
+
+    @property
+    def trust_per_page(self) -> bool:
+        return self._trust_per_page
+
+    @trust_per_page.setter
+    def trust_per_page(self, value: bool) -> None:
+        if not isinstance(value, bool):
+            raise ValueError("trust_per_page must be a bool")
+        self._trust_per_page = value

discogs_client/models.py

@@ -354,18 +354,42 @@ class BasePaginatedResponse:
         return item
 
     def __getitem__(self, index):
-        page_index = index // self.per_page + 1
-        offset = index % self.per_page
+        """Retrieve an item by its index.
 
-        try:
-            page = self.page(page_index)
-        except HTTPError as e:
-            if e.status_code == 404:
-                raise IndexError(e.msg)
-            else:
+        By default, uses the API's ``per_page`` value to calculate the page
+        containing the item directly. If the API returns fewer items per page
+        than reported, this may yield incorrect results — set
+        ``client.trust_per_page = False`` to fall back to a sequential page
+        walk at the cost of performance.
+        """
+        if self.client._trust_per_page:
+            page_index = index // self.per_page + 1
+            offset = index % self.per_page
+
+            try:
+                page = self.page(page_index)
+            except HTTPError as e:
+                if e.status_code == 404:
+                    raise IndexError(e.msg) from e
+                raise
+
+            return page[offset]
+
+        # Fallback to sequential page loading if we're not trusting the per_page parameter
+        current = 0
+        page_index = 1
+        while True:
+            try:
+                page = self.page(page_index)
+            except HTTPError as e:
+                if e.status_code == 404:
+                    raise IndexError(e.msg) from e
                 raise
+            if current + len(page) > index:
+                return page[index - current]
+            current += len(page)
+            page_index += 1
 
-        return page[offset]
 
     def __len__(self):
         return self.count

{python3_discogs_client-2.8.dist-info → python3_discogs_client-2.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: python3-discogs-client
-Version: 2.8
+Version: 2.9
 Summary: Python API client for Discogs
 Home-page: https://github.com/joalla/discogs_client
 Author: joalla
@@ -26,6 +26,7 @@ Dynamic: author-email
 Dynamic: classifier
 Dynamic: description
 Dynamic: home-page
+Dynamic: license-file
 Dynamic: provides-extra
 Dynamic: requires-dist
 Dynamic: summary

python3_discogs_client-2.9.dist-info/RECORD

@@ -0,0 +1,11 @@
+discogs_client/__init__.py,sha256=9Giuys_-iyNRMOCDQGMjw69NXHC79Ky-CozAeJx7dBE,445
+discogs_client/client.py,sha256=2iSw-t7R0uo_Wc3nYOTs8ELgRjtytpO1L33l4KN3Fyk,7991
+discogs_client/exceptions.py,sha256=7kHj2wbpfT0gLE7uqm6c4aS28Wkr58f6u9jfpcT_NSM,1323
+discogs_client/fetchers.py,sha256=D8npYWt9FILSRIhVsUdA6N0pzRCEUFh5hqQbnBu4IUg,11964
+discogs_client/models.py,sha256=aG0hswHJWP3nrA-j5bSUiyFx5-tih2jtHQDRF8GP1l8,33532
+discogs_client/utils.py,sha256=r0Hh8JHu8T3XZciEg0mAVV_fN7aZhUZIB08CBY5jJMM,3515
+python3_discogs_client-2.9.dist-info/licenses/LICENSE,sha256=GvYq7dzLVxNCGN29xn0Ec1JMpzZwPXzOAdtZsuB9pUI,1455
+python3_discogs_client-2.9.dist-info/METADATA,sha256=MLp4-CLimlOVBUEfsh4FjOMu6my0vCjr8Tt3dgen9rg,1267
+python3_discogs_client-2.9.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+python3_discogs_client-2.9.dist-info/top_level.txt,sha256=jgqsRXqG3dJuCOSykXhXN68DMNu77XYQuqgqlPSSv1E,15
+python3_discogs_client-2.9.dist-info/RECORD,,

{python3_discogs_client-2.8.dist-info → python3_discogs_client-2.9.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.8.0)
+Generator: setuptools (83.0.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

python3_discogs_client-2.8.dist-info/RECORD

@@ -1,11 +0,0 @@
-discogs_client/__init__.py,sha256=C9ullFtCV-fYGz8NEWw3eGx5RgPJfApsDo3YdqG3q-c,445
-discogs_client/client.py,sha256=AqQmwJd54DrAFTnTb4zi1jCefjC6sbISh43FZuYsQ0g,7632
-discogs_client/exceptions.py,sha256=7kHj2wbpfT0gLE7uqm6c4aS28Wkr58f6u9jfpcT_NSM,1323
-discogs_client/fetchers.py,sha256=D8npYWt9FILSRIhVsUdA6N0pzRCEUFh5hqQbnBu4IUg,11964
-discogs_client/models.py,sha256=bjonpqmZ_homR51vQnOe7xiAJrrl0T6F8QfthhiskvQ,32564
-discogs_client/utils.py,sha256=r0Hh8JHu8T3XZciEg0mAVV_fN7aZhUZIB08CBY5jJMM,3515
-python3_discogs_client-2.8.dist-info/LICENSE,sha256=GvYq7dzLVxNCGN29xn0Ec1JMpzZwPXzOAdtZsuB9pUI,1455
-python3_discogs_client-2.8.dist-info/METADATA,sha256=Gh5aPbAZqHMpuaVmmmsXW1A3J-Jr4YRvMpsIz84gJ1I,1245
-python3_discogs_client-2.8.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-python3_discogs_client-2.8.dist-info/top_level.txt,sha256=jgqsRXqG3dJuCOSykXhXN68DMNu77XYQuqgqlPSSv1E,15
-python3_discogs_client-2.8.dist-info/RECORD,,