vinted-api-kit 1.0.0__tar.gz → 1.1.0__tar.gz

{vinted_api_kit-1.0.0 → vinted_api_kit-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vinted-api-kit
-Version: 1.0.0
+Version: 1.1.0
 Summary: Lightweight asynchronous Python client library for accessing Vinted API and scraping item data.
 Project-URL: Homepage, https://github.com/vlymar1/vinted-api-kit
 Project-URL: Documentation, https://github.com/vlymar1/vinted-api-kit
@@ -50,11 +50,10 @@ Description-Content-Type: text/markdown
 - 🚀 **Asynchronous** - Built with asyncio for high performance
 - 🌍 **Auto-locale Detection** - Automatically detects locale from URL
 - 🔍 **Item Search** - Search catalog with filters, sorting and pagination
-- 📦 **Item Details** - Get complete item information with rich metadata
 - 🍪 **Cookie Persistence** - Automatic session management with multiple storage formats
 - 🔐 **Proxy Support** - Simple string-based proxy configuration
 - 📊 **Type Hints** - Full typing support with Literal types for better IDE experience
-- 🎯 **Dataclass Models** - Fast and efficient data models (15% performance boost)  # TODO: Убрать у будущем
+- 🎯 **Dataclass Models** - Fast and efficient data models (15% performance boost)
 - 🛡️ **Custom Exceptions** - Detailed error hierarchy for precise error handling
 - 💾 **Flexible Storage** - Choose between pickle, JSON, or Mozilla cookie formats
 
@@ -165,22 +164,7 @@ raw_items = await client.search_items(
 
 ### Item Details
 
-> Fetch detailed information about a specific item:
-```python
-item = await client.item_details(
-    url="https://www.vinted.com/items/1234567890"
-)
-
-print(f"Title: {item.title}")
-print(f"Brand: {item.brand_title}")
-print(f"Size: {item.size_title}")
-print(f"Price: {item.price} {item.currency}")
-print(f"Total: {item.total_item_price}")
-print(f"Description: {item.description}")
-
-# Or get raw JSON
-raw_item = await client.item_details(url, raw_data=True)
-```
+> ⚠️ **Deprecated since 1.1.0.** Vinted removed the item details API, so `item_details()` raises `VintedDeprecatedError`.
 
 ### Parameters
 
@@ -352,8 +336,7 @@ vinted-api-kit/
 │   ├── constants.py    # Constants and type definitions
 │   ├── exceptions.py   # Custom exceptions
 │   └── utils.py        # Utility functions
-├── tests/              # Test suite
-└── examples/           # Usage examples
+└── tests/              # Test suite
 ```
 
 ### Testing

{vinted_api_kit-1.0.0 → vinted_api_kit-1.1.0}/README.md

@@ -18,11 +18,10 @@
 - 🚀 **Asynchronous** - Built with asyncio for high performance
 - 🌍 **Auto-locale Detection** - Automatically detects locale from URL
 - 🔍 **Item Search** - Search catalog with filters, sorting and pagination
-- 📦 **Item Details** - Get complete item information with rich metadata
 - 🍪 **Cookie Persistence** - Automatic session management with multiple storage formats
 - 🔐 **Proxy Support** - Simple string-based proxy configuration
 - 📊 **Type Hints** - Full typing support with Literal types for better IDE experience
-- 🎯 **Dataclass Models** - Fast and efficient data models (15% performance boost)  # TODO: Убрать у будущем
+- 🎯 **Dataclass Models** - Fast and efficient data models (15% performance boost)
 - 🛡️ **Custom Exceptions** - Detailed error hierarchy for precise error handling
 - 💾 **Flexible Storage** - Choose between pickle, JSON, or Mozilla cookie formats
 
@@ -133,22 +132,7 @@ raw_items = await client.search_items(
 
 ### Item Details
 
-> Fetch detailed information about a specific item:
-```python
-item = await client.item_details(
-    url="https://www.vinted.com/items/1234567890"
-)
-
-print(f"Title: {item.title}")
-print(f"Brand: {item.brand_title}")
-print(f"Size: {item.size_title}")
-print(f"Price: {item.price} {item.currency}")
-print(f"Total: {item.total_item_price}")
-print(f"Description: {item.description}")
-
-# Or get raw JSON
-raw_item = await client.item_details(url, raw_data=True)
-```
+> ⚠️ **Deprecated since 1.1.0.** Vinted removed the item details API, so `item_details()` raises `VintedDeprecatedError`.
 
 ### Parameters
 
@@ -320,8 +304,7 @@ vinted-api-kit/
 │   ├── constants.py    # Constants and type definitions
 │   ├── exceptions.py   # Custom exceptions
 │   └── utils.py        # Utility functions
-├── tests/              # Test suite
-└── examples/           # Usage examples
+└── tests/              # Test suite
 ```
 
 ### Testing

{vinted_api_kit-1.0.0 → vinted_api_kit-1.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "vinted-api-kit"
-version = "1.0.0"
+version = "1.1.0"
 description = "Lightweight asynchronous Python client library for accessing Vinted API and scraping item data."
 authors = [
     {name = "Lymar Volodymyr",email = "volodymyr.lymar1@gmail.com"},
@@ -71,6 +71,9 @@ all = ["format", "lint", "type-check", "test-cov"]
 [tool.hatch.build.targets.wheel]
 packages = ["vinted"]
 
+[tool.hatch.build.targets.sdist]
+include = ["vinted", "README.md", "LICENSE"]
+
 [tool.ruff]
 exclude = [
     ".git",

{vinted_api_kit-1.0.0 → vinted_api_kit-1.1.0}/vinted/__init__.py

@@ -4,6 +4,7 @@ from vinted.exceptions import (
     VintedAPIError,
     VintedAuthError,
     VintedConfigError,
+    VintedDeprecatedError,
     VintedError,
     VintedNetworkError,
     VintedRateLimitError,
@@ -11,7 +12,7 @@ from vinted.exceptions import (
 )
 from vinted.models.item import CatalogItem, DetailedItem
 
-__version__ = "1.0.0"
+__version__ = "1.1.0"
 
 __all__ = [
     "VintedClient",
@@ -24,6 +25,7 @@ __all__ = [
     "VintedNetworkError",
     "VintedConfigError",
     "VintedValidationError",
+    "VintedDeprecatedError",
     "SortOrder",
     "StorageFormat",
 ]

{vinted_api_kit-1.0.0 → vinted_api_kit-1.1.0}/vinted/api/base.py

@@ -4,6 +4,8 @@ This module provides a small base class that stores a shared
 `HttpSession` instance used by higher-level API wrappers.
 """
 
+from vinted.exceptions import VintedConfigError
+
 from ..session import HttpSession
 
 
@@ -22,11 +24,11 @@ class BaseAPI:
         """Return configured base URL for API requests.
 
         Raises:
-            ValueError: If the session `base_url` is not configured.
+            VintedConfigError: If the session `base_url` is not configured.
 
         Returns:
             The base URL (scheme + host) derived from the session.
         """
         if not self.session.base_url:
-            raise ValueError("Session base_url not configured")
+            raise VintedConfigError("Session base_url not configured")
         return self.session.base_url

{vinted_api_kit-1.0.0 → vinted_api_kit-1.1.0}/vinted/api/catalog.py

@@ -8,7 +8,9 @@ and returns either raw JSON items or parsed `CatalogItem` instances.
 import logging
 import time
 from typing import Any, Union
-from urllib.parse import parse_qsl, urlparse
+from urllib.parse import parse_qsl, urljoin, urlparse
+
+from vinted.exceptions import VintedValidationError
 
 from ..constants import SortOrder
 from ..models import CatalogItem
@@ -46,8 +48,9 @@ class CatalogAPI(BaseAPI):
         Returns:
             List of `CatalogItem` instances or raw item dicts.
         """
+        self._validate_catalog_url(url)
         self.session.configure_from_url(url)
-        api_url = f"{self.base_url}/api/v2/catalog/items"
+        api_url = f"{self.base_url}/web/gateway/svc-catalogue/items"
 
         params = self._build_params(url, per_page, page)
         params["time"] = timestamp or int(time.time())
@@ -66,7 +69,11 @@ class CatalogAPI(BaseAPI):
         if raw_data:
             return items
 
-        return [CatalogItem(raw_data=item) for item in items]
+        catalog_items = [CatalogItem(raw_data=item) for item in items]
+        for catalog_item in catalog_items:
+            catalog_item.url = urljoin(f"{self.base_url}/", catalog_item.url)
+
+        return catalog_items
 
     def _build_params(self, url: str, per_page: int, page: int) -> dict:
         """Build API query params from a public catalog URL.
@@ -80,17 +87,19 @@ class CatalogAPI(BaseAPI):
         catalog_id = self._extract_catalog_id(parsed.path)
         catalog_ids_query = self._join_values(query_params, "catalog[]")
 
+        status_ids = self._extract_values(query_params, "status_ids[]") + self._extract_values(
+            query_params, "status[]"
+        )
+
         params = {
             "search_text": "+".join(self._extract_values(query_params, "search_text")),
-            "catalog_ids": str(catalog_id) if catalog_id else catalog_ids_query,
-            "color_ids": self._join_values(query_params, "color_ids[]"),
-            "brand_ids": self._join_values(query_params, "brand_ids[]"),
-            "size_ids": self._join_values(query_params, "size_ids[]"),
-            "material_ids": self._join_values(query_params, "material_ids[]"),
-            "status_ids": self._join_values(query_params, "status[]"),
-            "country_ids": self._join_values(query_params, "country_ids[]"),
-            "city_ids": self._join_values(query_params, "city_ids[]"),
-            "is_for_swap": ",".join("1" for _ in self._extract_values(query_params, "disposal[]")),
+            "attribute_ids[catalog]": str(catalog_id) if catalog_id else catalog_ids_query,
+            "attribute_ids[color]": self._join_values(query_params, "color_ids[]"),
+            "attribute_ids[brand]": self._join_values(query_params, "brand_ids[]"),
+            "attribute_ids[size]": self._join_values(query_params, "size_ids[]"),
+            "attribute_ids[material]": self._join_values(query_params, "material_ids[]"),
+            "attribute_ids[status]": ",".join(status_ids),
+            "attribute_ids[patterns]": self._join_values(query_params, "patterns_ids[]"),
             "currency": self._join_values(query_params, "currency"),
             "price_to": self._join_values(query_params, "price_to"),
             "price_from": self._join_values(query_params, "price_from"),
@@ -101,6 +110,18 @@ class CatalogAPI(BaseAPI):
 
         return {k: v for k, v in params.items() if v}
 
+    @staticmethod
+    def _validate_catalog_url(url: str) -> None:
+        """Validate basic catalog URL shape without restricting the domain."""
+        parsed = urlparse(url)
+
+        if parsed.scheme not in ("http", "https") or not parsed.netloc:
+            raise VintedValidationError("Invalid catalog URL: expected an absolute HTTP(S) URL")
+
+        path = parsed.path.rstrip("/")
+        if path and not path.startswith("/catalog"):
+            raise VintedValidationError("Invalid catalog URL: expected path '/catalog'")
+
     @staticmethod
     def _extract_catalog_id(path: str) -> int | None:
         """Extract catalog id from path if present.

{vinted_api_kit-1.0.0 → vinted_api_kit-1.1.0}/vinted/api/items.py

@@ -6,9 +6,11 @@ URL and returns either a parsed `DetailedItem` or raw JSON.
 """
 
 import logging
-from typing import Any, Union
+from typing import Union
 from urllib.parse import urlparse
 
+from vinted.exceptions import VintedDeprecatedError, VintedValidationError
+
 from ..models import DetailedItem
 from .base import BaseAPI
 
@@ -27,33 +29,18 @@ class ItemsAPI(BaseAPI):
         url: str,
         raw_data: bool = False,
     ) -> Union[DetailedItem, dict]:
-        """Fetch item details.
+        """Deprecated: always raises `VintedDeprecatedError`.
+
+        Vinted removed the item details API endpoint.
 
         Args:
             url: Public Vinted item URL.
             raw_data: If True, return raw JSON dictionary instead of
                 a `DetailedItem` instance.
-
-        Returns:
-            `DetailedItem` or raw dict depending on `raw_data`.
         """
-        self.session.configure_from_url(url)
-
-        product_id = self._extract_product_id(url)
-        api_url = f"{self.base_url}/api/v2/items/{product_id}/details"
-
-        logger.debug("Fetching item details: %s", api_url)
-
-        response = await self.session.request(api_url)
-        data = response.json()
-        item_data: dict[Any, Any] = data.get("item", {})
-
-        logger.debug("Item details fetched successfully")
-
-        if raw_data:
-            return item_data
-
-        return DetailedItem(raw_data=item_data)
+        raise VintedDeprecatedError(
+            "item_details() no longer works: Vinted removed the item details API"
+        )
 
     @staticmethod
     def _extract_product_id(url: str) -> str:
@@ -62,5 +49,17 @@ class ItemsAPI(BaseAPI):
         The public path is expected to be `/items/<id>-...` or similar; the
         method extracts the numeric id component.
         """
-        path = urlparse(url).path
-        return path.split("/")[2].split("-")[0]
+        parsed = urlparse(url)
+        path_parts = parsed.path.strip("/").split("/")
+
+        if parsed.scheme not in ("http", "https") or not parsed.netloc:
+            raise VintedValidationError("Invalid item URL: expected an absolute HTTP(S) URL")
+
+        if len(path_parts) < 2 or path_parts[0] != "items":
+            raise VintedValidationError("Invalid item URL: expected path '/items/<id>'")
+
+        product_id = path_parts[1].split("-")[0]
+        if not product_id.isdigit():
+            raise VintedValidationError("Invalid item URL: item id must be numeric")
+
+        return product_id

{vinted_api_kit-1.0.0 → vinted_api_kit-1.1.0}/vinted/client.py

@@ -12,6 +12,7 @@ from typing import Type, Union
 from .api.catalog import CatalogAPI
 from .api.items import ItemsAPI
 from .constants import SortOrder, StorageFormat
+from .exceptions import VintedConfigError
 from .models.config import ClientConfig
 from .models.item import CatalogItem, DetailedItem
 from .session import HttpSession
@@ -82,6 +83,12 @@ class VintedClient:
             "mozilla": MozillaStorage,
         }
 
+        if config.storage_format not in storage_map:
+            valid_formats = ", ".join(storage_map)
+            raise VintedConfigError(
+                f"Invalid storage_format '{config.storage_format}'. Valid options: {valid_formats}"
+            )
+
         storage_class = storage_map[config.storage_format]
         return storage_class(filepath)
 
@@ -110,6 +117,12 @@ class VintedClient:
             "mozilla": ".txt",
         }
 
+        if config.storage_format not in extensions:
+            valid_formats = ", ".join(extensions)
+            raise VintedConfigError(
+                f"Invalid storage_format '{config.storage_format}'. Valid options: {valid_formats}"
+            )
+
         filename += extensions[config.storage_format]
 
         return config.cookies_dir / filename
@@ -150,14 +163,13 @@ class VintedClient:
         url: str,
         raw_data: bool = False,
     ) -> Union[DetailedItem, dict]:
-        """Fetch item details by URL.
+        """Deprecated: always raises `VintedDeprecatedError`.
+
+        Vinted removed the item details API endpoint.
 
         Args:
             url: Item page URL or API endpoint.
             raw_data: When True returns raw dict instead of `DetailedItem`.
-
-        Returns:
-            `DetailedItem` or raw dict when `raw_data` is True.
         """
         return await self._items.get_details(url=url, raw_data=raw_data)
 

{vinted_api_kit-1.0.0 → vinted_api_kit-1.1.0}/vinted/constants.py

@@ -57,8 +57,6 @@ LOCALE_TO_ACCEPT_LANGUAGE = {
     "com": "en-US",
 }
 
-VINTED_BASE_URL_TEMPLATE = "https://www.vinted.{locale}"
-
 SortOrder = Literal["newest_first", "relevance", "price_high_to_low", "price_low_to_high"]
 
 StorageFormat = Literal["json", "pickle", "mozilla"]

{vinted_api_kit-1.0.0 → vinted_api_kit-1.1.0}/vinted/exceptions.py

@@ -59,3 +59,7 @@ class VintedConfigError(VintedError):
 
 class VintedValidationError(VintedError):
     """Raised when input validation fails."""
+
+
+class VintedDeprecatedError(VintedError):
+    """Raised when a deprecated feature no longer works with the Vinted API."""

{vinted_api_kit-1.0.0 → vinted_api_kit-1.1.0}/vinted/models/config.py

@@ -8,6 +8,7 @@ from dataclasses import dataclass, field
 from pathlib import Path
 
 from ..constants import StorageFormat
+from ..exceptions import VintedConfigError
 
 
 @dataclass
@@ -35,4 +36,7 @@ class ClientConfig:
         if isinstance(self.cookies_dir, str):
             self.cookies_dir = Path(self.cookies_dir)
 
-        self.cookies_dir.mkdir(parents=True, exist_ok=True)
+        try:
+            self.cookies_dir.mkdir(parents=True, exist_ok=True)
+        except OSError as e:
+            raise VintedConfigError(f"Invalid cookies_dir '{self.cookies_dir}': {e}") from e

{vinted_api_kit-1.0.0 → vinted_api_kit-1.1.0}/vinted/models/item.py

@@ -8,6 +8,8 @@ from dataclasses import dataclass, field
 from datetime import datetime, timezone
 from typing import Any
 
+from ..exceptions import VintedDeprecatedError
+
 
 @dataclass
 class CatalogItem:
@@ -15,7 +17,12 @@ class CatalogItem:
 
     The class stores the original `raw_data` (hidden from the repr)
     and extracts commonly-used fields like `id`, `title`, `price` and
-    `photo` for convenience.
+    `photo` for convenience. Brand, size and condition come from
+    `item_box` in the language of the Vinted domain.
+
+    `created_at_ts` and `raw_timestamp` are deprecated: the catalog API
+    no longer returns the photo timestamp, so they always hold epoch
+    and 0. They will be removed in the next major release.
     """
 
     raw_data: dict[str, Any] = field(repr=False)
@@ -23,8 +30,10 @@ class CatalogItem:
     title: str = field(init=False)
     brand_title: str = field(init=False)
     size_title: str = field(init=False)
+    condition: str = field(init=False)
     currency: str = field(init=False)
     price: float = field(init=False)
+    total_item_price: float = field(init=False)
     photo: str = field(init=False)
     url: str = field(init=False)
     created_at_ts: datetime = field(init=False)
@@ -33,12 +42,19 @@ class CatalogItem:
     def __post_init__(self):
         self.id = self.raw_data.get("id", 0)
         self.title = self.raw_data.get("title", "")
-        self.brand_title = self.raw_data.get("brand_title", "")
-        self.size_title = self.raw_data.get("size_title", "")
+
+        item_box = self.raw_data.get("item_box") or {}
+        self.brand_title = item_box.get("first_line", "")
+        # second_line is "<size> · <condition>", the size part is optional
+        *sizes, self.condition = item_box.get("second_line", "").split(" · ")
+        self.size_title = sizes[0] if sizes else ""
 
         price = self.raw_data.get("price") or {}
         self.currency = price.get("currency_code", "")
-        self.price = price.get("amount", 0.0)
+        self.price = float(price.get("amount") or 0.0)
+
+        total_item_price = self.raw_data.get("total_item_price") or {}
+        self.total_item_price = float(total_item_price.get("amount") or 0.0)
 
         photo = self.raw_data.get("photo") or {}
         self.photo = photo.get("url", "")
@@ -69,13 +85,19 @@ class CatalogItem:
         return hash(self.id)
 
     def is_new_item(self, minutes: int = 1) -> bool:
-        """Return True when the item was created within `minutes`.
+        """Deprecated: always raises `VintedDeprecatedError`.
+
+        The check compared `created_at_ts` with the current time, but the
+        catalog API no longer returns the photo timestamp. The method will
+        be removed in the next major release.
 
         Args:
             minutes: Age threshold in minutes (default: 1).
         """
-        delta = datetime.now(timezone.utc) - self.created_at_ts
-        return delta.total_seconds() < minutes * 60
+        raise VintedDeprecatedError(
+            "CatalogItem.is_new_item() no longer works: the Vinted catalog API "
+            "does not return item timestamps anymore"
+        )
 
 
 @dataclass

{vinted_api_kit-1.0.0 → vinted_api_kit-1.1.0}/vinted/session.py

@@ -12,16 +12,23 @@ from curl_cffi import AsyncSession
 from curl_cffi.requests import Response
 from curl_cffi.requests.exceptions import HTTPError as CurlHTTPError
 
-from vinted.exceptions import VintedAPIError, VintedAuthError, VintedNetworkError
+from vinted.exceptions import (
+    VintedAPIError,
+    VintedAuthError,
+    VintedConfigError,
+    VintedNetworkError,
+    VintedRateLimitError,
+)
 
 from .auth import AuthManager
 from .constants import (
     DEFAULT_HEADERS,
     HTTP_STATUS_FORBIDDEN,
+    HTTP_STATUS_RATE_LIMIT,
     HTTP_STATUS_UNAUTHORIZED,
 )
 from .storage import CookieStorage
-from .utils import format_proxy_for_log, get_accept_language
+from .utils import format_proxy_for_log, get_accept_language, get_locale_code
 
 logger = logging.getLogger(__name__)
 
@@ -77,23 +84,30 @@ class HttpSession:
     def configure_from_url(self, url: str) -> None:
         parsed = urlparse(url)
         self.base_url = f"https://{parsed.netloc}"
+        self.locale = None
+
+        host = parsed.netloc.lower()
+        if host.startswith("www."):
+            host = host[4:]
 
-        domain_parts = parsed.netloc.split(".")
-        if len(domain_parts) > 1:
-            self.locale = domain_parts[-1]
+        if host.startswith("vinted."):
+            self.locale = host[len("vinted.") :]
             accept_language = get_accept_language(self.locale)
-            self.session.headers.update({"Accept-Language": accept_language})
+            # `locale` selects the marketplace whose items the catalog returns
+            self.session.headers.update(
+                {"Accept-Language": accept_language, "locale": get_locale_code(self.locale)}
+            )
 
         self.session.headers.update({"Referer": self.base_url})
         logger.debug("Configured: base_url=%s, locale=%s", self.base_url, self.locale)
 
     async def refresh_cookies(self) -> None:
         if not self.base_url:
-            raise VintedAPIError("base_url not configured")
+            raise VintedConfigError("base_url not configured")
 
         logger.debug("Refreshing session cookies...")
 
-        self._clear_cookies()
+        self._clear_session_cookies()
 
         self.session.headers.update({"Referer": ""})
 
@@ -108,15 +122,16 @@ class HttpSession:
         logger.debug("Fresh cookies received: %d cookies", len(self.session.cookies))
 
         if self.storage:
-            self.storage.save(self.session.cookies.jar)
+            try:
+                self.storage.save(self.session.cookies.jar)
+            except Exception as e:
+                raise VintedConfigError("Failed to save cookies") from e
 
         logger.info("Session cookies refreshed successfully")
 
-    def _clear_cookies(self) -> None:
+    def _clear_session_cookies(self) -> None:
         self.session.cookies.clear()
-        if self.storage:
-            self.storage.clear()
-        logger.debug("Cookies cleared")
+        logger.debug("Session cookies cleared")
 
     def _load_cookies(self) -> bool:
         if not self.storage:
@@ -137,7 +152,6 @@ class HttpSession:
                 logger.info("Access token expired, refreshing cookies")
                 await self.refresh_cookies()
         else:
-            # Если куки не были загружены, то рефрешим
             logger.debug("No saved cookies, refreshing...")
             await self.refresh_cookies()
 
@@ -173,6 +187,19 @@ class HttpSession:
                 )
             except Exception as e:
                 raise VintedNetworkError("Network error on retry", e)
+        if response.status_code == HTTP_STATUS_RATE_LIMIT:
+            raise VintedRateLimitError(
+                f"HTTP {response.status_code}: {response.reason}",
+                status_code=response.status_code,
+                response=response,
+            )
+
+        if response.status_code in (HTTP_STATUS_UNAUTHORIZED, HTTP_STATUS_FORBIDDEN):
+            raise VintedAuthError(
+                f"Authentication failed after retry: HTTP {response.status_code}: {response.reason}",
+                status_code=response.status_code,
+                response=response,
+            )
 
         if response.status_code >= 400:
             raise VintedAPIError(

{vinted_api_kit-1.0.0 → vinted_api_kit-1.1.0}/vinted/utils.py

@@ -4,7 +4,7 @@ Small helpers used across the library for formatting proxy strings and
 resolving Accept-Language headers.
 """
 
-from .constants import LOCALE_TO_ACCEPT_LANGUAGE, VALID_LOCALES
+from .constants import LOCALE_TO_ACCEPT_LANGUAGE
 
 
 def format_proxy_for_log(proxy: str | None) -> str:
@@ -28,16 +28,9 @@ def format_proxy_for_log(proxy: str | None) -> str:
     return proxy
 
 
-def validate_locale(locale: str) -> None:
-    """Validate that `locale` is supported.
-
-    Raises `ValueError` when the provided `locale` is not in
-    `VALID_LOCALES`.
-    """
-    if locale not in VALID_LOCALES:
-        raise ValueError(
-            "Invalid locale '%s'. Valid options: %s" % (locale, ", ".join(VALID_LOCALES))
-        )
+def get_locale_code(locale: str) -> str:
+    """Return the full locale code for `locale` (e.g. "sk" -> "sk-SK")."""
+    return LOCALE_TO_ACCEPT_LANGUAGE.get(locale, "en-US")
 
 
 def get_accept_language(locale: str) -> str:
@@ -46,6 +39,6 @@ def get_accept_language(locale: str) -> str:
     The returned value contains the full locale code and a fallback
     language prefix with a lower q-value.
     """
-    locale_code = LOCALE_TO_ACCEPT_LANGUAGE.get(locale, "en-US")
+    locale_code = get_locale_code(locale)
     lang_prefix = locale_code.split("-")[0]
     return "%s,%s;q=0.9" % (locale_code, lang_prefix)

vinted_api_kit-1.0.0/.editorconfig

@@ -1,22 +0,0 @@
-root = true
-
-[**]
-charset = utf-8
-end_of_line = lf
-indent_size = 4
-indent_style = space
-insert_final_newline = true
-trim_trailing_whitespace = true
-max_line_length = 99
-
-[**.{yml,yaml,json,conf}]
-indent_size = 2
-
-[**.{md,txt,rst}]
-trim_trailing_whitespace = false
-
-[**.rst]
-indent_size = 2
-
-[Makefile]
-indent_style = tab