chore: try using stubdoc to generate documentation

Author: barjin

.github/workflows/docs.yaml

@@ -102,8 +102,9 @@ jobs:
           source .venv/bin/activate
           uv sync --active
           # comment out cookies module import
-          sed -i 's/from .cookies/#from .cookies/' ./python/impit/__init__.pyi
+          sed -i 's/from .cookies/#from .cookies/' ./python/impit/impit.pyi
           sed -i 's/from .cookies/#from .cookies/' ./python/impit/__init__.py
+          sed -i 's/__version__/#__version__/' ./python/impit/__init__.py
           # copy empty impit.py to avoid Sphinx errors
           cp ./docs/stub.py ./python/impit/impit.py
 

impit-python/docs/conf.py

@@ -16,7 +16,9 @@
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
 
-extensions = ['sphinx.ext.autodoc', 'sphinx.ext.coverage', 'sphinx.ext.napoleon', 'myst_parser']
+extensions = ['stubdoc', 'sphinx.ext.autodoc', 'sphinx.ext.coverage', 'sphinx.ext.napoleon', 'myst_parser']
+
+module_names = ["impit"]
 
 templates_path = ['_templates']
 exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']

impit-python/pyproject.toml

@@ -28,7 +28,6 @@ keywords = [
     "browser",
     "impersonation",
 ]
-dependencies = []
 
 [project.urls]
 "Homepage" = "https://apify.github.io/impit/"
@@ -52,6 +51,7 @@ dev = [
     "sphinx>=7.4.7",
     "myst-parser>=3.0.1",
     "furo",
+    "stubdoc",
 ]
 
 [tool.maturin]
@@ -126,3 +126,5 @@ warn_return_any = true
 warn_unreachable = true
 warn_unused_ignores = true
 
+[tool.uv.sources]
+stubdoc = { git = "https://github.com/bayashi-cl/stubdoc" }