1.0.7

CHANGELOG.md

@@ -1,3 +1,9 @@
+## 1.0.7
+### Added
+* Automatic rotation of browser impersonation when `impersonate` argument in `Client` is set to None.
+* Ability to choose which browser to impersonate via the `impersonate` argument in `Client`.
+* Option to disable SSL verification for requests by setting `request_verify` to `False` in `Client`.
+
 ## 1.0.6
 ### Fixed
 * "Unknown location type" error when searching with a URL containing a zipcode.

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "lbc"
-version = "1.0.6"
+version = "1.0.7"
 description = "Unofficial client for Leboncoin API"
 readme = "README.md"
 license = {text = "MIT"}

src/lbc/client.py

@@ -4,10 +4,23 @@ from .exceptions import DatadomeError, RequestError
 from .utils import build_search_payload_with_args, build_search_payload_with_url
 
 from typing import Optional, List, Union
+from curl_cffi import BrowserTypeLiteral
 
 class Client(Session):
-    def __init__(self, proxy: Optional[Proxy] = None):
-        super().__init__(proxy=proxy)
+    def __init__(self, proxy: Optional[Proxy] = None, impersonate: BrowserTypeLiteral = None, request_verify: bool = True):
+        """
+        Initializes a Leboncoin Client instance with optional proxy, browser impersonation, and SSL verification settings.
+
+        If no `impersonate` value is provided, a random browser type will be selected among common options.
+        
+        Args:
+            proxy (Optional[Proxy], optional): Proxy configuration to use for the client. If provided, it will be applied to all requests. Defaults to None.
+            impersonate (BrowserTypeLiteral, optional): Browser type to impersonate for requests (e.g., "firefox", "chrome", "edge", "safari", "safari_ios", "chrome_android"). If None, a random browser type will be chosen.
+            request_verify (bool, optional): Whether to verify SSL certificates when sending requests. Set to False to disable SSL verification (not recommended for production). Defaults to True.
+        """
+        super().__init__(proxy=proxy, impersonate=impersonate)
+
+        self.request_verify = request_verify
 
     def _fetch(self, method: str, url: str, payload: Optional[dict] = None, timeout: int = 30) -> Union[dict, None]:
         """
@@ -30,7 +43,8 @@ class Client(Session):
             method=method,
             url=url, 
             json=payload,
-            timeout=timeout
+            timeout=timeout,
+            verify=self.request_verify,
         )
         if response.ok:
             return response.json()

src/lbc/session.py

@@ -1,25 +1,42 @@
 from .models import Proxy
 
-from curl_cffi import requests
+from curl_cffi import requests, BrowserTypeLiteral
 from typing import Optional
+import random
 
 class Session:
-    def __init__(self, proxy: Optional[Proxy] = None):
-        self._session = self._init_session(proxy=proxy)
+    def __init__(self, proxy: Optional[Proxy] = None, impersonate: BrowserTypeLiteral = None):
+        self._session = self._init_session(proxy=proxy, impersonate=impersonate)
         self._proxy = proxy
+        self._impersonate = impersonate
 
-    def _init_session(self, proxy: Optional[Proxy] = None) -> requests.Session:
+    def _init_session(self, proxy: Optional[Proxy] = None, impersonate: BrowserTypeLiteral = None) -> requests.Session:
         """
-        Initializes an HTTP session with optional proxy and browser impersonation.
+        Initializes an HTTP session with optional proxy configuration and browser impersonation.
+
+        If no `impersonate` value is provided, a random browser type will be selected among common options.
 
         Args:
-            proxy (Optional[Proxy], optional): Proxy configuration to use for the session. If provided, it will be applied to both HTTP and HTTPS traffic.
-
+            proxy (Optional[Proxy], optional): Proxy configuration to use for the session. If provided, it will be applied to both HTTP and HTTPS traffic. Defaults to None.
+            impersonate (BrowserTypeLiteral, optional): Browser type to impersonate for requests (e.g., "firefox", "chrome", "edge", "safari", "safari_ios", "chrome_android"). If None, a random browser type will be chosen.            
+        
         Returns:
             requests.Session: A configured session instance ready to send requests.
         """
+        if impersonate == None: # Pick a random browser client
+            impersonate: BrowserTypeLiteral = random.choice(
+                [
+                    "chrome",
+                    "edge",
+                    "safari",
+                    "safari_ios",
+                    "chrome_android",
+                    "firefox"
+                ]
+            )
+
         session = requests.Session(
-            impersonate="firefox",
+            impersonate=impersonate,
         )
 
         session.headers.update(