Switch from setup.py to Poetry

Author: mehaase

.gitignore

@@ -1,11 +1,12 @@
 .coverage
-*.egg-info
 .ipynb_checkpoints
 .mypy_cache
-.vscode
 __pycache__
+.vscode
+*.egg-info
+build
+chrome-mac
 dist
 test.png
 venv
-chrome-mac
-build
+TODO.md

.readthedocs.yml

@@ -0,0 +1,10 @@
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+version: 2
+
+sphinx:
+  configuration: docs/conf.py
+
+python:
+  version: 3.7
+  install:
+    - requirements: docs/requirements.txt

.travis.yml

@@ -8,9 +8,11 @@ matrix:
   include:
     - python: 3.7
 
+before_install:
+  - pip install poetry
+
 install:
-  - pip install -e .
-  - pip install -r requirements.txt
+  - poetry install
 
 script:
-  - make
+  - poetry run make

Makefile

@@ -1,3 +1,6 @@
+# The targets in this makefile should be executed inside Poetry, i.e. `poetry run make
+# docs`.
+
 .PHONY: docs
 
 default: mypy-generate test-generate generate test-import mypy-cdp test-cdp
@@ -14,11 +17,6 @@ mypy-cdp:
 mypy-generate:
 	mypy generator/
 
-publish: test-import mypy-cdp test-cdp
-	rm -fr dist trio_chrome_devtools_protocol.egg-info
-	python setup.py sdist
-	twine upload dist/*
-
 test-cdp:
 	pytest tests/ --cov=trio_cdp --cov-report=term-missing
 

docs/conf.py

@@ -28,8 +28,12 @@
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
+    'sphinx.ext.autodoc',
+    'sphinx_autodoc_typehints',
+    'sphinx_rtd_theme',
 ]
 
+
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
 
@@ -44,9 +48,9 @@
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-html_theme = 'alabaster'
+html_theme = 'sphinx_rtd_theme'
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-# html_static_path = ['_static']
+html_static_path = ['_static']

docs/requirements.txt

@@ -0,0 +1,6 @@
+# RTD does not support Poetry natively, so this is a temporary workaround. See:
+# https://github.com/readthedocs/readthedocs.org/issues/4912
+sphinx
+sphinx-autodoc-typehints
+sphinx-rtd-theme
+.