diff --git a/testing/web-platform/tests/docs/conf.py b/testing/web-platform/tests/docs/conf.py index 44d3c2f76bbc..96e8290455e2 100644 --- a/testing/web-platform/tests/docs/conf.py +++ b/testing/web-platform/tests/docs/conf.py @@ -78,6 +78,7 @@ ('py:exc', 'BadOperationException'), ('py:exc', 'Exception'), ('py:exc', 'ValueError'), + ('py:class', 'http.client.HTTPMessage') ] # The language for content autogenerated by Sphinx. Refer to documentation @@ -211,5 +212,5 @@ def setup(app): # A list of files that should not be packed into the epub file. epub_exclude_files = ['search.html'] -intersphinx_mapping = {'python': ('https://docs.python.org/2/', None), +intersphinx_mapping = {'python': ('https://docs.python.org/3/', None), 'mozilla': ('https://firefox-source-docs.mozilla.org/', None)} diff --git a/testing/web-platform/tests/docs/requirements.txt b/testing/web-platform/tests/docs/requirements.txt index a9ddeecfe573..03ce983831da 100644 --- a/testing/web-platform/tests/docs/requirements.txt +++ b/testing/web-platform/tests/docs/requirements.txt @@ -1,4 +1,4 @@ recommonmark==0.6.0 -# pin this to the last Py2 release -Sphinx==1.8.5 # pyup: <2.0 +# Pin this to the same major version as https://docs.python.org/3/ +Sphinx==2.4.4 # pyup: <3.0 sphinx-argparse==0.2.5 diff --git a/testing/web-platform/tests/docs/reviewing-tests/checklist.md b/testing/web-platform/tests/docs/reviewing-tests/checklist.md index 0e50843f289b..be0f4d134e4d 100644 --- a/testing/web-platform/tests/docs/reviewing-tests/checklist.md +++ b/testing/web-platform/tests/docs/reviewing-tests/checklist.md @@ -5,7 +5,7 @@ tests; in case of any contradiction with requirements stated elsewhere in the documentation it should be ignored (please [file a bug](https://github.com/web-platform-tests/wpt/issues/new)!). -As noted on the [reviewing tests](index) page, nits need not block PRs +As noted on the [reviewing tests](./index.md) page, nits need not block PRs from landing. diff --git a/testing/web-platform/tests/docs/wpt_lint_rules.py b/testing/web-platform/tests/docs/wpt_lint_rules.py index a5eed507b5e7..b9997372520f 100644 --- a/testing/web-platform/tests/docs/wpt_lint_rules.py +++ b/testing/web-platform/tests/docs/wpt_lint_rules.py @@ -3,6 +3,7 @@ from recommonmark.parser import CommonMarkParser import importlib import textwrap +from six import iteritems class WPTLintRules(Directive): """A docutils directive to generate documentation for the @@ -31,7 +32,7 @@ def _get_rules(self): """wpt-lint-rules: unable to resolve the module at "{}".""".format(self.module_specifier) ) - for binding_name, value in module.__dict__.iteritems(): + for binding_name, value in iteritems(module.__dict__): if hasattr(value, "__abstractmethods__") and len(value.__abstractmethods__): continue diff --git a/testing/web-platform/tests/tools/docker/documentation/Dockerfile b/testing/web-platform/tests/tools/docker/documentation/Dockerfile index e01f98e4d4df..01ea0bd95bf6 100644 --- a/testing/web-platform/tests/tools/docker/documentation/Dockerfile +++ b/testing/web-platform/tests/tools/docker/documentation/Dockerfile @@ -1,3 +1,3 @@ -FROM python:2-stretch +FROM python:3.8-buster -RUN apt-get update && apt-get install --yes git +RUN apt-get update && apt-get install --yes git virtualenv diff --git a/testing/web-platform/tests/tools/third_party/pywebsocket3/mod_pywebsocket/stream.py b/testing/web-platform/tests/tools/third_party/pywebsocket3/mod_pywebsocket/stream.py index fc399f2a85b9..82d1ea619c07 100644 --- a/testing/web-platform/tests/tools/third_party/pywebsocket3/mod_pywebsocket/stream.py +++ b/testing/web-platform/tests/tools/third_party/pywebsocket3/mod_pywebsocket/stream.py @@ -875,7 +875,7 @@ def close_connection(self, wait_response: True when caller want to wait the response. Raises: BadOperationException: when reason is specified with code None - or reason is not an instance of both str and unicode. + or reason is not an instance of both str and unicode. """ if self._request.server_terminated: