feat: auto docs using mkdocstrings

- new doc dependencies: `mkdocs`, `mkdocs-material` and `mkdocstrings`
- auto reference documentation using `mkdocstrings`
- moves `pytest` to "tests" dependency group
- install only pytest for testing in github-ci

Author: yozachar

.github/workflows/main.yml

@@ -48,7 +48,7 @@ jobs:
       #----------------------------------------------
       - name: Install dependencies
         # if: steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
-        run: poetry install --no-interaction --no-root
+        run: poetry install --no-interaction --no-root --no-ansi --only tests
       #----------------------------------------------
       #              run test suite
       #----------------------------------------------

docs/index.md

@@ -0,0 +1,15 @@
+# Reference
+
+::: validators.utils
+
+::: validators.between
+
+::: validators.btc_address
+
+::: validators.card
+
+::: validators.domain
+
+::: validators.email
+
+::: validators.length

mkdocs.yml

@@ -0,0 +1,27 @@
+site_name: "validators"
+site_description: "Automatic documentation from sources, for MkDocs."
+site_url: "https://python-validators.github.io/"
+repo_url: "https://github.com/python-validators/validators"
+edit_uri: "tree/master/docs/"
+repo_name: "validators/validators"
+site_dir: "site"
+watch: [README.md, validators/]
+
+nav:
+  - Reference: index.md
+
+theme:
+  name: material
+
+plugins:
+  - search
+  - mkdocstrings:
+      handlers:
+        python:
+          import:
+            - https://docs.python-requests.org/en/master/objects.inv
+
+extra:
+  social:
+    - icon: fontawesome/brands/github
+      link: https://github.com/python-validators/validators