[security] update docs dependencies (#227)

Why
===
* Dependabot has a bunch of warnings about the dependencies of our doc
generation pipeline.
* While probably not critical, let's resolve them

What changed
===
* Update deps
* Run pip-compile
* Fix error in doc formatting

Test plan
===
* ran `poetry run make html` and saw a working doc website with no
errors or warnings in the CLI output

docs/requirements.in

@@ -1,11 +1,11 @@
 typing_extensions>=4,<5
 Flask>=2.0.0
-Werkzeug>=2,<4
-aiohttp>=3.6.2
+Werkzeug>=3.0.6,<4
+aiohttp>=3.9.4
 requests>=2.25.1
 pyseto>=^1.6.11
 protobuf>=^4.21.8
-urllib3>=1.26,<3
+urllib3>=2.2.2,<3
 aiohttp-retry>=2.8.3
-sphinx-autodoc-typehints>=1.0.0,<3
-sphinx_click>=4.0.0,<6.0.0
+sphinx-autodoc-typehints>=3.1.0
+sphinx_click>=6.0.0

docs/requirements.txt

@@ -1,124 +1,130 @@
 #
-# This file is autogenerated by pip-compile with Python 3.10
+# This file is autogenerated by pip-compile with Python 3.12
 # by the following command:
 #
 #    pip-compile
 #
-aiohttp==3.9.3
+aiohappyeyeballs==2.4.6
+    # via aiohttp
+aiohttp==3.11.12
     # via
     #   -r requirements.in
     #   aiohttp-retry
-aiohttp-retry==2.8.3
+aiohttp-retry==2.9.1
     # via -r requirements.in
-aiosignal==1.3.1
+aiosignal==1.3.2
     # via aiohttp
-alabaster==0.7.16
+alabaster==1.0.0
     # via sphinx
 argon2-cffi==23.1.0
     # via pyseto
 argon2-cffi-bindings==21.2.0
     # via argon2-cffi
-async-timeout==4.0.3
-    # via aiohttp
-attrs==23.2.0
+attrs==25.1.0
     # via aiohttp
-babel==2.14.0
+babel==2.17.0
     # via sphinx
-blinker==1.7.0
+blinker==1.9.0
     # via flask
-certifi==2024.2.2
+certifi==2025.1.31
     # via requests
-cffi==1.16.0
+cffi==1.17.1
     # via
     #   argon2-cffi-bindings
     #   cryptography
-charset-normalizer==3.3.2
+charset-normalizer==3.4.1
     # via requests
-click==8.1.7
+click==8.1.8
     # via
     #   flask
     #   sphinx-click
-cryptography==42.0.2
+cryptography==44.0.1
     # via pyseto
-docutils==0.20.1
+docutils==0.21.2
     # via
     #   sphinx
     #   sphinx-click
-flask==3.0.2
+flask==3.1.0
     # via -r requirements.in
-frozenlist==1.4.1
+frozenlist==1.5.0
     # via
     #   aiohttp
     #   aiosignal
-idna==3.6
+idna==3.10
     # via
     #   requests
     #   yarl
 imagesize==1.4.1
     # via sphinx
 iso8601==2.1.0
     # via pyseto
-itsdangerous==2.1.2
+itsdangerous==2.2.0
     # via flask
-jinja2==3.1.3
+jinja2==3.1.5
     # via
     #   flask
     #   sphinx
-markupsafe==2.1.5
+markupsafe==3.0.2
     # via
     #   jinja2
     #   werkzeug
-multidict==6.0.5
+multidict==6.1.0
     # via
     #   aiohttp
     #   yarl
-packaging==23.2
+packaging==24.2
     # via sphinx
-protobuf==5.26.0rc2
+propcache==0.2.1
+    # via
+    #   aiohttp
+    #   yarl
+protobuf==6.30.0rc1
     # via -r requirements.in
-pycparser==2.21
+pycparser==2.22
     # via cffi
-pycryptodomex==3.20.0
+pycryptodomex==3.21.0
     # via pyseto
-pygments==2.17.2
+pygments==2.19.1
     # via sphinx
-pyseto==1.7.8
+pyseto==1.8.2
     # via -r requirements.in
-requests==2.31.0
+requests==2.32.3
     # via
     #   -r requirements.in
     #   sphinx
+roman-numerals-py==3.0.0
+    # via sphinx
 snowballstemmer==2.2.0
     # via sphinx
-sphinx==7.2.6
+sphinx==8.2.0
     # via
     #   sphinx-autodoc-typehints
     #   sphinx-click
-sphinx-autodoc-typehints==2.0.0
+sphinx-autodoc-typehints==3.1.0
     # via -r requirements.in
-sphinx-click==5.1.0
+sphinx-click==6.0.0
     # via -r requirements.in
-sphinxcontrib-applehelp==1.0.8
+sphinxcontrib-applehelp==2.0.0
     # via sphinx
-sphinxcontrib-devhelp==1.0.6
+sphinxcontrib-devhelp==2.0.0
     # via sphinx
-sphinxcontrib-htmlhelp==2.0.5
+sphinxcontrib-htmlhelp==2.1.0
     # via sphinx
 sphinxcontrib-jsmath==1.0.1
     # via sphinx
-sphinxcontrib-qthelp==1.0.7
+sphinxcontrib-qthelp==2.0.0
     # via sphinx
-sphinxcontrib-serializinghtml==1.1.10
+sphinxcontrib-serializinghtml==2.0.0
     # via sphinx
-typing-extensions==4.9.0
+typing-extensions==4.12.2
     # via -r requirements.in
-urllib3==2.2.0
+urllib3==2.3.0
     # via
     #   -r requirements.in
     #   requests
-werkzeug==3.0.1
+werkzeug==3.1.3
     # via
     #   -r requirements.in
     #   flask
-yarl==1.9.4
+yarl==1.18.3
     # via aiohttp

src/replit/web/app.py

@@ -73,6 +73,7 @@ def debug(
     **kwargs: Any
 ) -> None:
     """Run the app in debug mode.
+
     Args:
         watch_dirs (List[str]): Directories whose files will be added to
             watch_files. Defaults to [].