chore: bump version to 0.2.1

This release fixes compatibility issues with Pydantic v2:
- Updated all field validators to use @classmethod decorator
- Fixed validator method signatures to work with Pydantic v2
- Improved type annotations and docstrings

This patch release ensures the library works correctly with Pydantic v2
after dropping support for Pydantic v1 in version 0.2.0.

Author: doubledare704

.coveragerc

@@ -1,6 +1,6 @@
 [run]
 source = aiowhitebit
-omit = 
+omit =
     */tests/*
     */venv/*
     */setup.py
@@ -12,4 +12,4 @@ exclude_lines =
     raise NotImplementedError
     if __name__ == .__main__.:
     pass
-    raise ImportError
+    raise ImportError

.pre-commit-config.yaml

@@ -12,7 +12,7 @@ repos:
     -   id: requirements-txt-fixer
 
 -   repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.11.7
+    rev: v0.11.8
     hooks:
     -   id: ruff
         args: [--fix, --exit-non-zero-on-fix]

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [0.2.1] - 2025-05-03
+
+### Fixed
+- Updated field validators to be compatible with Pydantic v2
+- Fixed validator decorators to use @classmethod as required by Pydantic v2
+
 ## [0.2.0] - 2024-07-15
 
 ### Changed

aiowhitebit/__init__.py

@@ -0,0 +1,8 @@
+"""Async Python client for WhiteBit API.
+
+This package provides a comprehensive async client for interacting with the WhiteBit cryptocurrency
+exchange API, including public and private endpoints, websocket connections, and webhook handling.
+"""
+
+# Version information
+__version__ = "0.2.1"

aiowhitebit/clients/__init__.py

@@ -9,3 +9,16 @@
     get_public_websocket_client,
     ws_subscribe_builder,
 )
+
+__all__ = [
+    "PrivateV4Client",
+    "PublicV1Client",
+    "PublicV2Client",
+    "PublicV4Client",
+    "PublicWebSocketClient",
+    "SubscribeRequest",
+    "WebhookDataLoader",
+    "get_public_websocket_client",
+    "get_webhook_data_loader",
+    "ws_subscribe_builder",
+]

aiowhitebit/clients/base.py

@@ -12,22 +12,49 @@
 
 
 class HTTPClient:
+    """Base HTTP client for making API requests.
+
+    This class provides the core functionality for making HTTP requests,
+    managing the client session, and handling rate limiting.
+    """
+
     def __init__(self):
+        """Initialize the HTTP client.
+
+        Sets up an empty session and default rate limiter.
+        """
         self._session: Optional[aiohttp.ClientSession] = None
         self._rate_limiter = Semaphore(100)  # Default rate limit
 
     @property
     async def session(self) -> aiohttp.ClientSession:
+        """Get or create an aiohttp client session.
+
+        Returns:
+            An active aiohttp ClientSession instance.
+        """
         if self._session is None or self._session.closed:
             self._session = aiohttp.ClientSession()
         return self._session
 
     async def close(self) -> None:
+        """Close the aiohttp client session if it exists and is open."""
         if self._session and not self._session.closed:
             await self._session.close()
             self._session = None
 
     async def get(self, url: str) -> Any:
+        """Make a GET request to the specified URL.
+
+        Args:
+            url: The URL to make the request to.
+
+        Returns:
+            The JSON response from the request.
+
+        Raises:
+            WhitebitAPIError: If the response status is not 200.
+        """
         async with self._rate_limiter:
             session = await self.session
             async with session.get(url) as response:
@@ -38,17 +65,36 @@ async def get(self, url: str) -> Any:
     async def _handle_error_response(self, response: aiohttp.ClientResponse) -> None:
         try:
             error_data = await response.json()
-        except:
+        except Exception:
             error_data = await response.text()
         raise WhitebitAPIError(response.status, str(error_data))
 
 
 class BaseClient(HTTPClient):
+    """Base client for WhiteBit API endpoints.
+
+    This class extends the HTTPClient with WhiteBit-specific functionality
+    for constructing API URLs and making requests to the API endpoints.
+    """
+
     def __init__(self, base_url: str = BASE_URL):
+        """Initialize the base client.
+
+        Args:
+            base_url: Base URL for the WhiteBit API. Defaults to the official WhiteBit API URL.
+        """
         super().__init__()
         self.base_url = base_url
 
     def request_url(self, path: str) -> str:
+        """Construct the full URL for an API endpoint.
+
+        Args:
+            path: API endpoint path.
+
+        Returns:
+            Full URL for the API endpoint.
+        """
         return f"{self.base_url}{path}"
 
     async def _make_request(self, path: str, converter: Optional[Callable[[dict], T]] = None) -> T:

aiowhitebit/clients/private/__init__.py

@@ -1,3 +1,7 @@
 """Private API clients."""
 
 from aiowhitebit.clients.private.v4 import PrivateV4Client
+
+__all__ = [
+    "PrivateV4Client",
+]