deezer-python 6.1.1__tar.gz → 6.2.0__tar.gz

{deezer_python-6.1.1 → deezer_python-6.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: deezer-python
-Version: 6.1.1
+Version: 6.2.0
 Summary: A friendly wrapper library for the Deezer API
 Home-page: https://github.com/browniebroke/deezer-python
 License: MIT
@@ -89,7 +89,7 @@ The package is published on
 Easily query the Deezer API from you Python code. The data returned by the Deezer
 API is mapped to python resources:
 
-```python
+```pycon
 >>> client = deezer.Client()
 >>> client.get_album(680407).title
 'Monkey Business'

{deezer_python-6.1.1 → deezer_python-6.2.0}/README.md

@@ -58,7 +58,7 @@ The package is published on
 Easily query the Deezer API from you Python code. The data returned by the Deezer
 API is mapped to python resources:
 
-```python
+```pycon
 >>> client = deezer.Client()
 >>> client.get_album(680407).title
 'Monkey Business'

{deezer_python-6.1.1 → deezer_python-6.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "deezer-python"
-version = "6.1.1"
+version = "6.2.0"
 description = "A friendly wrapper library for the Deezer API"
 authors = ["Bruno Alla <alla.brunoo@gmail.com>"]
 license = "MIT"
@@ -34,19 +34,19 @@ requests = ">=2.18"
 optional = true
 
 [tool.poetry.group.docs.dependencies]
-myst-parser = ">=0.16"
-sphinx = ">=4.0"
-sphinx-autobuild = ">=2021.0"
-furo = ">=2023.5.20"
+myst-parser = { version = ">=0.16", python = ">=3.11" }
+sphinx = { version = ">=4.0", python = ">=3.11" }
+furo = { version = ">=2023.5.20", python = ">=3.11" }
+sphinx-autobuild = { version = ">=2024.0.0", python = ">=3.11" }
 
 [tool.poetry.group.dev.dependencies]
 coverage = "^7.0"
-environs = "^9.3"
-pytest = "^7.0"
-pytest-cov = "^4.0"
+environs = "^11.0.0"
+pytest = "^8.0.0"
+pytest-cov = "^5.0.0"
 pytest-mock = "^3.6"
 pytest-vcr = "^1.0"
-vcrpy = "^5.0.0"
+vcrpy = "^6.0.0"
 deezer-oauth-cli = "^1.0.0"
 
 [tool.semantic_release]
@@ -54,7 +54,6 @@ version_toml = ["pyproject.toml:tool.poetry.version"]
 version_variables = [
     "src/deezer/__init__.py:__version__",
 ]
-branch = "main"
 build_command = "pip install poetry && poetry build"
 
 [tool.semantic_release.changelog]
@@ -66,6 +65,16 @@ exclude_commit_patterns = [
 [tool.semantic_release.changelog.environment]
 keep_trailing_newline = true
 
+[tool.semantic_release.branches.main]
+match = "main"
+
+[tool.semantic_release.branches.stable]
+match = "(?!stable/*$)"
+
+[tool.semantic_release.branches.noop]
+match = "(?!main$)"
+prerelease = true
+
 [tool.pytest.ini_options]
 addopts = "-v -Wdefault --cov=deezer"
 pythonpath = ["src"]
@@ -86,6 +95,8 @@ exclude_lines = [
 [tool.ruff]
 target-version = "py38"
 line-length = 120
+
+[tool.ruff.lint]
 ignore = [
     "D203", # 1 blank line required before class docstring
     "D212", # Multi-line docstring summary should start at the first line
@@ -107,7 +118,7 @@ select = [
     "RUF", # ruff specific
 ]
 
-[tool.ruff.per-file-ignores]
+[tool.ruff.lint.per-file-ignores]
 "tests/**/*" = [
     "D100",
     "D101",
@@ -120,7 +131,7 @@ select = [
 "conftest.py" = ["D100"]
 "docs/conf.py" = ["D100"]
 
-[tool.ruff.isort]
+[tool.ruff.lint.isort]
 known-first-party = ["deezer"]
 
 [tool.mypy]

{deezer_python-6.1.1 → deezer_python-6.2.0}/src/deezer/__init__.py

@@ -15,7 +15,7 @@ from deezer.resources import (
     User,
 )
 
-__version__ = "6.1.1"
+__version__ = "6.2.0"
 __all__ = [
     "Album",
     "Artist",

{deezer_python-6.1.1 → deezer_python-6.2.0}/src/deezer/client.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import warnings
 from typing import Any, ClassVar
 
 import requests
@@ -25,6 +26,8 @@ from deezer.resources import (
     User,
 )
 
+_UNSET = object()
+
 
 class Client:
     """
@@ -34,7 +37,7 @@ class Client:
     be passed in to the constructor as kwargs.
 
         >>> import deezer
-        >>> client = deezer.Client(app_id='foo', app_secret='bar')
+        >>> client = deezer.Client()
 
     This client provides several methods to retrieve the content most
     kinds of Deezer objects, based on their json structure.
@@ -45,10 +48,17 @@ class Client:
         >>> import deezer
         >>> client = deezer.Client(headers={'Accept-Language': 'fr'})
 
-    :param app_id: application ID.
-    :param app_secret: application secret.
     :param access_token: user access token.
     :param headers: a dictionary of headers to be used.
+
+    .. deprecated:: 6.2.0
+
+        The following parameters will be removed in the next major version:
+
+            * **app_id**
+            * **app_secret**
+
+        They were never actively used by the package.
     """
 
     objects_types: ClassVar[dict[str, type[Resource] | None]] = {
@@ -69,10 +79,29 @@ class Client:
     base_url = "https://api.deezer.com"
 
     def __init__(
-        self, app_id=None, app_secret=None, access_token=None, headers=None, **kwargs
+        self,
+        app_id=_UNSET,
+        app_secret=_UNSET,
+        access_token=None,
+        headers=None,
+        **kwargs,
     ):
-        self.app_id = app_id
-        self.app_secret = app_secret
+        if app_id is not _UNSET:
+            warnings.warn(
+                "The 'app_id' parameter is not actually used and is deprecated. "
+                "It will be removed in the next major release.",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+            self.app_id = app_id
+        if app_secret is not _UNSET:
+            warnings.warn(
+                "The 'app_secret' parameter is not actually used and is deprecated. "
+                "It will be removed in the next major release.",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+            self.app_secret = app_secret
         self.access_token = access_token
         self.session = requests.Session()
 
@@ -166,7 +195,7 @@ class Client:
         json_data = response.json()
         if not isinstance(json_data, dict):
             return json_data
-        if "error" in json_data and json_data["error"]:
+        if json_data.get("error"):
             raise DeezerErrorResponse(json_data)
         return self._process_json(
             json_data,

{deezer_python-6.1.1 → deezer_python-6.2.0}/src/deezer/pagination.py

@@ -41,12 +41,10 @@ class PaginatedList(Generic[ResourceType]):
         return f"<{self.__class__.__name__} {data!r}>"
 
     @overload
-    def __getitem__(self, index: int) -> ResourceType:
-        ...
+    def __getitem__(self, index: int) -> ResourceType: ...
 
     @overload
-    def __getitem__(self, index: slice) -> list[ResourceType]:
-        ...
+    def __getitem__(self, index: slice) -> list[ResourceType]: ...
 
     def __getitem__(
         self,