[Infra] Update python and sphinx version (#862)

* update Sphinx version (#858)

* Update Python & Sphinx (#859)

* update Sphinx version

* update python to 3.10 and Sphinx 8.1

* upgrade setup-python from v3 to v4

* update python version

* Add SRI attributes to Highlight.js CDN scripts and styles (#860)

* enforce default light mode in sphinx-book-theme (#861)

---------

Co-authored-by: amitnGiniApps <155542316+amitnGiniApps@users.noreply.github.com>

Author: Eyal-Danieli

.github/workflows/ci.yaml

@@ -67,11 +67,11 @@ jobs:
        uses: actions/checkout@v3
        with:
          path: functions
-     # Install python 3.9
-     - name: Install python 3.9
-       uses: actions/setup-python@v3
+     # Install python 3.10.17
+     - name: Install python 3.10.17
+       uses: actions/setup-python@v4
        with:
-         python-version: 3.9
+         python-version: 3.10.17
      # Install dependencies
      - uses: actions/cache@v3
        id: cache

.github/workflows/test-all.yaml

@@ -14,7 +14,7 @@ jobs:
         shell: bash
         run: echo "::set-output name=branch::${GITHUB_REF#refs/heads/}"
         id: myref
- 
+
       - uses: actions/checkout@v4
       - id: set-matrix
         # This is very hacky, but it goes like that:
@@ -66,11 +66,11 @@ jobs:
         uses: actions/checkout@v4
         with:
           path: functions
-      # Install python 3.9
-      - name: Install python 3.9
-        uses: actions/setup-python@v3
+      # Install python 3.10.17
+      - name: Install python 3.10.17
+        uses: actions/setup-python@v4
         with:
-          python-version: 3.9
+          python-version: 3.10.17
       # Install dependencies
       - uses: actions/cache@v3
         id: cache
@@ -99,7 +99,7 @@ jobs:
     runs-on: ubuntu-latest
     needs: run_monorepo_tests
     continue-on-error: false
-    
+
     steps:
       - name: Get the current branch name
         shell: bash
@@ -114,10 +114,10 @@ jobs:
         with:
           repository: mlrun/marketplace
           path: marketplace
-      - name: Install python 3.9
-        uses: actions/setup-python@v3
+      - name: Install python 3.10.17
+        uses: actions/setup-python@v4
         with:
-          python-version: 3.9
+          python-version: 3.10.17
       - name: Install requirements
         run: |
           cd functions

cli/marketplace/_static/css/custom.css

@@ -1,12 +1,49 @@
-.bd-sidebar {
-    display: none;
+html:root {
+    --sd-color-primary: #2750ff;
+    --pst-color-primary: var(--sd-color-primary);
+    --pst-color-link-hover: var(--sd-color-primary);
+    --pst-color-secondary: var(--sd-color-primary);
+    --sd-color-secondary: #6c757d;
+    --sd-color-success: #28a745;
+    --sd-color-info: #2750ff;
+    --sd-color-warning: #e3781a;
+    --sd-color-danger: #dc3545;
+    --sd-color-light: #f8f9fa;
+    --sd-color-muted: #6c757d;
+    --sd-color-dark: #212529;
+    --sd-color-primary-highlight: var(--sd-color-primary);
+    --sd-color-secondary-highlight: #5c636a;
+    --sd-color-success-highlight: #228e3b;
+    --sd-color-info-highlight: var(--sd-color-primary);
+    --sd-color-warning-highlight: #cc986b;
+    --sd-color-danger-highlight: #bb2d3b;
+    --sd-color-light-highlight: #d3d4d5;
+    --sd-color-muted-highlight: #5c636a;
+    --sd-color-dark-highlight: #1c1f23;
+    --sd-color-primary-text: #fff;
+    --sd-color-secondary-text: #fff;
+    --sd-color-success-text: #fff;
+    --sd-color-info-text: #fff;
+    --sd-color-warning-text: #fff;
+    --sd-color-danger-text: #fff;
+    --sd-color-light-text: #212529;
+    --sd-color-muted-text: #fff;
+    --sd-color-dark-text: #fff;
+    --pst-color-accent: var(--sd-color-primary);
+    --pst-color-secondary-highlight: var(--sd-color-primary);
+    --pst-color-table-row-hover-bg: #d8dfff;
+    --bs-dropdown-min-width: 8rem;
 }
 
-.header-article {
-    height: 0;
-    background-color: transparent;
+.bd-sidebar,
+.header-article-items__start,
+.theme-switch-button,
+.search-button,
+.footer-content{
+    display: none !important;
 }
 
-.footer-content {
-    display: none;
+.bd-header-article {
+    position: relative;
+    box-shadow: none !important;
 }

cli/marketplace/conf.template

@@ -13,6 +13,7 @@
 
 import re
 import sys
+import os
 
 sys.path.insert(0, "{{sphinx_docs_target}}")
 
@@ -28,7 +29,7 @@ master_doc = "index"
 # The short X.Y version
 version = "{{version}}"
 release = "{{release}}"
-
+master_doc = "index"
 
 # -- General configuration ---------------------------------------------------
 
@@ -72,6 +73,8 @@ source_suffix = {
     ".md": "myst-nb",
 }
 
+# If you want to mock imports during autodoc
+autodoc_mock_imports = [{{mock_imports}}]
 
 # -- Options for HTML output -------------------------------------------------
 
@@ -86,22 +89,33 @@ html_theme = "sphinx_book_theme"
 html_static_path = ["_static"]
 html_css_files = ["css/custom.css"]
 
+# conf.py
+
+html_context = {
+    "default_mode": "light",  # Enforces light mode on page load
+}
+
 html_theme_options = {
     "repository_url": "{{repository_url}}",
-    "use_repository_button": True,
-    "use_issues_button": True,
-    "use_edit_page_button": True,
+    "repository_branch": "{{repository_branch}}",
+    "path_to_docs": "docs",
     "use_repository_button": False,
     "use_issues_button": False,
     "use_edit_page_button": False,
-    "path_to_docs": "docs",
-    "repository_branch": "{{repository_branch}}",
-    "single_page": True,
+    "home_page_in_toc": False,
     "navigation_with_keys": False,
-    "use_download_button": False,
     "use_fullscreen_button": False,
+    "show_navbar_depth": 1,
+    "theme_dev_mode": False,
+    "launch_buttons": {},
+    "switcher": False,
+    "search_bar_text": "",
+    "search_bar_position": "none",
 }
 
+# Prevents generation of searchindex.js
+html_search = False
+
 html_title = "{{html_title}}"
 html_logo = "{{html_logo}}"
 html_favicon = "{{html_favicon}}"
@@ -124,3 +138,12 @@ def copy_doc(src, dest, title=""):
                     changed = True
                 out.write(line)
 {% endraw %}
+
+# -- Post-build cleanup ------------------------------------------------------
+def remove_searchtools(app, exception):
+    searchtools_path = os.path.join(app.outdir, '_static', 'searchtools.js')
+    if os.path.exists(searchtools_path):
+        os.remove(searchtools_path)
+
+def setup(app):
+    app.connect("build-finished", remove_searchtools)

cli/marketplace/python.html

@@ -5,9 +5,22 @@
     <meta charset="UTF-8">
     <meta content="IE=edge" http-equiv="X-UA-Compatible">
     <meta content="width=device-width, initial-scale=1.0" name="viewport">
-    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.7.2/styles/atom-one-dark.min.css">
-    <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.7.2/highlight.min.js"></script>
-    <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.7.2/languages/python.min.js"></script>
+    <link
+            href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.11.1/styles/atom-one-dark.min.css"
+            rel="stylesheet"
+            integrity="sha384-oaMLBGEzBOJx3UHwac0cVndtX5fxGQIfnAeFZ35RTgqPcYlbprH9o9PUV/F8Le07"
+            crossorigin="anonymous"
+    />
+    <script
+            src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.11.1/highlight.min.js"
+            integrity="sha384-RH2xi4eIQ/gjtbs9fUXM68sLSi99C7ZWBRX1vDrVv6GQXRibxXLbwO2NGZB74MbU"
+            crossorigin="anonymous"
+    ></script>
+    <script
+            src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.11.1/languages/python.min.js"
+            integrity="sha384-eXRt+aAa2ig1yFVDQCLis8k9s/1dikTcigj+/R07yNdIxc8BAG/b1uHDyEW3of17"
+            crossorigin="anonymous"
+    ></script>
     <title>Source</title>
     <script>hljs.highlightAll();</script>
 </head>
@@ -19,4 +32,4 @@
         </code>
     </pre>
 </body>
-</html>
+</html>

cli/marketplace/yaml.html

@@ -5,9 +5,22 @@
     <meta charset="UTF-8">
     <meta content="IE=edge" http-equiv="X-UA-Compatible">
     <meta content="width=device-width, initial-scale=1.0" name="viewport">
-    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.7.2/styles/atom-one-dark.min.css">
-    <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.7.2/highlight.min.js"></script>
-    <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.7.2/languages/yaml.min.js"></script>
+    <link
+            href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.11.1/styles/atom-one-dark.min.css"
+            rel="stylesheet"
+            integrity="sha384-oaMLBGEzBOJx3UHwac0cVndtX5fxGQIfnAeFZ35RTgqPcYlbprH9o9PUV/F8Le07"
+            crossorigin="anonymous"
+    />
+    <script
+            src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.11.1/highlight.min.js"
+            integrity="sha384-RH2xi4eIQ/gjtbs9fUXM68sLSi99C7ZWBRX1vDrVv6GQXRibxXLbwO2NGZB74MbU"
+            crossorigin="anonymous"
+    ></script>
+    <script
+            src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.11.1/languages/yaml.min.js"
+            integrity="sha384-A/iMReLA0Bo3tLydBIoOQXQzYnrwL90jkHYUubrtERUGCbIuU7U0EHge0Xd2s5sr"
+            crossorigin="anonymous"
+    ></script>
     <title>Source</title>
     <script>hljs.highlightAll();</script>
 </head>
@@ -19,4 +32,4 @@
         </code>
     </pre>
 </body>
-</html>
+</html>

requirements.txt

@@ -6,11 +6,11 @@ pipenv
 myst_nb
 black~=22.0
 isort~=5.7
-sphinx==4.0.2
-sphinx-book-theme==0.3.3
-sphinx-togglebutton==0.3.1
-sphinxcontrib-applehelp<=1.0.7
-sphinxcontrib.devhelp<=1.0.5
-sphinxcontrib-htmlhelp<=2.0.4
-sphinxcontrib-serializinghtml<=1.1.9
-sphinxcontrib-qthelp<=1.0.6
+sphinx~=8.1.0
+sphinx-book-theme~=1.1.3
+sphinx-togglebutton==0.3.2
+sphinxcontrib-applehelp==1.0.8
+sphinxcontrib-devhelp==1.0.6
+sphinxcontrib-htmlhelp==2.0.6
+sphinxcontrib-serializinghtml==1.1.10
+sphinxcontrib-qthelp==1.0.7