diff --git a/docs/_static/tractor_logo_side.svg b/docs/_static/tractor_logo_side.svg new file mode 100644 index 0000000..24da8bb --- /dev/null +++ b/docs/_static/tractor_logo_side.svg @@ -0,0 +1,458 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/conf.py b/docs/conf.py index 4610618..ede4ad4 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -54,7 +54,7 @@ exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store'] # 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_typlog_theme' pygments_style = 'sphinx' @@ -62,18 +62,18 @@ pygments_style = 'sphinx' # further. For a list of options available for each theme, see the # documentation. html_theme_options = { - 'description': 'A trionic "actor model"', + 'logo': 'tractor_logo_side.svg', + 'description': 'Structured concurrent "actors"', 'github_user': 'goodboy', 'github_repo': 'tractor', - 'github_button': 'true', - 'github_banner': 'true', - 'page_width': '1080px', - 'fixed_sidebar': 'false', - # 'sidebar_width': '200px', - 'travis_button': 'true', } html_sidebars = { - "**": ["about.html", "relations.html", "searchbox.html"] + "**": [ + 'logo.html', + 'github.html', + 'relations.html', + 'searchbox.html' + ] } # Add any paths that contain custom static files (such as style sheets) here, diff --git a/docs/index.rst b/docs/index.rst index f2e5ad3..f254eb0 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -460,24 +460,18 @@ via a ``start_method`` kwarg to ``tractor.run()``. Currently the options available are: -- ``trio_run_in_process``: a ``trio``-native spawner from the `Ethereum community`_ +- ``trio``: a ``trio``-native spawner which is an async wrapper around ``subprocess`` - ``spawn``: one of the stdlib's ``multiprocessing`` `start methods`_ - ``forkserver``: a faster ``multiprocessing`` variant that is Unix only .. _start methods: https://docs.python.org/3.8/library/multiprocessing.html#contexts-and-start-methods -.. _Ethereum community : https://github.com/ethereum/trio-run-in-process -``trio-run-in-process`` -+++++++++++++++++++++++ -`trio-run-in-process`_ is a young "pure ``trio``" process spawner -which utilizes the native `trio subprocess APIs`_. It has shown great -reliability under testing for predictable teardown when launching -recursive pools of actors (multiple nurseries deep) and as such has been -chosen as the default backend on \*nix systems. +``trio`` +++++++++ +The ``trio`` backend offers a lightweight async wrapper around ``subprocess`` from the standard library and takes advantage of the ``trio.`` `open_process`_ API. -.. _trio-run-in-process: https://github.com/ethereum/trio-run-in-process -.. _trio subprocess APIs : https://trio.readthedocs.io/en/stable/reference-io.html#spawning-subprocesses +.. _open_process: https://trio.readthedocs.io/en/stable/reference-io.html#spawning-subprocesses ``multiprocessing`` diff --git a/requirements-docs.txt b/requirements-docs.txt new file mode 100644 index 0000000..5c53ba7 --- /dev/null +++ b/requirements-docs.txt @@ -0,0 +1,2 @@ +sphinx +sphinx_typlog_theme \ No newline at end of file diff --git a/setup.py b/setup.py index cca38cf..24d4479 100755 --- a/setup.py +++ b/setup.py @@ -39,7 +39,7 @@ setup( ], install_requires=[ 'msgpack', 'trio>0.8', 'async_generator', 'colorlog', 'wrapt', - 'trio_typing', + 'trio_typing' ], tests_require=['pytest'], python_requires=">=3.7",