Add SDK documentation using mkdocs

Author: goncalossilva

docs/api.md

@@ -0,0 +1,4 @@
+# API Client
+
+::: todoist_api_python.api.TodoistAPI
+::: todoist_api_python.api.ResultsPaginator

docs/api_async.md

@@ -0,0 +1,3 @@
+# API Client (async)
+
+::: todoist_api_python.api_async.TodoistAPIAsync

docs/assets/favicon.ico

@@ -0,0 +1,39 @@
+# Authentication
+
+This module provides functions to help authenticate with Todoist using the OAuth protocol.
+
+## Quick start
+
+```python
+import uuid
+from todoist_api_python.authentication import get_access_token, get_authentication_url
+
+# 1. Generate a random state
+state = uuid.uuid4()
+
+# 2. Get authorization url
+url = get_authentication_url(
+    client_id="YOUR_CLIENT_ID",
+    scopes=["data:read", "task:add"],
+    state=uuid.uuid4()
+)
+
+# 3.Redirect user to url
+# 4. Handle OAuth callback and get code
+code = "CODE_YOU_OBTAINED"
+
+# 5. Exchange code for access token
+auth_result = get_access_token(
+    client_id="YOUR_CLIENT_ID",
+    client_secret="YOUR_CLIENT_SECRET",
+    code=code,
+)
+
+# 6. Ensure state is consistent, and done!
+assert(auth_result.state == state)
+access_token = auth_result.access_token
+```
+
+For detailed implementation steps and security considerations, refer to the [Todoist OAuth documentation](https://todoist.com/api/v1/docs#tag/Authorization/OAuth).
+
+::: todoist_api_python.authentication

docs/assets/logo.svg

@@ -0,0 +1 @@
+--8<-- "CHANGELOG.md"

docs/authentication.md

@@ -0,0 +1,45 @@
+# Overview
+
+This is the official Python SDK for the Todoist API.
+
+## Installation
+
+```bash
+pip install todoist-api-python
+```
+
+Or add the project as a dependency in `pyproject.toml`:
+
+```toml
+dependencies = [
+  "todoist-api-python>=3.0.0,<4",
+]
+```
+
+## Usage
+
+Here's an example of initializing the API client, fetching a task, and paginating through its comments:
+
+```python
+from todoist_api_python.api import TodoistAPI
+
+api = TodoistAPI("YOUR_API_TOKEN")
+
+task = api.get_task("6X4Vw2Hfmg73Q2XR")
+print(f"Task: {task.content}")
+
+comments_iter = api.get_comments(task_id=task.id)
+for comments in comments_iter:
+    for comment in comments:
+        print(f"Comment: {comment.content}")
+```
+
+## Quick start
+
+- [Authentication](authentication.md)
+- [API client](api.md)
+- [Models](models.md)
+
+## API reference
+
+For detailed reference documentation, have a look at the [API documentation](https://developer.todoist.com/).

docs/changelog.md

@@ -0,0 +1,7 @@
+# Models
+
+::: todoist_api_python.models
+    options:
+      show_if_no_docstring: true
+      show_labels: false
+      members_order: alphabetical

docs/index.md

@@ -0,0 +1,57 @@
+site_name: "Todoist Python SDK"
+
+repo_url: https://github.com/Doist/todoist-api-python/
+
+theme:
+  name: material
+  logo: assets/logo.svg
+  favicon: assets/favicon.ico
+  palette:
+    - media: "(prefers-color-scheme)"
+      primary: red
+      toggle:
+        icon: material/brightness-4
+        name: Switch to dark mode
+    - media: "(prefers-color-scheme: dark)"
+      scheme: slate
+      primary: black
+      toggle:
+        icon: material/brightness-7
+        name: Switch to light mode
+    - media: "(prefers-color-scheme: light)"
+      scheme: default
+      primary: red
+      toggle:
+        icon: material/brightness-auto
+        name: Follow system preference
+  features:
+    - navigation.footer
+
+extra:
+  social:
+    - icon: fontawesome/brands/x-twitter
+      link: https://x.com/doistdevs
+    - icon: fontawesome/brands/github
+      link: https://github.com/doist
+
+markdown_extensions:
+  - pymdownx.highlight:
+      anchor_linenums: true
+      line_spans: __span
+      pygments_lang_class: true
+  - pymdownx.inlinehilite
+  - pymdownx.snippets
+  - pymdownx.superfences
+
+plugins:
+  - search
+  - mkdocstrings:
+      handlers:
+        python:
+          options:
+            docstring_style: sphinx
+            backlinks: true
+            filters: ["!^_"]
+            show_symbol_type_toc: True
+            signature_crossrefs: true
+            unwrap_annotated: true

docs/models.md

@@ -34,6 +34,12 @@ dev = [
   "ruff>=0.11.0,<0.12",
 ]
 
+docs = [
+  "mkdocs>=1.6.1,<2.0.0",
+  "mkdocstrings[python]>=0.29.1,<1.0.0",
+  "mkdocs-material>=9.6.11,<10.0.0",
+]
+
 [tool.hatch.build.targets.sdist]
 include = ["LICENSE"]