Repository: thewh1teagle/rookie (language: rust)

Issue:
[Bug]: Python docstring issue
### What happened?

Really cool library overall, but I think I stumbled into a documentation error. 
The arguments don't seem to match with the error.

![image](https://github.com/user-attachments/assets/4fa9d2c2-2c45-420e-9f96-22623f317e23)

Other than that, `rookiepy.chrome(['...'])` and `rookiepy.load(['...'])` are working fine.


Also, is this a feature or a bug lol? (seems like there is not commit hash for this)
![image](https://github.com/user-attachments/assets/ba9fcb22-b75f-4a84-b22c-7f27f3abace7)


### Steps to reproduce

python 3.11.4
rookiepy 0.5.2()
ubuntu

call `rookiepy.any_browser()` and pass a list of strings 


### What browsers are you seeing the problem on?

_No response_

### Relevant log output

_No response_


Discussion / hints:
Hey!
Thanks for report.
It seems that the type hints are wrong. the function accept more parameters

https://github.com/thewh1teagle/rookie/blob/78c292cafb9d8ecc5a09f093834d3c0a15594866/bindings/node/src/lib.rs#L44-L48

You may want to use instead the function `load()`
Got it. Would love to submit a PR with the changes reflecting what is defined in lib.rs

Fix patch:
diff --git a/bindings/python/rookiepy/rookiepy.pyi b/bindings/python/rookiepy/rookiepy.pyi
index 2f30e27..c2bc1ff 100644
--- a/bindings/python/rookiepy/rookiepy.pyi
+++ b/bindings/python/rookiepy/rookiepy.pyi
@@ -11,7 +11,6 @@ def version() -> str:
     """
     ...
 
-
 def firefox(domains: Optional[List[str]] = None) -> CookieList:
     """
     Extract Cookies from Firefox
@@ -21,8 +20,9 @@ def firefox(domains: Optional[List[str]] = None) -> CookieList:
     """
     ...
 
-
-def firefox_based(key_path: str, db_path: str, domains: Optional[List[str]] = None) -> CookieList:
+def firefox_based(
+    key_path: str, db_path: str, domains: Optional[List[str]] = None
+) -> CookieList:
     """
     Extract Cookies from Firefox-based browsers
 
@@ -33,7 +33,6 @@ def firefox_based(key_path: str, db_path: str, domains: Optional[List[str]] = No
     """
     ...
 
-
 def brave(domains: Optional[List[str]] = None) -> CookieList:
     """
     Extract Cookies from Brave browser
@@ -43,7 +42,6 @@ def brave(domains: Optional[List[str]] = None) -> CookieList:
     """
     ...
 
-
 def edge(domains: Optional[List[str]] = None) -> CookieList:
     """
     Extract Cookies from Microsoft Edge browser
@@ -53,7 +51,6 @@ def edge(domains: Optional[List[str]] = None) -> CookieList:
     """
     ...
 
-
 def chrome(domains: Optional[List[str]] = None) -> CookieList:
     """
     Extract Cookies from Google Chrome browser
@@ -63,7 +60,6 @@ def chrome(domains: Optional[List[str]] = None) -> CookieList:
     """
     ...
 
-
 def chromium_based(db_path: str, domains: Optional[List[str]] = None) -> CookieList:
     """
     Extract Cookies from Chromium-based browsers
@@ -74,7 +70,6 @@ def chromium_based(db_path: str, domains: Optional[List[str]] = None) -> CookieL
     """
     ...
 
-
 def chromium(domains: Optional[List[str]] = None) -> CookieList:
     """
     Extract Cookies from Chromium browser
@@ -102,7 +97,6 @@ def opera(domains: Optional[List[str]] = None) -> CookieList:
     """
     ...
 
-
 def vivaldi(domains: Optional[List[str]] = None) -> CookieList:
     """
     Extract Cookies from Vivaldi browser
@@ -112,7 +106,6 @@ def vivaldi(domains: Optional[List[str]] = None) -> CookieList:
     """
     ...
 
-
 def opera_gx(domains: Optional[List[str]] = None) -> CookieList:
     """
     Extract Cookies from Opera GX browser
@@ -122,7 +115,6 @@ def opera_gx(domains: Optional[List[str]] = None) -> CookieList:
     """
     ...
 
-
 def librewolf(domains: Optional[List[str]] = None) -> CookieList:
     """
     Extract Cookies from LibreWolf browser
@@ -132,7 +124,6 @@ def librewolf(domains: Optional[List[str]] = None) -> CookieList:
     """
     ...
 
-
 def load(domains: Optional[List[str]] = None) -> CookieList:
     """
     Load Cookies from a browser
@@ -142,18 +133,19 @@ def load(domains: Optional[List[str]] = None) -> CookieList:
     """
     ...
 
-def any_browser(db_path: str, domains: Optional[List[str]] = None, key_path: Optional[str] = None) -> CookieList:
+def any_browser(
+    db_path: str, domains: Optional[List[str]] = ..., key_path: Optional[str] = ...
+) -> List[Dict[str, str]]:
     """
-    Extract Cookies from any browser
+    Extract Cookies from any browser.
 
-    :param db_path: path to browser database file
-    :param domains: Optional list of domains to extract only from them
-    :param key_path: Optional path to key file used to decrypt db_path
-    :return: A list of dictionaries of cookies
+    :param db_path: Path to browser database file.
+    :param domains: Optional list of domains to extract cookies only from these domains.
+    :param key_path: Optional path to key file used to decrypt `db_path`.
+    :return: A list of dictionaries of cookies.
     """
     ...
 
-
 # Windows
 if platform == "win32":
     def internet_explorer(domains: Optional[List[str]] = None) -> CookieList:
@@ -174,7 +166,6 @@ if platform == "win32":
         """
         ...
 
-
 # MacOS
 if platform == "darwin":
     def safari(domains: Optional[List[str]] = None) -> CookieList:
@@ -185,5 +176,3 @@ if platform == "darwin":
         :return: A list of dictionaries of cookies
         """
         ...
-
-


Test patch: