Fix #1641

Author: HeaTTheatR

.github/workflows/build.yml

@@ -1,4 +1,5 @@
 name: Build
+
 on:
   push:
     branches-ignore:
@@ -13,70 +14,58 @@ on:
   workflow_dispatch:
 
 jobs:
-
-  # Build job. Builds source distribution (sdist) and binary wheels distribution (bdist_wheel)
   build:
-    name: Build ${{ matrix.dist }} [${{ matrix.python-version }} | ${{ matrix.os }} ${{ matrix.architecture }}]
+    name: Build [${{ matrix.python-version }} | ${{ matrix.os }}]
+    runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
       matrix:
-        # os: [ubuntu-latest, macos-latest, windows-latest] # Build wheels on different systems
-        # python-version: [3.6, 3.7]
-        # architecture: [x64]
-        # dist: [bdist_wheel]
-        include:
-          - os: ubuntu-latest # Modify one element to build source distribution
-            python-version: '3.10'
-            architecture: x64
-            dist: sdist bdist_wheel
-    runs-on: ${{ matrix.os }}
-    env:
-      PYTHONUNBUFFERED: 1
-
+        os: [ubuntu-latest]
+        python-version: ['3.13']
     steps:
-    - name: Checkout
-      uses: actions/checkout@v2
+      - name: Checkout source
+        uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
 
-    - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v2
-      with:
-        python-version: ${{ matrix.python-version }}
-        architecture: ${{ matrix.architecture }}
+      - name: Install build tools
+        run: |
+          python -m pip install --upgrade pip
+          pip install build
 
-    - name: Build
-      run: |
-        python -m pip install --upgrade pip
-        python -m pip install --upgrade setuptools wheel
-        python setup.py ${{ matrix.dist }}
+      - name: Build with `python -m build`
+        run: |
+          python -m build --wheel --sdist
 
-    - name: Upload artifacts
-      uses: actions/upload-artifact@v2
-      with:
-        name: dist
-        path: dist
+      - name: Upload merged artifacts per OS
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist-${{ matrix.os }}
+          path: dist/
+          if-no-files-found: error
 
-  # Deploy job. Uploads distribution to PyPI (only on tags)
   deploy:
     name: Publish to PyPI
     runs-on: ubuntu-latest
     needs: build
     if: github.event_name == 'push' && startsWith(github.event.ref, 'refs/tags')
-    env:
-      PYTHONUNBUFFERED: 1
 
     steps:
-    - name: Checkout
-      uses: actions/checkout@v2
+      - name: Checkout source
+        uses: actions/checkout@v4
+
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: dist
 
-    - name: Download artifacts
-      uses: actions/download-artifact@v2
-      with:
-        name: dist
-        path: dist
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@v1.8.11
+        with:
+          user: __token__
+          password: ${{ secrets.PYPI_TOKEN }}
+          packages_dir: dist/
 
-    - name: Publish to PyPI
-      uses: pypa/gh-action-pypi-publish@v1.5.0
-      with:
-        user: __token__
-        password: ${{ secrets.PYPI_TOKEN }}
-        packages_dir: dist/

.github/workflows/lint.yml

@@ -15,13 +15,15 @@ on:
 jobs:
 
   # Lint job. Runs pre-commit, fails if there are changed files
+  # os, python version and architecture does not matter here
+  # [${{ matrix.python-version }} | ${{ matrix.os }} ${{ matrix.architecture }}]
   lint:
-    name: Check pre-commit [${{ matrix.python-version }} | ${{ matrix.os }} ${{ matrix.architecture }}]
+    name: Check pre-commit 
     strategy:
       fail-fast: true
       matrix:
         os: [ubuntu-latest]
-        python-version: ['3.10']
+        python-version: ['3.13']
         architecture: [x64]
     runs-on: ${{ matrix.os }}
     env:

.github/workflows/release.yml

@@ -35,10 +35,10 @@ jobs:
         fetch-depth: 0
         persist-credentials: ${{ github.event_name != 'workflow_dispatch' }}  # Allow using PAT when making release
 
-    - name: Set up Python 3.10
-      uses: actions/setup-python@v2
+    - name: Set up Python 3.13
+      uses: actions/setup-python@v5
       with:
-        python-version: '3.10'
+        python-version: '3.13'
         architecture: x64
 
     - name: Set up environment

.github/workflows/test.yml

@@ -21,37 +21,32 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
-        python-version: ['3.10']
+        python-version: ['3.13']
         architecture: [x64]
-        kivy-version: [2.1.0]
-        include:
-          - os: windows-latest
-            python-version: '3.10'
-            architecture: x86
-            kivy-version: 2.1.0
+        kivy-version: [2.3.1]
     runs-on: ${{ matrix.os }}
     env:
       PYTHONUNBUFFERED: 1
 
     steps:
     - name: Checkout
-      uses: actions/checkout@v2
+      uses: actions/checkout@v4
 
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v2
+      uses: actions/setup-python@v5
       with:
         python-version: ${{ matrix.python-version }}
         architecture: ${{ matrix.architecture }}
 
     - name: Cache MacOS deps
-      uses: actions/cache@v2
+      uses: actions/cache@v4
       if: startswith(matrix.os, 'macos')
       with:
         path: macos-cache
         key: ${{ runner.OS }}-deps-${{ hashFiles('.ci/macos_versions.sh') }}
 
     - name: Cache MacOS gst-devel deps
-      uses: actions/cache@v2
+      uses: actions/cache@v4
       if: startswith(matrix.os, 'macos')
       with:
         path: macos-cache-gst-devel

.gitignore

@@ -68,3 +68,4 @@ temp
 /kivymd/tools/release/*.zip
 /kivymd/tools/release/temp
 .idea/
+docs/sources

.pre-commit-config.yaml

@@ -13,13 +13,13 @@ repos:
 
   # Sort imports
   - repo: https://github.com/PyCQA/isort
-    rev: 5.13.2
+    rev: 6.0.1
     hooks:
       - id: isort
         additional_dependencies: ["toml"]
 
   # Lint Python
   - repo: https://github.com/PyCQA/flake8
-    rev: 7.0.0
+    rev: 7.2.0
     hooks:
       - id: flake8

.readthedocs.yml

@@ -9,7 +9,7 @@ version: 2
 build:
   os: ubuntu-20.04
   tools:
-    python: "3.10"
+    python: "3.11"
 
 # Build documentation in the docs/ directory with Sphinx
 sphinx:

README.md

@@ -91,7 +91,8 @@ requirements = python3,
     materialyoucolor,
     exceptiongroup,
     asyncgui,
-    asynckivy
+    asynckivy,
+    android
 ```
 
 This will download latest release version of KivyMD from [PyPI](https://pypi.org/project/kivymd).

docs/sources/_extensions/autoapi_kivymd.py

@@ -15,11 +15,13 @@
 
 import autoapi
 import sphinx
+
 # import unidecode
 from autoapi.directives import NestedParse
 from autoapi.extension import LOGGER
 from autoapi.extension import setup as autoapi_setup
 from autoapi.mappers.python.mapper import PythonSphinxMapper
+from autoapi.mappers.python.parser import Parser
 from autoapi.mappers.python.objects import PythonPythonMapper
 from docutils import nodes
 from sphinx.util.console import bold, darkgreen
@@ -108,6 +110,15 @@ def PythonSphinxMapper_output_rst(
         self._output_top_rst(root)
 
 
+def PythonSphinxMapper_read_file(self : PythonSphinxMapper, path, **kwargs):
+    dir_root = kwargs.get("dir_root")
+    if self._use_implicit_namespace:
+        parsed_data = Parser().parse_file_in_namespace(path, dir_root)
+    else:
+        parsed_data = Parser().parse_file(path)
+    return parsed_data
+
+
 def extension_build_finished(app, exception):
     if (
         not app.config.autoapi_keep_files
@@ -149,5 +160,6 @@ def setup(app):
     PythonPythonMapper.pathname = property(PythonPythonMapper_pathname)
     PythonPythonMapper.include_dir = PythonPythonMapper_include_dir
     PythonSphinxMapper.output_rst = PythonSphinxMapper_output_rst
+    PythonSphinxMapper.read_file = PythonSphinxMapper_read_file
     autoapi.extension.build_finished = extension_build_finished
     autoapi_setup(app)

docs/sources/conf.py

@@ -50,7 +50,7 @@
     "navigation_depth": 2,
     "collapse_navigation": False,
     "titles_only": True,
-    "announcement": '''<h6>KivyMD Library Sponsors:</h6>
+    "announcement": """<h6>KivyMD Library Sponsors:</h6>
 <p>
     <a href="https://github.com/PeterSurda" target="_blank">
         <img width="25" src="https://github.com/HeaTTheatR/KivyMD-data/raw/master/gallery/peter.png" alt="Peter Šurda">
@@ -63,7 +63,7 @@
         Best Route Planner - Route Optimization Software
     </a>
 </p>
-''',
+""",
 }
 
 # Pygments style.