docs: update build procedure and fix warning

Revert requirements to known working version on readthedocs

Signed-off-by: Sergio Schvezov <sergio.schvezov@canonical.com>

.readthedocs.yml

@@ -23,3 +23,5 @@ python:
   install:
     - requirements: requirements.txt
     - requirements: requirements-dev.txt
+    - method: pip
+      path: .

craft_store/store_client.py

@@ -18,20 +18,17 @@
 
 import base64
 import json
-from typing import TYPE_CHECKING, Any, Dict, Sequence
+from typing import Any, Dict, Sequence
 from urllib.parse import urlparse
 
 import requests
 from macaroonbakery import bakery, httpbakery
 from pymacaroons.serializers import json_serializer
 
-from . import errors
+from . import endpoints, errors
 from .auth import Auth
 from .http_client import HTTPClient
 
-if TYPE_CHECKING:
-    from . import endpoints
-
 
 def _macaroon_to_json_string(macaroon) -> str:
     return macaroon.serialize(json_serializer.JsonSerializer())
@@ -78,14 +75,14 @@ def __init__(
         self,
         *,
         base_url: str,
-        endpoints: "endpoints.Endpoints",
+        endpoints: endpoints.Endpoints,
         application_name: str,
         user_agent: str,
     ) -> None:
         """Initialize the Store Client.
 
         :param base_url: the base url of the API endpoint.
-        :param endpoints: :data:`endpoints.CHARMHUB` or :data:`endpoints.SNAP_STORE`.
+        :param endpoints: :data:`.endpoints.CHARMHUB` or :data:`.endpoints.SNAP_STORE`.
         :param application_name: the name application using this class, used for the keyring.
         :param user_agent: User-Agent header to use for HTTP(s) requests.
         """

requirements-dev.txt

@@ -15,7 +15,7 @@ colorama==0.4.4
 coverage==5.5
 cryptography==3.4.8
 distlib==0.3.3
-docutils==0.17.1
+docutils==0.16
 filelock==3.0.12
 flake8==3.9.2
 idna==3.2
@@ -66,11 +66,11 @@ rfc3986==1.5.0
 SecretStorage==3.3.1
 six==1.16.0
 snowballstemmer==2.1.0
-Sphinx==4.2.0
+Sphinx==4.1.2
 sphinx-autodoc-typehints==1.12.0
 sphinx-jsonschema==1.16.11
 sphinx-pydantic==0.1.1
-sphinx-rtd-theme==1.0.0
+sphinx-rtd-theme==0.5.2
 sphinxcontrib-applehelp==1.0.2
 sphinxcontrib-devhelp==1.0.2
 sphinxcontrib-htmlhelp==2.0.0