conf.py

Author: Abimereki Muzaale

_config.yml

@@ -6,6 +6,32 @@ author: ADM
 copyright: "2025"
 logo: https://upload.wikimedia.org/wikipedia/commons/thumb/c/c3/Python-logo-notext.svg/230px-Python-logo-notext.svg.png
 
+# Sphinx configuration options directly in _config.yml
+sphinx:
+  config:
+    project: "Run Python"
+    author: "ADM"
+    release: "2025"
+    extensions:
+      - myst_parser
+      - sphinx.ext.autodoc
+      - sphinx.ext.napoleon
+      - sphinx.ext.viewcode
+      - sphinx.ext.todo
+      - sphinx.ext.githubpages
+      - sphinxcontrib.bibtex
+      - sphinx_multitoc_numbering
+      - myst_nb
+    suppress_warnings:
+      - etoc.toctree
+      - epub.unknown_project_files
+      - image.nonlocal_uri
+      - ref.ref
+      - myst.header
+      - mystnb.exec
+    html_theme: "sphinx_rtd_theme"
+    epub_show_urls: "footnote"
+
 # Force re-execution of notebooks on each build.
 # See https://jupyterbook.org/content/execute.html
 execute:

conf.py

@@ -0,0 +1,43 @@
+# Configuration file for the Sphinx documentation builder.
+
+# -- Project information -----------------------------------------------------
+project = 'Run Python'
+author = 'ADM'
+release = '2025'
+
+# -- General configuration ---------------------------------------------------
+extensions = [
+    'myst_parser',
+    'sphinx.ext.autodoc',
+    'sphinx.ext.napoleon',
+    'sphinx.ext.viewcode',
+    'sphinx.ext.todo',
+    'sphinx.ext.githubpages',
+    'sphinxcontrib.bibtex',
+    'sphinx_multitoc_numbering',
+    'myst_nb'
+]
+
+# Suppress specific warnings
+suppress_warnings = [
+    'etoc.toctree',
+    'epub.unknown_project_files',
+    'image.nonlocal_uri',
+    'ref.ref',
+    'myst.header',
+    'mystnb.exec'
+]
+
+# -- Options for HTML output -------------------------------------------------
+html_theme = 'sphinx_rtd_theme'
+
+# -- Options for EPUB output -------------------------------------------------
+epub_show_urls = 'footnote'
+
+# -- Options for LaTeX output ------------------------------------------------
+latex_documents = [
+    ('index', 'book.tex', 'Run Python Documentation', 'ADM', 'manual'),
+]
+
+# -- Additional options ------------------------------------------------------
+# You can add any additional Sphinx options here if needed.

notebooks.ipynb

@@ -41,8 +41,12 @@
     "    \"sqlalchemy\", \"pydantic\", \"pytest\", \"coverage\", \"sphinx\", \"yfinance\"\n",
     "]\n",
     "\n",
-    "# Install the packages\n",
-    "run_command(f\"source {activate_script} && pip install \" + \" \".join(packages))\n",
+    "# Split the packages into smaller batches\n",
+    "batches = [packages[i:i + 10] for i in range(0, len(packages), 10)]\n",
+    "\n",
+    "# Install the packages in batches\n",
+    "for batch in batches:\n",
+    "    run_command(f\"source {activate_script} && pip install \" + \" \".join(batch))\n",
     "\n",
     "# Install IRkernel for R\n",
     "run_command(f\"source {activate_script} && Rscript -e \\\"install.packages('IRkernel', repos='https://cloud.r-project.org/')\\\"\")\n",
@@ -52,7 +56,7 @@
     "run_command(f\"source {activate_script} && pip install stata_kernel\")\n",
     "run_command(f\"source {activate_script} && python -m stata_kernel.install\")\n",
     "\n",
-    "print(\"Environment setup complete.\")"
+    "print(\"Environment setup complete.\")\n"
    ]
   },
   {