muffin 0.102.3__py3-none-any.whl → 1.0.0__py3-none-any.whl

muffin/app.py

@@ -1,11 +1,12 @@
 """Implement Muffin Application."""
+
 from __future__ import annotations
 
 import logging
 from contextvars import ContextVar
-from inspect import isawaitable, stack
+from inspect import currentframe, isawaitable
 from logging.config import dictConfig
-from typing import TYPE_CHECKING, Any, Final, Mapping, Union
+from typing import TYPE_CHECKING, Any, Final, Mapping
 
 from asgi_tools import App as BaseApp
 from asgi_tools._compat import aio_wait
@@ -22,7 +23,7 @@ if TYPE_CHECKING:
 
     from muffin.plugins import BasePlugin
 
-BACKGROUND_TASK: Final["ContextVar[set[Awaitable] | None]"] = ContextVar(
+BACKGROUND_TASKS: Final[ContextVar[set[Awaitable[Any]] | None]] = ContextVar(
     "background_tasks", default=None
 )
 
@@ -50,7 +51,7 @@ class Application(BaseApp):
         "LOG_CONFIG": None,
     }
 
-    def __init__(self, *cfg_mods: Union[str, ModuleType], **options):
+    def __init__(self, *cfg_mods: str | ModuleType, **options):
         """Initialize the application.
 
         :param *cfg_mods: modules to import application's config
@@ -103,10 +104,10 @@ class Application(BaseApp):
     async def __call__(self, scope: TASGIScope, receive: TASGIReceive, send: TASGISend):
         """Support background tasks."""
         await self.lifespan(scope, receive, send)
-        bgtasks = BACKGROUND_TASK.get()
+        bgtasks = BACKGROUND_TASKS.get()
         if bgtasks is not None:
             await aio_wait(*bgtasks)
-            BACKGROUND_TASK.set(None)
+            BACKGROUND_TASKS.set(None)
 
     def import_submodules(self, *submodules: str, silent: bool = False, **kwargs):
         """Automatically import submodules.
@@ -125,9 +126,12 @@ class Application(BaseApp):
             app.import_submodules(silent=True)
 
         """
-        parent_frame = stack()[1][0]
-        package_name = parent_frame.f_locals["__name__"]
-        return import_submodules(package_name, *submodules, silent=silent, **kwargs)
+        curframe = currentframe()
+        if curframe:
+            parent_frame = curframe.f_back
+            if parent_frame:
+                package_name = parent_frame.f_locals["__name__"]
+                return import_submodules(package_name, *submodules, silent=silent, **kwargs)
 
     def run_after_response(self, *tasks: Awaitable):
         """Await the given awaitable after the response is completed.
@@ -154,11 +158,11 @@ class Application(BaseApp):
             return "OK"
 
         """
-        scheduled = BACKGROUND_TASK.get() or set()
+        scheduled = set(BACKGROUND_TASKS.get() or [])
         for task in tasks:
             if not isawaitable(task):
                 raise TypeError(f"Task must be awaitable: {task!r}")  # noqa: TRY003
 
             scheduled.add(task)
 
-        BACKGROUND_TASK.set(scheduled)
+        BACKGROUND_TASKS.set(scheduled)

muffin/handler.py

@@ -3,9 +3,8 @@
 from __future__ import annotations
 
 import inspect
-from typing import TYPE_CHECKING, Any, Awaitable, Callable, Optional, cast
+from typing import TYPE_CHECKING, Any, Awaitable, Callable, cast
 
-from asgi_tools.utils import is_awaitable
 from asgi_tools.view import HTTP_METHODS, HTTPView
 
 from muffin.errors import AsyncRequiredError
@@ -34,7 +33,7 @@ class HandlerMeta(type):
         cls.methods = {method.upper() for method in cls.methods}
         for m in cls.methods:
             method = getattr(cls, m.lower(), None)
-            if method and not is_awaitable(method):
+            if method and not inspect.iscoroutinefunction(method):
                 raise AsyncRequiredError(method)
 
         return cls
@@ -50,7 +49,7 @@ class Handler(HTTPView, metaclass=HandlerMeta):
 
             async def get(self, request):
                 name = request.patch_params.get('name') or 'all'
-                return "GET: Hello f{name}"
+                return f"GET: Hello {name}"
 
             async def post(self, request):
                 name = request.patch_params.get('name') or 'all'
@@ -79,12 +78,10 @@ class Handler(HTTPView, metaclass=HandlerMeta):
 
     """
 
-    methods: Optional[TMethods] = None
+    methods: TMethods | None = None
 
     @classmethod
-    def __route__(
-        cls, router: Router, *paths: str, methods: Optional[TMethodsArg] = None, **params
-    ):
+    def __route__(cls, router: Router, *paths: str, methods: TMethodsArg | None = None, **params):
         """Check for registered methods."""
         router.bind(cls, *paths, methods=methods or cls.methods, **params)
         for _, method in inspect.getmembers(cls, lambda m: hasattr(m, "__route__")):
@@ -93,14 +90,14 @@ class Handler(HTTPView, metaclass=HandlerMeta):
 
         return cls
 
-    def __call__(self, request: Request, *, method_name: Optional[str] = None, **_) -> Awaitable:
+    def __call__(self, request: Request, *, method_name: str | None = None, **_) -> Awaitable:
         """Dispatch the given request by HTTP method."""
         method = getattr(self, method_name or request.method.lower())
         return method(request)
 
     @staticmethod
     def route(
-        *paths: str, methods: Optional[TMethodsArg] = None
+        *paths: str, methods: TMethodsArg | None = None
     ) -> Callable[[TVCallable], TVCallable]:
         """Mark a method as a route."""
 

muffin/manage.py

@@ -1,4 +1,5 @@
 """CLI Support is here."""
+
 import argparse
 import code
 import inspect
@@ -9,7 +10,7 @@ import sys
 from contextlib import AsyncExitStack, suppress
 from importlib import metadata
 from pathlib import Path
-from typing import TYPE_CHECKING, AsyncContextManager, Callable, Optional, overload
+from typing import TYPE_CHECKING, AsyncContextManager, Callable, overload
 
 from muffin.constants import CONFIG_ENV_VARIABLE
 from muffin.errors import AsyncRequiredError
@@ -132,17 +133,15 @@ class Manager:
         return self(*args, **kwargs)
 
     @overload
-    def __call__(self, fn: "TVCallable") -> "TVCallable":
-        ...
+    def __call__(self, fn: "TVCallable") -> "TVCallable": ...
 
     @overload
-    def __call__(self, *, lifespan: bool = False) -> Callable[["TVCallable"], "TVCallable"]:
-        ...
+    def __call__(self, *, lifespan: bool = False) -> Callable[["TVCallable"], "TVCallable"]: ...
 
     def __call__(self, fn=None, *, lifespan=False):  # noqa: C901
         """Register a command."""
 
-        def wrapper(fn):  # noqa: C901
+        def wrapper(fn):  # noqa: PLR0912, C901
             if not inspect.iscoroutinefunction(fn) and lifespan:
                 raise AsyncRequiredError(fn)
 
@@ -157,57 +156,70 @@ class Manager:
                 return fn
 
             parser = self.subparsers.add_parser(command_name, description=description)
-            args, vargs, _, defs, __, kwdefs, anns = inspect.getfullargspec(fn)
-            defs = defs or []
-            kwargs_ = dict(zip(args[-len(defs) :], defs))
+            sig = inspect.signature(fn)
             docs = dict(PARAM_RE.findall(fn.__doc__ or ""))
 
-            def process_arg(name, *, value=..., **opts):
-                argname = name.lower()
+            for name, param in sig.parameters.items():
                 arghelp = docs.get(name, "")
-                if value is ...:
-                    return parser.add_argument(argname, help=arghelp, **opts)
-
-                argname = argname.replace("_", "-")
-                if isinstance(value, bool):
-                    if value:
-                        return parser.add_argument(
-                            "--no-" + argname,
-                            dest=name,
-                            action="store_false",
-                            help=arghelp or f"Disable { name }",
-                        )
-
-                    return parser.add_argument(
-                        "--" + argname,
-                        dest=name,
-                        action="store_true",
-                        help=arghelp or f"Enable { name }",
-                    )
+                argname = name.replace("_", "-")
 
-                if isinstance(value, list):
-                    return parser.add_argument(
-                        "--" + argname,
-                        action="append",
-                        default=value,
-                        help=arghelp,
-                    )
-
-                return parser.add_argument(
-                    "--" + argname,
-                    type=anns.get(name, type(value)),
-                    default=value,
-                    help=arghelp + " [%s]" % repr(value),
+                type_func = (
+                    param.annotation
+                    if param.annotation is not param.empty
+                    else type(param.default) if param.default is not param.empty else str
                 )
+                if not isinstance(type_func, type):
+                    type_func = str
 
-            if vargs:
-                process_arg("*", nargs="*", metavar=vargs)
+                if param.kind == param.VAR_POSITIONAL:
+                    parser.add_argument(name, nargs="*", metavar=name, help=arghelp)
+                    continue
 
-            for name, value in (kwdefs or {}).items():
-                process_arg(name, value=value)
+                if param.kind == param.VAR_KEYWORD:
+                    # **kwargs not supported in CLI parser
+                    continue
 
-            for name in args:
-                process_arg(name, value=kwargs_.get(name, ...))
+                if param.default is param.empty:
+                    parser.add_argument(
+                        name,
+                        help=arghelp,
+                        type=type_func,
+                    )
+                else:
+                    default = param.default
+                    if isinstance(default, bool):
+                        if default:
+                            parser.add_argument(
+                                f"--no-{argname}",
+                                dest=name,
+                                action="store_false",
+                                help=arghelp or f"Disable {name}",
+                            )
+                        else:
+                            parser.add_argument(
+                                f"--{argname}",
+                                dest=name,
+                                action="store_true",
+                                help=arghelp or f"Enable {name}",
+                            )
+                    elif isinstance(default, list):
+                        parser.add_argument(
+                            f"--{argname}",
+                            action="append",
+                            default=default,
+                            help=arghelp,
+                        )
+                    else:
+                        parser.add_argument(
+                            f"--{argname}",
+                            type=(
+                                param.annotation
+                                if param.annotation is not param.empty
+                                else type(default)
+                            ),
+                            default=default,
+                            help=f"{arghelp} [{default!r}]",
+                        )
 
             self.commands[command_name] = fn
             fn.parser = parser
@@ -218,7 +230,7 @@ class Manager:
 
         return wrapper
 
-    def run(self, *args: str, prog: Optional[str] = None):  # noqa: FA100
+    def run(self, *args: str, prog: str | None = None):
         """Parse the arguments and run a command."""
         if prog:
             self.parser.prog = prog

muffin/plugins.py

@@ -3,14 +3,15 @@
 from __future__ import annotations
 
 from abc import ABC
-from typing import TYPE_CHECKING, Any, Awaitable, Callable, ClassVar, Mapping, Optional
+from asyncio import iscoroutinefunction
+from typing import TYPE_CHECKING, Any, Awaitable, Callable, ClassVar, Mapping
 
 from modconfig import Config
 
 from muffin.errors import MuffinError
 
 if TYPE_CHECKING:
-    from contextlib import _AsyncGeneratorContextManager
+    from contextlib import AbstractAsyncContextManager
 
     from muffin.app import Application
 
@@ -32,18 +33,18 @@ class BasePlugin(ABC):
     defaults: ClassVar[Mapping[str, Any]] = {"disabled": False}
 
     # Optional middleware method
-    middleware: Callable[..., Awaitable]
+    middleware: Callable[..., Awaitable] | None = None
 
     # Optional startup method
-    startup: Callable[..., Awaitable]
+    startup: Callable[..., Awaitable] | None = None
 
     # Optional shutdown method
-    shutdown: Callable[..., Awaitable]
+    shutdown: Callable[..., Awaitable] | None = None
 
     # Optional conftest method
-    conftest: Optional[Callable[[], _AsyncGeneratorContextManager]] = None
+    conftest: Callable[[], AbstractAsyncContextManager] | None = None
 
-    def __init__(self, app: Optional[Application] = None, **options):
+    def __init__(self, app: Application | None = None, **options):
         """Save application and create he plugin's configuration."""
         if getattr(self, "name", None) is None:
             msg = "Plugin.name is required"
@@ -64,11 +65,11 @@ class BasePlugin(ABC):
         return f"<muffin.Plugin: { self.name }>"
 
     async def __aenter__(self):
-        if hasattr(self, "startup"):
+        if iscoroutinefunction(self.startup):
             await self.startup()
 
     async def __aexit__(self, exc_type, exc, tb):
-        if hasattr(self, "shutdown"):
+        if iscoroutinefunction(self.shutdown):
             await self.shutdown()
 
     @property
@@ -79,7 +80,7 @@ class BasePlugin(ABC):
 
         return self.__app__
 
-    def setup(self, app: Application, *, name: Optional[str] = None, **options) -> Any:
+    def setup(self, app: Application, *, name: str | None = None, **options) -> Any:
         """Bind app and update the plugin's configuration."""
         # allow to redefine the name for multi plugins with same type
         self.name = name or self.name
@@ -99,15 +100,22 @@ class BasePlugin(ABC):
         self.__app__ = app
 
         # Register a middleware
-        if hasattr(self, "middleware"):
+        if callable(self.middleware):
             app.middleware(self.middleware)
 
         # Bind startup
-        if hasattr(self, "startup"):
+        if callable(self.startup):
             app.on_startup(self.startup)
 
         # Bind shutdown
-        if hasattr(self, "shutdown"):
+        if callable(self.shutdown):
             app.on_shutdown(self.shutdown)
 
         return True
+
+    async def restart(self):
+        if callable(self.shutdown):
+            await self.shutdown()
+
+        if callable(self.startup):
+            await self.startup()

muffin/utils.py

@@ -56,7 +56,7 @@ logger = getLogger("muffin")
 
 def aio_lib() -> str:
     """Return first available async library."""
-    aiolib = os.environ.get("MUFFIN_AIOLIB", "asyncio")
+    aiolib = os.environ.get("MUFFIN_AIOLIB")
     if aiolib:
         return aiolib
 
@@ -89,11 +89,11 @@ def import_submodules(
     for module_name in to_import:
         try:
             res[module_name] = importlib.import_module(f"{package_name}.{module_name}")
-        except ImportError:  # noqa: PERF203
+        except ImportError as exc:  # noqa: PERF203
             if not silent:
                 raise
 
-            logger.debug("Failed to import module: %s", f"{package_name}.{module_name}")
+            logger.debug("Failed to import %s: %s", f"{package_name}.{module_name}", exc)
 
     return res
 

muffin-1.0.0.dist-info/METADATA

@@ -0,0 +1,187 @@
+Metadata-Version: 2.3
+Name: muffin
+Version: 1.0.0
+Summary: Muffin is a fast, simple and asyncronous web-framework for Python 3 (asyncio, trio, curio)
+License: MIT
+Keywords: asgi,web,web framework,asyncio,trio,curio
+Author: Kirill Klenov
+Author-email: horneds@gmail.com
+Requires-Python: >=3.10,<4.0
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Framework :: AsyncIO
+Classifier: Framework :: Trio
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Internet :: WWW/HTTP
+Provides-Extra: standard
+Requires-Dist: asgi-tools (>=1.3.2,<2.0.0)
+Requires-Dist: gunicorn (>=20.1.0,<21.0.0) ; extra == "standard"
+Requires-Dist: modconfig (>=1,<2)
+Requires-Dist: ujson
+Requires-Dist: uvicorn[standard] (>=0.21.1,<0.22.0) ; extra == "standard"
+Project-URL: Documentation, https://klen.github.io/muffin
+Project-URL: Homepage, https://github.com/klen/muffin
+Project-URL: Repository, https://github.com/klen/muffin
+Project-URL: changelog, https://raw.githubusercontent.com/klen/muffin/master/CHANGELOG.md
+Description-Content-Type: text/x-rst
+
+.. image:: https://raw.github.com/klen/muffin/develop/docs/static/logo-h200.png
+   :height: 100px
+
+**Muffin** – fast, lightweight, and asynchronous ASGI_ web framework for Python 3.10+.
+
+.. image:: https://github.com/klen/muffin/workflows/tests/badge.svg
+    :target: https://github.com/klen/muffin/actions
+    :alt: Tests Status
+
+.. image:: https://github.com/klen/muffin/workflows/docs/badge.svg
+    :target: https://klen.github.io/muffin
+    :alt: Documentation Status
+
+.. image:: https://img.shields.io/pypi/v/muffin
+    :target: https://pypi.org/project/muffin/
+    :alt: PYPI Version
+
+.. image:: https://img.shields.io/pypi/pyversions/muffin
+    :target: https://pypi.org/project/muffin/
+    :alt: Python Versions
+
+----------
+
+Why Muffin?
+-----------
+
+Muffin combines the simplicity of microframeworks with native ASGI_ performance, supporting multiple async libraries (Asyncio_, Trio_, Curio_) out of the box. Its rich plugin ecosystem makes building modern web applications pleasant and efficient.
+
+Key Features
+------------
+
+- ASGI_ compatible
+- Competitive performance ([Benchmarks](http://klen.github.io/py-frameworks-bench/))
+- Supports Asyncio_, Trio_, and Curio_
+- Multiple response types: text, HTML, JSON, streams, files, SSE, WebSockets
+- First-class plugin system for templating, databases, auth, and more
+
+Installation
+------------
+
+Muffin requires **Python 3.10 or newer**. We recommend using the latest stable Python.
+
+Install via pip:
+
+.. code-block:: console
+
+    $ pip install muffin
+
+For the standard installation with `gunicorn`, `uvicorn`, `uvloop`, `httptools`:
+
+.. code-block:: console
+
+    $ pip install muffin[standard]
+
+Dependencies
+~~~~~~~~~~~~
+
+These packages will be installed automatically:
+
+* `ASGI-Tools`_ – ASGI toolkit
+* `Modconfig`_  – hierarchical configuration manager
+
+.. _ASGI-Tools: https://klen.github.io/asgi-tools/
+.. _Modconfig: https://pypi.org/project/modconfig/
+
+Quickstart
+----------
+
+Create a simple "Hello User" app:
+
+.. code-block:: python
+
+    import muffin
+
+    app = muffin.Application()
+
+    @app.route('/', '/hello/{name}')
+    async def hello(request):
+        name = request.path_params.get('name', 'world')
+        return f'Hello, {name.title()}!'
+
+Save this as `example.py` and run:
+
+.. code-block:: console
+
+    $ uvicorn example:app
+
+Visit http://localhost:8000 or http://localhost:8000/hello/username in your browser.
+
+Plugins
+-------
+
+Muffin has a rich ecosystem of plugins:
+
+- [`muffin-jinja2`](https://github.com/klen/muffin-jinja2) – Jinja2 templates (asyncio/trio/curio)
+- [`muffin-session`](https://github.com/klen/muffin-session) – Signed cookie-based HTTP sessions
+- [`muffin-oauth`](https://github.com/klen/muffin-oauth) – OAuth integration
+- [`muffin-sentry`](https://github.com/klen/muffin-sentry) – Sentry error tracking
+- [`muffin-peewee`](https://github.com/klen/muffin-peewee-aio) – Peewee ORM integration
+- [`muffin-babel`](https://github.com/klen/muffin-babel) – i18n support
+- [`muffin-databases`](https://github.com/klen/muffin-databases) – SQL database support
+- [`muffin-mongo`](https://github.com/klen/muffin-mongo) – MongoDB integration
+- [`muffin-rest`](https://github.com/klen/muffin-rest) – REST API utilities
+- [`muffin-redis`](https://github.com/klen/muffin-redis) – Redis integration
+- [`muffin-admin`](https://github.com/klen/muffin-admin) – Auto-generated admin UI
+- [`muffin-prometheus`](https://github.com/klen/muffin-prometheus) – Prometheus metrics exporter
+
+See each repo for usage and installation instructions.
+
+Benchmarks
+----------
+
+Performance comparisons are available at: http://klen.github.io/py-frameworks-bench/
+
+Bug tracker
+-----------
+
+Found a bug or have a feature request? Please open an issue at:
+https://github.com/klen/muffin/issues
+
+Contributing
+------------
+
+Contributions are welcome! Please see [CONTRIBUTING.md](https://github.com/klen/muffin/blob/develop/CONTRIBUTING.md) for guidelines.
+
+License
+-------
+
+Muffin is licensed under the MIT license.
+
+----------
+
+Credits
+-------
+
+**Muffin > 0.40 (completely rewritten on ASGI)**
+
+* `Kirill Klenov <https://github.com/klen>`_
+
+**Muffin < 0.40 (based on AIOHTTP_)**
+
+* `Kirill Klenov <https://github.com/klen>`_
+* `Andrew Grigorev <https://github.com/ei-grad>`_
+* `Diego Garcia <https://github.com/drgarcia1986>`_
+
+.. _AIOHTTP: https://docs.aiohttp.org/en/stable/
+.. _ASGI: https://asgi.readthedocs.io/en/latest/
+.. _Asyncio: https://docs.python.org/3/library/asyncio.html
+.. _Curio: https://curio.readthedocs.io/en/latest/
+.. _Python: http://python.org
+.. _Trio: https://trio.readthedocs.io/en/stable/index.html
+.. _MIT license: http://opensource.org/licenses/MIT
+

muffin-1.0.0.dist-info/RECORD

@@ -0,0 +1,15 @@
+muffin/__init__.py,sha256=8ldUFl0xhKQ7efnpU-TlB0BjXwkJ8lCOip0Uqcn-G4k,1016
+muffin/app.py,sha256=6gPJUhWn9QSdzSwIl_8eP1uwOGaFIkHI-aXQrYwU1gY,5318
+muffin/constants.py,sha256=Ga1UJiEdXUk6dIEH_IEVYkFSZxQFPhxie7fCJwQY8V0,71
+muffin/errors.py,sha256=I-vKbMMBiMU07zPdKvoJKqA7s4xYAUA-4oZXrRMRzcM,701
+muffin/handler.py,sha256=_cvF0TV87YH5_ZDnwgsks-h_e0yI14P27j4HG5tWanc,3673
+muffin/manage.py,sha256=g4DilPjOyXyUcAiNs0m31BSikkvsmGkMZCZcOb0cnuQ,9511
+muffin/plugins.py,sha256=fGIocty5hHGTTY3zQrYBvkXjETlLndqRwAe5jmpyi3I,3417
+muffin/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+muffin/pytest.py,sha256=51pJ-JJ2vwqiPhR9TPqXvT78X35l3v3oEkN5LBnfY8E,2679
+muffin/types.py,sha256=wsUj5oAfqSZMoEf-wyFJLBlWa8Mc-eJGqKLr02HxuXE,153
+muffin/utils.py,sha256=O3JXRkFyDlZ3kJZeaHz2WHMTY6-lvHGDu7qFy0x8Zls,2896
+muffin-1.0.0.dist-info/METADATA,sha256=sAsKPxbQILbEoCXRsm2aN7g1dizfaK89D0FJdRb9y5U,6146
+muffin-1.0.0.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+muffin-1.0.0.dist-info/entry_points.txt,sha256=GvPS3M-tNVPzhUS5jnUpOmWw2NAqedY34VRCYgPYzlM,84
+muffin-1.0.0.dist-info/RECORD,,

{muffin-0.102.3.dist-info → muffin-1.0.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 1.9.0
+Generator: poetry-core 2.1.3
 Root-Is-Purelib: true
 Tag: py3-none-any

muffin-0.102.3.dist-info/METADATA

@@ -1,381 +0,0 @@
-Metadata-Version: 2.1
-Name: muffin
-Version: 0.102.3
-Summary: Muffin is a fast, simple and asyncronous web-framework for Python 3 (asyncio, trio, curio)
-Home-page: https://github.com/klen/muffin
-License: MIT
-Keywords: asgi,web,web framework,asyncio,trio,curio
-Author: Kirill Klenov
-Author-email: horneds@gmail.com
-Requires-Python: >=3.9,<4.0
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Framework :: AsyncIO
-Classifier: Framework :: Trio
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-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: Programming Language :: Python :: Implementation :: PyPy
-Classifier: Topic :: Internet :: WWW/HTTP
-Provides-Extra: standard
-Requires-Dist: asgi-tools (>=1,<2)
-Requires-Dist: gunicorn (>=20.1.0,<21.0.0) ; extra == "standard"
-Requires-Dist: modconfig (>=1,<2)
-Requires-Dist: ujson
-Requires-Dist: uvicorn[standard] (>=0.21.1,<0.22.0) ; extra == "standard"
-Project-URL: Documentation, https://klen.github.io/muffin
-Project-URL: Repository, https://github.com/klen/muffin
-Project-URL: changelog, https://raw.githubusercontent.com/klen/muffin/master/CHANGELOG.md
-Description-Content-Type: text/x-rst
-
-.. image:: https://raw.github.com/klen/muffin/develop/docs/static/logo-h200.png
-   :height: 100px
-
-.. _description:
-
-**Muffin** -- is a fast, lightweight and asyncronous ASGI_ web-framework for Python_ 3.
-
-.. _badges:
-
-.. image:: https://github.com/klen/muffin/workflows/tests/badge.svg
-    :target: https://github.com/klen/muffin/actions
-    :alt: Tests Status
-
-.. image:: https://github.com/klen/muffin/workflows/docs/badge.svg
-    :target: https://klen.github.io/muffin
-    :alt: Documentation Status
-
-.. image:: https://img.shields.io/pypi/v/muffin
-    :target: https://pypi.org/project/muffin/
-    :alt: PYPI Version
-
-.. image:: https://img.shields.io/pypi/pyversions/muffin
-    :target: https://pypi.org/project/muffin/
-    :alt: Python Versions
-
-----------
-
-.. _features:
-
-Features
---------
-
-- ASGI_ compatible;
-- `Competitive Performance <http://klen.github.io/py-frameworks-bench/>`_;
-- All async python libraries are supported (Asyncio_, Trio_, Curio_);
-- Send HTTP (text, html, json, stream, file, http errors) responses
-- Support WebSockets, Server Side Events
-
-.. _documentation:
-
-**Docs are available at https://klen.github.io/muffin/. Pull requests
-with documentation enhancements and/or fixes are awesome and most welcome.**
-
-.. _contents:
-
-.. contents::
-
-.. _requirements:
-
-.. _installation:
-
-Installation
-------------
-
-We recommend using the latest version of Python. The library supports Python
-3.8 and newer (PyPy-3.9+ are supported too).
-
-Muffin should be installed using pip: ::
-
-    pip install muffin
-
-The command will install minimal configuration.
-
-To install Muffin with `gunicorn`, `uvicorn`, `uvloop`, `httptools` use the
-command:
-
-.. code-block:: console
-
-  $ pip install muffin[standard]
-
-Dependencies
-````````````
-
-These distributions will be installed automatically when installing **Muffin**.
-
-* `ASGI-Tools`_ - ASGI_ Toolkit
-* `Modconfig`_  - Simple hierarchic configuration manager
-
-.. _ASGI-Tools: https://klen.github.io/asgi-tools/
-.. _Modconfig: https://pypi.org/project/modconfig/
-
-.. _quickstart:
-
-Quickstart
-----------
-
-Example "Hello User" with the Muffin:
-
-.. code-block:: python
-
-    import muffin
-
-
-    app = muffin.Application()
-
-
-    @app.route('/', '/hello/{name}')
-    async def hello(request):
-        name = request.path_params.get('name', 'world')
-        return f'Hello {name.title()}!'
-
-
-What did that code do?
-
-1. First we imported the ``muffin.Application`` class.  An instance of
-   this class will be our application.
-2. Next we create an instance of this class.
-3. We then use the ``muffin.Application.route`` decorator to tell Muffin
-   what URLs should trigger our handler function.
-4. The function returns the message we want to display in the user's browser.
-
-
-Save the script as `example.py` and run it using Uvicorn (or another ASGI_ server): ::
-
-    $ uvicorn example:app
-
-Open http://localhost:8000, http://localhost:8000/hello/username in your browser. Enjoy!
-
-.. TODO: Finish the general example
-.. For a more complete example, see https://github.com/klen/muffin-example
-
-.. _plugins:
-
-Plugins overview
-----------------
-
-The list of some Muffin plugins (please make PR if you want to provide more):
-
-`Muffin-Jinja2  <https://github.com/klen/muffin-jinja2>`_
-``````````````````````````````````````````````````````````
-
-`Jinja2 <https://jinja.palletsprojects.com/en/2.11.x/>`_ templates (asyncio/trio/curio)
-
-.. image:: https://github.com/klen/muffin-jinja2/workflows/tests/badge.svg
-    :target: https://github.com/klen/muffin-jinja2/actions
-    :alt: Tests Status
-
-.. image:: https://img.shields.io/pypi/v/muffin-jinja2
-    :target: https://pypi.org/project/muffin-jinja2/
-    :alt: PYPI Version
-
-
-
-`Muffin-Session <https://github.com/klen/muffin-session>`_
-```````````````````````````````````````````````````````````
-
-Signed Cookie-Based HTTP sessions (asyncio/trio/curio)
-
-.. image:: https://github.com/klen/muffin-session/workflows/tests/badge.svg
-    :target: https://github.com/klen/muffin-session/actions
-    :alt: Tests Status
-
-.. image:: https://img.shields.io/pypi/v/muffin-session
-    :target: https://pypi.org/project/muffin-session/
-    :alt: PYPI Version
-
-
-`Muffin-OAuth <https://github.com/klen/muffin-oauth>`_
-```````````````````````````````````````````````````````
-
-Work with OAuth (authorization, resources loading) (asyncio/trio/curio)
-
-.. image:: https://github.com/klen/muffin-oauth/workflows/tests/badge.svg
-    :target: https://github.com/klen/muffin-oauth/actions
-    :alt: Tests Status
-
-.. image:: https://img.shields.io/pypi/v/muffin-oauth
-    :target: https://pypi.org/project/muffin-oauth/
-    :alt: PYPI Version
-
-
-`Muffin-Sentry  <https://github.com/klen/muffin-sentry>`_
-`````````````````````````````````````````````````````````
-
-Sentry integration (asyncio/trio/curio)
-
-.. image:: https://github.com/klen/muffin-sentry/workflows/tests/badge.svg
-    :target: https://github.com/klen/muffin-sentry/actions
-    :alt: Tests Status
-
-.. image:: https://img.shields.io/pypi/v/muffin-sentry
-    :target: https://pypi.org/project/muffin-sentry/
-    :alt: PYPI Version
-
-
-`Muffin-Peewee  <https://github.com/klen/muffin-peewee-aio>`_
-`````````````````````````````````````````````````````````````
-
-Peewee support (SQL, ORM) (asyncio/trio/curio)
-
-.. image:: https://github.com/klen/muffin-peewee-aio/workflows/tests/badge.svg
-    :target: https://github.com/klen/muffin-peewee/actions
-    :alt: Tests Status
-
-.. image:: https://img.shields.io/pypi/v/muffin-peewee-aio
-    :target: https://pypi.org/project/muffin-peewee-aio/
-    :alt: PYPI Version
-
-
-`Muffin-Babel   <https://github.com/klen/muffin-babel>`_
-````````````````````````````````````````````````````````
-
-Localization support (asyncio/trio/curio)
-
-.. image:: https://github.com/klen/muffin-babel/workflows/tests/badge.svg
-    :target: https://github.com/klen/muffin-babel/actions
-    :alt: Tests Status
-
-.. image:: https://img.shields.io/pypi/v/muffin-babel
-    :target: https://pypi.org/project/muffin-babel/
-    :alt: PYPI Version
-
-
-`Muffin-Databases   <https://github.com/klen/muffin-databases>`_
-`````````````````````````````````````````````````````````````````
-
-Work with SQL databases (asyncio only)
-
-.. image:: https://github.com/klen/muffin-databases/workflows/tests/badge.svg
-    :target: https://github.com/klen/muffin-databases/actions
-    :alt: Tests Status
-
-.. image:: https://img.shields.io/pypi/v/muffin-databases
-    :target: https://pypi.org/project/muffin-databases/
-    :alt: PYPI Version
-
-
-`Muffin-Mongo   <https://github.com/klen/muffin-mongo>`_
-`````````````````````````````````````````````````````````
-
-Work with Mongo DB (asyncio only)
-
-.. image:: https://github.com/klen/muffin-mongo/workflows/tests/badge.svg
-    :target: https://github.com/klen/muffin-mongo/actions
-    :alt: Tests Status
-
-.. image:: https://img.shields.io/pypi/v/muffin-mongo
-    :target: https://pypi.org/project/muffin-mongo/
-    :alt: PYPI Version
-
-`Muffin-REST    <https://github.com/klen/muffin-rest>`_
-````````````````````````````````````````````````````````
-
-The package provides enhanced support for writing REST APIs (asyncio/trio/curio)
-
-.. image:: https://github.com/klen/muffin-rest/workflows/tests/badge.svg
-    :target: https://github.com/klen/muffin-rest/actions
-    :alt: Tests Status
-
-.. image:: https://img.shields.io/pypi/v/muffin-rest
-    :target: https://pypi.org/project/muffin-rest/
-    :alt: PYPI Version
-
-`Muffin-Redis   <https://github.com/klen/muffin-redis>`_
-`````````````````````````````````````````````````````````
-
-Redis support
-
-.. image:: https://github.com/klen/muffin-redis/workflows/tests/badge.svg
-    :target: https://github.com/klen/muffin-redis/actions
-    :alt: Tests Status
-
-.. image:: https://img.shields.io/pypi/v/muffin-redis
-    :target: https://pypi.org/project/muffin-redis/
-    :alt: PYPI Version
-
-`Muffin-Admin   <https://github.com/klen/muffin-admin>`_
-`````````````````````````````````````````````````````````
-
-Automatically build Admin UI
-
-.. image:: https://github.com/klen/muffin-admin/workflows/tests/badge.svg
-    :target: https://github.com/klen/muffin-admin/actions
-    :alt: Tests Status
-
-.. image:: https://img.shields.io/pypi/v/muffin-admin
-    :target: https://pypi.org/project/muffin-admin/
-    :alt: PYPI Version
-
-`Muffin-Prometheus   <https://github.com/klen/muffin-prometheus>`_
-```````````````````````````````````````````````````````````````````
-
-Prometheus metrics exporter
-
-.. image:: https://github.com/klen/muffin-prometheus/workflows/tests/badge.svg
-    :target: https://github.com/klen/muffin-prometheus/actions
-    :alt: Tests Status
-
-.. image:: https://img.shields.io/pypi/v/muffin-prometheus
-    :target: https://pypi.org/project/muffin-prometheus/
-    :alt: PYPI Version
-
-.. _benchmarks:
-
-Benchmarks
------------
-
-You could find some tests here: http://klen.github.io/py-frameworks-bench/
-
-.. _bugtracker:
-
-Bug tracker
------------
-
-If you have any suggestions, bug reports or
-annoyances please report them to the issue tracker
-at https://github.com/klen/muffin/issues
-
-.. _contributing:
-
-Contributing
-------------
-
-Development of The Muffin happens at: https://github.com/klen/muffin
-
-
-Contributors
--------------
-
-Muffin > 0.40 (completelly rewriten from scratch)
-
-* `Kirill Klenov <https://github.com/klen>`_
-
-Muffin < 0.40 (based on AIOHTTP_)
-
-* `Kirill Klenov <https://github.com/klen>`_
-* `Andrew Grigorev <https://github.com/ei-grad>`_
-* `Diego Garcia <https://github.com/drgarcia1986>`_
-
-.. _license:
-
-License
--------
-
-Licensed under a `MIT license`_.
-
-.. _links:
-
-.. _AIOHTTP: https://docs.aiohttp.org/en/stable/
-.. _ASGI: https://asgi.readthedocs.io/en/latest/
-.. _Asyncio: https://docs.python.org/3/library/asyncio.html
-.. _Curio: https://curio.readthedocs.io/en/latest/
-.. _MIT license: http://opensource.org/licenses/MIT
-.. _Python: http://python.org
-.. _Trio: https://trio.readthedocs.io/en/stable/index.html
-.. _klen: https://github.com/klen
-

muffin-0.102.3.dist-info/RECORD

@@ -1,15 +0,0 @@
-muffin/__init__.py,sha256=8ldUFl0xhKQ7efnpU-TlB0BjXwkJ8lCOip0Uqcn-G4k,1016
-muffin/app.py,sha256=Xh3jDRKFG55hRReQJpdVeOF42ktVciJYP4O-bpOgVvo,5207
-muffin/constants.py,sha256=Ga1UJiEdXUk6dIEH_IEVYkFSZxQFPhxie7fCJwQY8V0,71
-muffin/errors.py,sha256=I-vKbMMBiMU07zPdKvoJKqA7s4xYAUA-4oZXrRMRzcM,701
-muffin/handler.py,sha256=GtIyn-SfWDXsMgJ3GyiJJiWUIezesrFoNVzSHyFI_yA,3736
-muffin/manage.py,sha256=Lx3WTWVXiSuGnTR8CfNZKyGXxJBM-rHnagVEPxUSxMs,8829
-muffin/plugins.py,sha256=-EyGr66DD_3gOzrQo3QSb_22dYgYk04kKsfTsfirld4,3177
-muffin/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-muffin/pytest.py,sha256=51pJ-JJ2vwqiPhR9TPqXvT78X35l3v3oEkN5LBnfY8E,2679
-muffin/types.py,sha256=wsUj5oAfqSZMoEf-wyFJLBlWa8Mc-eJGqKLr02HxuXE,153
-muffin/utils.py,sha256=zK_pGeYzWoTsv-4-Rlu6MjOhTEmS46NpprH4MsNRcVw,2899
-muffin-0.102.3.dist-info/METADATA,sha256=GchyqH2hPVxnBrLBWCFSnpu0puJ5-RyAuErDf90o3Uk,11331
-muffin-0.102.3.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-muffin-0.102.3.dist-info/entry_points.txt,sha256=GvPS3M-tNVPzhUS5jnUpOmWw2NAqedY34VRCYgPYzlM,84
-muffin-0.102.3.dist-info/RECORD,,