anycorn 0.16.0__tar.gz

anycorn-0.16.0/LICENSE

@@ -0,0 +1,22 @@
+Copyright P G Jones 2018.
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

anycorn-0.16.0/PKG-INFO

@@ -0,0 +1,159 @@
+Metadata-Version: 2.1
+Name: anycorn
+Version: 0.16.0
+Summary: A ASGI Server based on Hyper libraries and inspired by Gunicorn
+Home-page: https://github.com/davidbrochart/anycorn/
+License: MIT
+Author: pgjones
+Author-email: philip.graham.jones@googlemail.com
+Requires-Python: >=3.8
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Provides-Extra: docs
+Provides-Extra: h3
+Provides-Extra: trio
+Provides-Extra: uvloop
+Requires-Dist: aioquic (>=0.9.0,<1.0) ; extra == "h3"
+Requires-Dist: anyio (>=4.0,<5.0)
+Requires-Dist: exceptiongroup (>=1.1.0) ; extra == "trio"
+Requires-Dist: h11
+Requires-Dist: h2 (>=3.1.0)
+Requires-Dist: priority
+Requires-Dist: pydata_sphinx_theme ; extra == "docs"
+Requires-Dist: sphinxcontrib_mermaid ; extra == "docs"
+Requires-Dist: taskgroup ; python_version < "3.11"
+Requires-Dist: tomli ; python_version < "3.11"
+Requires-Dist: uvloop ; (platform_system != "Windows") and (extra == "uvloop")
+Requires-Dist: wsproto (>=0.14.0)
+Project-URL: Documentation, https://hypercorn.readthedocs.io
+Project-URL: Repository, https://github.com/davidbrochart/anycorn/
+Description-Content-Type: text/x-rst
+
+Anycorn
+=======
+
+.. image:: https://github.com/davidbrochart/anycorn/raw/main/artwork/logo.png
+   :alt: Hypercorn logo
+
+|Build Status| |docs| |pypi| |http| |python| |license|
+
+Anycorn is an `ASGI
+<https://github.com/django/asgiref/blob/main/specs/asgi.rst>`_ and
+WSGI web server based on the sans-io hyper, `h11
+<https://github.com/python-hyper/h11>`_, `h2
+<https://github.com/python-hyper/hyper-h2>`_, and `wsproto
+<https://github.com/python-hyper/wsproto>`_ libraries and inspired by
+Gunicorn. Anycorn supports HTTP/1, HTTP/2, WebSockets (over HTTP/1
+and HTTP/2), ASGI, and WSGI specifications. Anycorn utilises
+anyio worker types.
+
+Anycorn can optionally serve the current draft of the HTTP/3
+specification using the `aioquic
+<https://github.com/aiortc/aioquic/>`_ library. To enable this install
+the ``h3`` optional extra, ``pip install anycorn[h3]`` and then
+choose a quic binding e.g. ``anycorn --quic-bind localhost:4433
+...``.
+
+Anycorn is a fork of `Hypercorn
+<https://github.com/pgjones/hypercorn>`_ that replaces asyncio where
+asyncio and Trio implementations are replaced with AnyIO.
+Anycorn forked from version 0.16.0 of Hypercorn.
+
+Quickstart
+----------
+
+Anycorn can be installed via `pip
+<https://docs.python.org/3/installing/index.html>`_,
+
+.. code-block:: console
+
+    $ pip install anycorn
+
+and requires Python 3.8 or higher.
+
+With anycorn installed ASGI frameworks (or apps) can be served via
+Anycorn via the command line,
+
+.. code-block:: console
+
+    $ anycorn module:app
+
+Alternatively Anycorn can be used programatically,
+
+.. code-block:: python
+
+    import anyio
+    from anycorn.config import Config
+    from anycorn import serve
+
+    from module import app
+
+    anyio.run(serve, app, Config())
+
+learn more in the `API usage
+<https://hypercorn.readthedocs.io/en/latest/how_to_guides/api_usage.html>`_
+docs.
+
+Contributing
+------------
+
+Anycorn is developed on `Github
+<https://github.com/davidbrochart/anycorn>`_. If you come across an issue,
+or have a feature request please open an `issue
+<https://github.com/davidbrochart/anycorn/issues>`_.  If you want to
+contribute a fix or the feature-implementation please do (typo fixes
+welcome), by proposing a `pull request
+<https://github.com/davidbrochart/anycorn/merge_requests>`_.
+
+Testing
+~~~~~~~
+
+The best way to test Anycorn is with `Tox
+<https://tox.readthedocs.io>`_,
+
+.. code-block:: console
+
+    $ pipenv install tox
+    $ tox
+
+this will check the code style and run the tests.
+
+Help
+----
+
+The Anycorn `documentation <https://hypercorn.readthedocs.io>`_ is
+the best place to start, after that try searching stack overflow, if
+you still can't find an answer please `open an issue
+<https://github.com/davidbrochart/anycorn/issues>`_.
+
+
+.. |Build Status| image:: https://github.com/davidbrochart/anycorn/actions/workflows/ci.yml/badge.svg
+   :target: https://github.com/davidbrochart/anycorn/commits/main
+
+.. |docs| image:: https://img.shields.io/badge/docs-passing-brightgreen.svg
+   :target: https://hypercorn.readthedocs.io
+
+.. |pypi| image:: https://img.shields.io/pypi/v/hypercorn.svg
+   :target: https://pypi.python.org/pypi/anycorn/
+
+.. |http| image:: https://img.shields.io/badge/http-1.0,1.1,2-orange.svg
+   :target: https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol
+
+.. |python| image:: https://img.shields.io/pypi/pyversions/hypercorn.svg
+   :target: https://pypi.python.org/pypi/anycorn/
+
+.. |license| image:: https://img.shields.io/badge/license-MIT-blue.svg
+   :target: https://github.com/davidbrochart/anycorn/blob/main/LICENSE
+

anycorn-0.16.0/README.rst

@@ -0,0 +1,115 @@
+Anycorn
+=======
+
+.. image:: https://github.com/davidbrochart/anycorn/raw/main/artwork/logo.png
+   :alt: Hypercorn logo
+
+|Build Status| |docs| |pypi| |http| |python| |license|
+
+Anycorn is an `ASGI
+<https://github.com/django/asgiref/blob/main/specs/asgi.rst>`_ and
+WSGI web server based on the sans-io hyper, `h11
+<https://github.com/python-hyper/h11>`_, `h2
+<https://github.com/python-hyper/hyper-h2>`_, and `wsproto
+<https://github.com/python-hyper/wsproto>`_ libraries and inspired by
+Gunicorn. Anycorn supports HTTP/1, HTTP/2, WebSockets (over HTTP/1
+and HTTP/2), ASGI, and WSGI specifications. Anycorn utilises
+anyio worker types.
+
+Anycorn can optionally serve the current draft of the HTTP/3
+specification using the `aioquic
+<https://github.com/aiortc/aioquic/>`_ library. To enable this install
+the ``h3`` optional extra, ``pip install anycorn[h3]`` and then
+choose a quic binding e.g. ``anycorn --quic-bind localhost:4433
+...``.
+
+Anycorn is a fork of `Hypercorn
+<https://github.com/pgjones/hypercorn>`_ that replaces asyncio where
+asyncio and Trio implementations are replaced with AnyIO.
+Anycorn forked from version 0.16.0 of Hypercorn.
+
+Quickstart
+----------
+
+Anycorn can be installed via `pip
+<https://docs.python.org/3/installing/index.html>`_,
+
+.. code-block:: console
+
+    $ pip install anycorn
+
+and requires Python 3.8 or higher.
+
+With anycorn installed ASGI frameworks (or apps) can be served via
+Anycorn via the command line,
+
+.. code-block:: console
+
+    $ anycorn module:app
+
+Alternatively Anycorn can be used programatically,
+
+.. code-block:: python
+
+    import anyio
+    from anycorn.config import Config
+    from anycorn import serve
+
+    from module import app
+
+    anyio.run(serve, app, Config())
+
+learn more in the `API usage
+<https://hypercorn.readthedocs.io/en/latest/how_to_guides/api_usage.html>`_
+docs.
+
+Contributing
+------------
+
+Anycorn is developed on `Github
+<https://github.com/davidbrochart/anycorn>`_. If you come across an issue,
+or have a feature request please open an `issue
+<https://github.com/davidbrochart/anycorn/issues>`_.  If you want to
+contribute a fix or the feature-implementation please do (typo fixes
+welcome), by proposing a `pull request
+<https://github.com/davidbrochart/anycorn/merge_requests>`_.
+
+Testing
+~~~~~~~
+
+The best way to test Anycorn is with `Tox
+<https://tox.readthedocs.io>`_,
+
+.. code-block:: console
+
+    $ pipenv install tox
+    $ tox
+
+this will check the code style and run the tests.
+
+Help
+----
+
+The Anycorn `documentation <https://hypercorn.readthedocs.io>`_ is
+the best place to start, after that try searching stack overflow, if
+you still can't find an answer please `open an issue
+<https://github.com/davidbrochart/anycorn/issues>`_.
+
+
+.. |Build Status| image:: https://github.com/davidbrochart/anycorn/actions/workflows/ci.yml/badge.svg
+   :target: https://github.com/davidbrochart/anycorn/commits/main
+
+.. |docs| image:: https://img.shields.io/badge/docs-passing-brightgreen.svg
+   :target: https://hypercorn.readthedocs.io
+
+.. |pypi| image:: https://img.shields.io/pypi/v/hypercorn.svg
+   :target: https://pypi.python.org/pypi/anycorn/
+
+.. |http| image:: https://img.shields.io/badge/http-1.0,1.1,2-orange.svg
+   :target: https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol
+
+.. |python| image:: https://img.shields.io/pypi/pyversions/hypercorn.svg
+   :target: https://pypi.python.org/pypi/anycorn/
+
+.. |license| image:: https://img.shields.io/badge/license-MIT-blue.svg
+   :target: https://github.com/davidbrochart/anycorn/blob/main/LICENSE

anycorn-0.16.0/pyproject.toml

@@ -0,0 +1,103 @@
+[tool.poetry]
+name = "anycorn"
+version = "0.16.0"
+description = "A ASGI Server based on Hyper libraries and inspired by Gunicorn"
+authors = ["pgjones <philip.graham.jones@googlemail.com>", "David Brochart <david.brochart@gmail.com>"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Web Environment",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Internet :: WWW/HTTP :: Dynamic Content",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+include = ["src/anycorn/py.typed"]
+license = "MIT"
+readme = "README.rst"
+repository = "https://github.com/davidbrochart/anycorn/"
+documentation = "https://hypercorn.readthedocs.io"
+
+[tool.poetry.dependencies]
+python = ">=3.8"
+aioquic = { version = ">= 0.9.0, < 1.0", optional = true }
+exceptiongroup = ">= 1.1.0"
+h11 = "*"
+h2 = ">=3.1.0"
+anyio = ">=4.0, <5.0"
+priority = "*"
+pydata_sphinx_theme = { version = "*", optional = true }
+sphinxcontrib_mermaid = { version = "*", optional = true }
+taskgroup = { version = "*", python = "<3.11", allow-prereleases = true }
+tomli = { version = "*", python = "<3.11" }
+uvloop = { version = "*", markers = "platform_system != 'Windows'", optional = true }
+wsproto = ">=0.14.0"
+
+[tool.poetry.dev-dependencies]
+hypothesis = "*"
+mock = "*"
+pytest = "*"
+pytest-asyncio = "*"
+pytest-trio = "*"
+trio = "*"
+
+[tool.poetry.scripts]
+anycorn = "anycorn.__main__:main"
+
+[tool.poetry.extras]
+docs = ["pydata_sphinx_theme", "sphinxcontrib_mermaid"]
+h3 = ["aioquic"]
+trio = ["exceptiongroup", "trio"]
+uvloop = ["uvloop"]
+
+[tool.black]
+line-length = 100
+target-version = ["py38"]
+
+[tool.isort]
+combine_as_imports = true
+force_grid_wrap = 0
+include_trailing_comma = true
+known_first_party = "anycorn, tests"
+line_length = 100
+multi_line_output = 3
+no_lines_before = "LOCALFOLDER"
+order_by_type = false
+reverse_relative = true
+
+[tool.mypy]
+allow_redefinition = true
+disallow_any_generics = false
+disallow_subclassing_any = true
+disallow_untyped_calls = false
+disallow_untyped_defs = true
+implicit_reexport = true
+no_implicit_optional = true
+show_error_codes = true
+strict = true
+strict_equality = true
+strict_optional = false
+warn_redundant_casts = true
+warn_return_any = false
+warn_unused_configs = true
+warn_unused_ignores = true
+
+[[tool.mypy.overrides]]
+module =["aioquic.*", "cryptography.*", "h11.*", "h2.*", "priority.*", "pytest_asyncio.*", "trio.*", "uvloop.*"]
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+addopts = "--no-cov-on-fail --showlocals --strict-markers"
+asyncio_mode = "strict"
+testpaths = ["tests"]
+
+[build-system]
+requires = ["poetry-core>=1.0.0"]
+build-backend = "poetry.core.masonry.api"

anycorn-0.16.0/src/anycorn/__init__.py

@@ -0,0 +1,54 @@
+from __future__ import annotations
+
+import warnings
+from typing import Awaitable, Callable, Literal, Optional
+
+import anyio
+
+from .config import Config
+from .run import worker_serve
+from .typing import Framework
+from .utils import wrap_app
+
+__all__ = ("Config", "serve")
+
+
+async def serve(
+    app: Framework,
+    config: Config,
+    *,
+    shutdown_trigger: Optional[Callable[..., Awaitable[None]]] = None,
+    task_status: anyio.abc.TaskStatus[None] = anyio.TASK_STATUS_IGNORED,
+    mode: Optional[Literal["asgi", "wsgi"]] = None,
+) -> None:
+    """Serve an ASGI framework app given the config.
+
+    This allows for a programmatic way to serve an ASGI framework, it
+    can be used via,
+
+    .. code-block:: python
+
+        anyio.run(serve, app, config)
+
+    It is assumed that the event-loop is configured before calling
+    this function, therefore configuration values that relate to loop
+    setup or process setup are ignored.
+
+    Arguments:
+        app: The ASGI application to serve.
+        config: A Hypercorn configuration object.
+        shutdown_trigger: This should return to trigger a graceful
+            shutdown.
+        mode: Specify if the app is WSGI or ASGI.
+    """
+    if config.debug:
+        warnings.warn("The config `debug` has no affect when using serve", Warning)
+    if config.workers != 1:
+        warnings.warn("The config `workers` has no affect when using serve", Warning)
+
+    await worker_serve(
+        wrap_app(app, config.wsgi_max_body_size, mode),
+        config,
+        shutdown_trigger=shutdown_trigger,
+        task_status=task_status,
+    )