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

.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:/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:/python-validators/validators