doc: command docstrings can be in Sphinx format

And thanks to sphinx-click-rst-to-ansi-formatter this will display
correctly in the terminal.

https://github.com/hakonhagland/sphinx-click-rst-to-ansi-formatter

Author: azmeuk

.github/workflows/tests.yaml

@@ -21,7 +21,6 @@ jobs:
           - '3.12'
           - '3.11'
           - '3.10'
-          - '3.9'
     steps:
       - uses: actions/checkout@v4
       - name: Install Poetry
@@ -45,7 +44,7 @@ jobs:
         uses: snok/install-poetry@v1
       - uses: actions/setup-python@v5
         with:
-          python-version: '3.9'
+          python-version: '3.10'
           cache: 'poetry'
       - run: sed -i -E 's/"(\^|>=)([0-9\.]+)([^,]*)"/"==\2"/' pyproject.toml
       - run: sed -i -E 's/python = "==/python = "^/' pyproject.toml

poetry.lock

@@ -25,9 +25,10 @@ classifiers = [
 ]
 
 [tool.poetry.dependencies]
-python = "^3.9"
+python = "^3.10"
 click = "^8.1.7"
 requests = "^2.32.2"
+sphinx-click-rst-to-ansi-formatter = "^0.1.0"
 
 [tool.poetry.group.dev.dependencies]
 pytest = "^8.2.1"
@@ -84,7 +85,6 @@ isolated_build = true
 skipsdist = true
 envlist =
     style
-    py39
     py310
     py311
     py312

pyproject.toml

@@ -2,7 +2,9 @@
 
 import click
 import requests
+from sphinx_click.rst_to_ansi_formatter import make_rst_to_ansi_formatter
 
+DOC_URL = "https://scim-cli.readthedocs.io/"
 BASE_HEADERS = {
     "Accept": "application/scim+json",
     "Content-Type": "application/scim+json",
@@ -22,7 +24,7 @@ def cli(ctx, url):
         ctx.obj["STDIN"] = json.loads(stdin)
 
 
-@cli.command()
+@cli.command(cls=make_rst_to_ansi_formatter(DOC_URL))
 @click.pass_context
 def get(ctx):
     """Perform a SCIM GET request.
@@ -43,7 +45,7 @@ def get(ctx):
     click.echo(response.text)
 
 
-@cli.command()
+@cli.command(cls=make_rst_to_ansi_formatter(DOC_URL))
 @click.pass_context
 def post(ctx):
     """Perform a SCIM POST request.
@@ -64,7 +66,7 @@ def post(ctx):
     click.echo(response.text)
 
 
-@cli.command()
+@cli.command(cls=make_rst_to_ansi_formatter(DOC_URL))
 @click.pass_context
 def put(ctx):
     """Perform a SCIM PUT request.
@@ -85,7 +87,7 @@ def put(ctx):
     click.echo(response.text)
 
 
-@cli.command()
+@cli.command(cls=make_rst_to_ansi_formatter(DOC_URL))
 @click.pass_context
 def patch(ctx):
     """Perform a SCIM PATCH request.
@@ -106,7 +108,7 @@ def patch(ctx):
     click.echo(response.text)
 
 
-@cli.command()
+@cli.command(cls=make_rst_to_ansi_formatter(DOC_URL))
 @click.pass_context
 def delete(ctx):
     """Perform a SCIM DELETE request.