fix(docs): update (#7)

ndonkoHenri · Copilot · web-flow · commit 0e64efc7546c · 2025-07-27T13:42:40.000-07:00
* initial commit

* remove mdformat from pre-commit

* update mkdocs watch items | unshow `Event.get_event_field_type`

* fix separate_signature in Enums

* fixes

* lint dependency group

* Update src/flet_geolocator/geolocator.py

Co-authored-by: Copilot &lt;175728472+Copilot@users.noreply.github.com&gt;

---------

Co-authored-by: Copilot &lt;175728472+Copilot@users.noreply.github.com&gt;
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
@@ -4,6 +4,7 @@ on:
   push:
     branches:
       - main
+      - dev
     paths:
       - 'LICENSE'
       - 'CHANGELOG.md'
@@ -52,7 +53,7 @@ jobs:
       - name: Install dependencies
         run: |
           uv pip install -e .
-          uv pip install --group docs
+          uv pip install --group docs --group lint
 
       - name: Deploy to GitHub Pages
         run: uv run mkdocs gh-deploy --force
diff --git a/.gitignore b/.gitignore
@@ -1,6 +1,135 @@
-*.egg-info/
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
 build/
 develop-eggs/
 dist/
-.DS_store
-.venv/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+uv.lock
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# VS Code
+.vscode/
+
+# PDM
+.pdm.toml
+__pypackages__/
+
+.DS_Store
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -1,9 +1,20 @@
 repos:
-  - repo: https://github.com/pycqa/isort
-    rev: 5.13.2
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.12.5
     hooks:
-      - id: isort
-  - repo: https://github.com/ambv/black
-    rev: 22.12.0
+      # Run the linter.
+      - id: ruff
+        args: [ --fix ]
+      # Run the formatter.
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
     hooks:
-      - id: black
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
+
+  - repo: https://github.com/aio-libs/sort-all
+    rev: v1.3.0
+    hooks:
+      - id: sort-all
diff --git a/docs/types/geolocator_configuration.md b/docs/types/geolocator_configuration.md
@@ -1 +1 @@
-::: flet_geolocator.types.GeolocatorPosition
+::: flet_geolocator.types.GeolocatorConfiguration
diff --git a/docs/types/geolocator_permission_status.md b/docs/types/geolocator_permission_status.md
@@ -1 +1,3 @@
-::: flet_geolocator.types.GeolocatorPermissionStatus
+::: flet_geolocator.types.GeolocatorPermissionStatus
+    options:
+        separate_signature: false
diff --git a/docs/types/geolocator_position_accuracy.md b/docs/types/geolocator_position_accuracy.md
@@ -1 +1,3 @@
-::: flet_geolocator.types.GeolocatorPositionAccuracy
+::: flet_geolocator.types.GeolocatorPositionAccuracy
+    options:
+        separate_signature: false
diff --git a/examples/geolocator_example/src/main.py b/examples/geolocator_example/src/main.py
@@ -65,7 +65,7 @@ async def handle_open_location_settings(e):
     async def handle_open_app_settings(e):
         p = await gl.open_app_settings_async()
         page.close(app_settings_dlg)
-        if p is True:
+        if p:
             show_snackbar("App settings opened successfully.")
         else:
             show_snackbar("App settings could not be opened.")
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -2,7 +2,7 @@
 site_name: "flet-geolocator"
 site_url: https://flet-dev.github.io/flet-geolocator/
 site_author: Flet Contributors
-site_description: Adds geolocation capabilities to your Flet apps.
+site_description: A Flet extension that adds geolocation capabilities to your apps.
 
 # Repository
 edit_uri: edit/main/docs/
@@ -79,16 +79,16 @@ nav:
   - API Reference:
       - Geolocator: geolocator.md
       - Types:
-        - ForegroundNotificationConfiguration: foreground_notification_configuration.md
-        - GeolocatorAndroidConfiguration: geolocator_android_configuration.md
-        - GeolocatorConfiguration: geolocator_configuration.md
-        - GeolocatorIosActivityType: geolocator_ios_activity_type.md
-        - GeolocatorIosConfiguration: geolocator_ios_configuration.md
-        - GeolocatorPermissionStatus: geolocator_permission_status.md
-        - GeolocatorPosition: geolocator_position.md
-        - GeolocatorPositionAccuracy: geolocator_position_accuracy.md
-        - GeolocatorPositionChangeEvent: geolocator_position_change_event.md
-        - GeolocatorWebConfiguration: geolocator_web_configuration.md
+          - ForegroundNotificationConfiguration: types/foreground_notification_configuration.md
+          - GeolocatorAndroidConfiguration: types/geolocator_android_configuration.md
+          - GeolocatorConfiguration: types/geolocator_configuration.md
+          - GeolocatorIosActivityType: types/geolocator_ios_activity_type.md
+          - GeolocatorIosConfiguration: types/geolocator_ios_configuration.md
+          - GeolocatorPermissionStatus: types/geolocator_permission_status.md
+          - GeolocatorPosition: types/geolocator_position.md
+          - GeolocatorPositionAccuracy: types/geolocator_position_accuracy.md
+          - GeolocatorPositionChangeEvent: types/geolocator_position_change_event.md
+          - GeolocatorWebConfiguration: types/geolocator_web_configuration.md
   - Changelog: changelog.md
   - License: license.md
 
@@ -99,15 +99,20 @@ validation:
   unrecognized_links: warn
   anchors: warn
 
+# Watch
 watch:
   - docs
-  - src
+  - src/flet_geolocator
+  - CHANGELOG.md
+  - LICENSE
+  - README.md
 
 # Plugins
 plugins:
   # - footnotes
   - search:
       lang: en
+  - open-in-new-tab
   - mike:
       alias_type: symlink
   - glightbox
@@ -132,21 +137,17 @@ plugins:
             show_labels: false
             show_if_no_docstring: true
             docstring_section_style: spacy
+            separate_signature: true
             inherited_members: true
             preload_modules: [ flet ]
             filters:
               - "!^_"   # Exclude private members starting with only one underscore
-              - "!before_update"
-              - "!before_event"
-              - "!clean"
-              - "!did_mount"
-              - "!init"
-              - "!is_isolated"
-              - "!update"
-              - "!will_unmount"
+              - "!get_event_field_type"
             extensions:
               - griffe_modernized_annotations
+              - griffe_warnings_deprecated
           inventories:
+            - url: https://docs.flet.dev/objects.inv
             - url: https://docs.python.org/3/objects.inv
               domains: [ py, std ]
             - url: https://typing-extensions.readthedocs.io/en/latest/objects.inv
diff --git a/pyproject.toml b/pyproject.toml
@@ -20,22 +20,43 @@ Issues = "https://github.com/flet-dev/flet-geolocator/issues"
 "flutter.flet_geolocator" = ["**/*"]
 
 [dependency-groups]
+test = [
+    "pytest >=7.2.0",
+]
+lint = [
+    "ruff >=0.11.7",
+]
 dev = [
-    "pre-commit>=4.2.0",
-    "ruff>=0.11.7",
+    "pre-commit >=4.2.0",
+    { include-group = 'lint' },
+    { include-group = 'test' },
+]
+docs-coverage = [
+    "docstr-coverage >=2.3.2",
 ]
 docs = [
-    "mkdocs",
-    "mkdocs-material",
-    "mkdocstrings[python]",
-    "mkdocstrings-python-xref",
-    "mike",
-    "markdown>=3.6",
-    "pymdown-extensions",
-    "mkdocs-glightbox",
-    "mkdocs-section-index",
-    "griffe-modernized-annotations",
-    "pygments>=2.16",
+    "mkdocs >=1.6.1",
+    "mkdocs-material >=9.6.15",
+    "mkdocstrings-python >=1.16.12",
+    "mkdocstrings-python-xref >=1.16.3",
+    "mike >=2.1.3",
+    "markdown >=3.6",
+    "pymdown-extensions >=10.16",
+    "mkdocs-exclude >=1.0.2",
+    "mkdocs-glightbox >=0.4.0",
+    "mkdocs-open-in-new-tab >=1.0.8",
+    "mkdocs-section-index >=0.3.10",
+    "griffe-modernized-annotations >=1.0.8",
+    "griffe-warnings-deprecated >=1.1.0",
+    "pygments >=2.16",
+    "markdown-exec[ansi] >=1.11.0",
+    "pydocstyle >=6.3.0",
+    "linkcheckmd >=1.4.0",
+    { include-group = 'docs-coverage' },
+]
+all = [
+    { include-group = 'dev' },
+    { include-group = 'docs' },
 ]
 
 [build-system]
@@ -64,6 +85,7 @@ select = [
     "I"
 ]
 preview = true
+pydocstyle = { convention = 'google' }
 
 [tool.ruff.format]
 quote-style = "double"
diff --git a/src/flet_geolocator/__init__.py b/src/flet_geolocator/__init__.py
@@ -11,3 +11,17 @@
     GeolocatorPositionChangeEvent,
     GeolocatorWebConfiguration,
 )
+
+__all__ = [
+    "ForegroundNotificationConfiguration",
+    "Geolocator",
+    "GeolocatorAndroidConfiguration",
+    "GeolocatorConfiguration",
+    "GeolocatorIosActivityType",
+    "GeolocatorIosConfiguration",
+    "GeolocatorPermissionStatus",
+    "GeolocatorPosition",
+    "GeolocatorPositionAccuracy",
+    "GeolocatorPositionChangeEvent",
+    "GeolocatorWebConfiguration",
+]
diff --git a/src/flet_geolocator/geolocator.py b/src/flet_geolocator/geolocator.py
diff --git a/src/flet_geolocator/types.py b/src/flet_geolocator/types.py
diff --git a/src/flutter/flet_geolocator/pubspec.yaml b/src/flutter/flet_geolocator/pubspec.yaml

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-::: flet_geolocator.types.GeolocatorPosition`
	`1`	`+::: flet_geolocator.types.GeolocatorConfiguration`