no venv

8 files changed, 0 insertions, 475 deletions

diff --git a/venv/lib/python3.11/site-packages/litestar/cli/commands/__init__.py b/venv/lib/python3.11/site-packages/litestar/cli/commands/__init__.py
deleted file mode 100644
index e69de29..0000000
--- a/venv/lib/python3.11/site-packages/litestar/cli/commands/__init__.py
+++ /dev/null
diff --git a/venv/lib/python3.11/site-packages/litestar/cli/commands/__pycache__/__init__.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/cli/commands/__pycache__/__init__.cpython-311.pyc
deleted file mode 100644
index af651ad..0000000
--- a/venv/lib/python3.11/site-packages/litestar/cli/commands/__pycache__/__init__.cpython-311.pyc
+++ /dev/null
diff --git a/venv/lib/python3.11/site-packages/litestar/cli/commands/__pycache__/core.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/cli/commands/__pycache__/core.cpython-311.pyc
deleted file mode 100644
index 6f44d52..0000000
--- a/venv/lib/python3.11/site-packages/litestar/cli/commands/__pycache__/core.cpython-311.pyc
+++ /dev/null
diff --git a/venv/lib/python3.11/site-packages/litestar/cli/commands/__pycache__/schema.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/cli/commands/__pycache__/schema.cpython-311.pyc
deleted file mode 100644
index d6d7532..0000000
--- a/venv/lib/python3.11/site-packages/litestar/cli/commands/__pycache__/schema.cpython-311.pyc
+++ /dev/null
diff --git a/venv/lib/python3.11/site-packages/litestar/cli/commands/__pycache__/sessions.cpython-311.pyc b/venv/lib/python3.11/site-packages/litestar/cli/commands/__pycache__/sessions.cpython-311.pyc
deleted file mode 100644
index bebfa1a..0000000
--- a/venv/lib/python3.11/site-packages/litestar/cli/commands/__pycache__/sessions.cpython-311.pyc
+++ /dev/null
diff --git a/venv/lib/python3.11/site-packages/litestar/cli/commands/core.py b/venv/lib/python3.11/site-packages/litestar/cli/commands/core.py
deleted file mode 100644
index 5b55253..0000000
--- a/venv/lib/python3.11/site-packages/litestar/cli/commands/core.py
+++ /dev/null
@@ -1,335 +0,0 @@
-from __future__ import annotations
-
-import inspect
-import multiprocessing
-import os
-import subprocess
-import sys
-from contextlib import AbstractContextManager, ExitStack, contextmanager
-from typing import TYPE_CHECKING, Any, Iterator
-
-import click
-from click import Context, command, option
-from rich.tree import Tree
-
-from litestar.app import DEFAULT_OPENAPI_CONFIG
-from litestar.cli._utils import (
-    UVICORN_INSTALLED,
-    LitestarEnv,
-    console,
-    create_ssl_files,
-    remove_default_schema_routes,
-    remove_routes_with_patterns,
-    show_app_info,
-    validate_ssl_file_paths,
-)
-from litestar.routes import ASGIRoute, HTTPRoute, WebSocketRoute
-from litestar.utils.helpers import unwrap_partial
-
-__all__ = ("info_command", "routes_command", "run_command")
-
-if TYPE_CHECKING:
-    from litestar import Litestar
-
-
-@contextmanager
-def _server_lifespan(app: Litestar) -> Iterator[None]:
-    """Context manager handling the ASGI server lifespan.
-
-    It will be entered just before the ASGI server is started through the CLI.
-    """
-    with ExitStack() as exit_stack:
-        for manager in app._server_lifespan_managers:
-            if not isinstance(manager, AbstractContextManager):
-                manager = manager(app)  # type: ignore[assignment]
-            exit_stack.enter_context(manager)  # type: ignore[arg-type]
-
-        yield
-
-
-def _convert_uvicorn_args(args: dict[str, Any]) -> list[str]:
-    process_args = []
-    for arg, value in args.items():
-        if isinstance(value, bool):
-            if value:
-                process_args.append(f"--{arg}")
-        elif isinstance(value, tuple):
-            process_args.extend(f"--{arg}={item}" for item in value)
-        else:
-            process_args.append(f"--{arg}={value}")
-
-    return process_args
-
-
-def _run_uvicorn_in_subprocess(
-    *,
-    env: LitestarEnv,
-    host: str | None,
-    port: int | None,
-    workers: int | None,
-    reload: bool,
-    reload_dirs: tuple[str, ...] | None,
-    reload_include: tuple[str, ...] | None,
-    reload_exclude: tuple[str, ...] | None,
-    fd: int | None,
-    uds: str | None,
-    certfile_path: str | None,
-    keyfile_path: str | None,
-) -> None:
-    process_args: dict[str, Any] = {
-        "reload": reload,
-        "host": host,
-        "port": port,
-        "workers": workers,
-        "factory": env.is_app_factory,
-    }
-    if fd is not None:
-        process_args["fd"] = fd
-    if uds is not None:
-        process_args["uds"] = uds
-    if reload_dirs:
-        process_args["reload-dir"] = reload_dirs
-    if reload_include:
-        process_args["reload-include"] = reload_include
-    if reload_exclude:
-        process_args["reload-exclude"] = reload_exclude
-    if certfile_path is not None:
-        process_args["ssl-certfile"] = certfile_path
-    if keyfile_path is not None:
-        process_args["ssl-keyfile"] = keyfile_path
-    subprocess.run(
-        [sys.executable, "-m", "uvicorn", env.app_path, *_convert_uvicorn_args(process_args)],  # noqa: S603
-        check=True,
-    )
-
-
-@command(name="version")
-@option("-s", "--short", help="Exclude release level and serial information", is_flag=True, default=False)
-def version_command(short: bool) -> None:
-    """Show the currently installed Litestar version."""
-    from litestar import __version__
-
-    click.echo(__version__.formatted(short=short))
-
-
-@command(name="info")
-def info_command(app: Litestar) -> None:
-    """Show information about the detected Litestar app."""
-
-    show_app_info(app)
-
-
-@command(name="run")
-@option("-r", "--reload", help="Reload server on changes", default=False, is_flag=True)
-@option("-R", "--reload-dir", help="Directories to watch for file changes", multiple=True)
-@option(
-    "-I", "--reload-include", help="Glob patterns for files to include when watching for file changes", multiple=True
-)
-@option(
-    "-E", "--reload-exclude", help="Glob patterns for files to exclude when watching for file changes", multiple=True
-)
-@option("-p", "--port", help="Serve under this port", type=int, default=8000, show_default=True)
-@option(
-    "-W",
-    "--wc",
-    "--web-concurrency",
-    help="The number of HTTP workers to launch",
-    type=click.IntRange(min=1, max=multiprocessing.cpu_count() + 1),
-    show_default=True,
-    default=1,
-)
-@option("-H", "--host", help="Server under this host", default="127.0.0.1", show_default=True)
-@option(
-    "-F",
-    "--fd",
-    "--file-descriptor",
-    help="Bind to a socket from this file descriptor.",
-    type=int,
-    default=None,
-    show_default=True,
-)
-@option("-U", "--uds", "--unix-domain-socket", help="Bind to a UNIX domain socket.", default=None, show_default=True)
-@option("-d", "--debug", help="Run app in debug mode", is_flag=True)
-@option("-P", "--pdb", "--use-pdb", help="Drop into PDB on an exception", is_flag=True)
-@option("--ssl-certfile", help="Location of the SSL cert file", default=None)
-@option("--ssl-keyfile", help="Location of the SSL key file", default=None)
-@option(
-    "--create-self-signed-cert",
-    help="If certificate and key are not found at specified locations, create a self-signed certificate and a key",
-    is_flag=True,
-)
-def run_command(
-    reload: bool,
-    port: int,
-    wc: int,
-    host: str,
-    fd: int | None,
-    uds: str | None,
-    debug: bool,
-    reload_dir: tuple[str, ...],
-    reload_include: tuple[str, ...],
-    reload_exclude: tuple[str, ...],
-    pdb: bool,
-    ssl_certfile: str | None,
-    ssl_keyfile: str | None,
-    create_self_signed_cert: bool,
-    ctx: Context,
-) -> None:
-    """Run a Litestar app; requires ``uvicorn``.
-
-    The app can be either passed as a module path in the form of <module name>.<submodule>:<app instance or factory>,
-    set as an environment variable LITESTAR_APP with the same format or automatically discovered from one of these
-    canonical paths: app.py, asgi.py, application.py or app/__init__.py. When auto-discovering application factories,
-    functions with the name ``create_app`` are considered, or functions that are annotated as returning a ``Litestar``
-    instance.
-    """
-
-    if debug:
-        os.environ["LITESTAR_DEBUG"] = "1"
-
-    if pdb:
-        os.environ["LITESTAR_PDB"] = "1"
-
-    if not UVICORN_INSTALLED:
-        console.print(
-            r"uvicorn is not installed. Please install the standard group, litestar\[standard], to use this command."
-        )
-        sys.exit(1)
-
-    if callable(ctx.obj):
-        ctx.obj = ctx.obj()
-    else:
-        if debug:
-            ctx.obj.app.debug = True
-        if pdb:
-            ctx.obj.app.pdb_on_exception = True
-
-    env: LitestarEnv = ctx.obj
-    app = env.app
-
-    reload_dirs = env.reload_dirs or reload_dir
-    reload_include = env.reload_include or reload_include
-    reload_exclude = env.reload_exclude or reload_exclude
-
-    host = env.host or host
-    port = env.port if env.port is not None else port
-    fd = env.fd if env.fd is not None else fd
-    uds = env.uds or uds
-    reload = env.reload or reload or bool(reload_dirs) or bool(reload_include) or bool(reload_exclude)
-    workers = env.web_concurrency or wc
-
-    ssl_certfile = ssl_certfile or env.certfile_path
-    ssl_keyfile = ssl_keyfile or env.keyfile_path
-    create_self_signed_cert = create_self_signed_cert or env.create_self_signed_cert
-
-    certfile_path, keyfile_path = (
-        create_ssl_files(ssl_certfile, ssl_keyfile, host)
-        if create_self_signed_cert
-        else validate_ssl_file_paths(ssl_certfile, ssl_keyfile)
-    )
-
-    console.rule("[yellow]Starting server process", align="left")
-
-    show_app_info(app)
-    with _server_lifespan(app):
-        if workers == 1 and not reload:
-            import uvicorn
-
-            # A guard statement at the beginning of this function prevents uvicorn from being unbound
-            # See "reportUnboundVariable in:
-            # https://microsoft.github.io/pyright/#/configuration?id=type-check-diagnostics-settings
-            uvicorn.run(  # pyright: ignore
-                app=env.app_path,
-                host=host,
-                port=port,
-                fd=fd,
-                uds=uds,
-                factory=env.is_app_factory,
-                ssl_certfile=certfile_path,
-                ssl_keyfile=keyfile_path,
-            )
-        else:
-            # invoke uvicorn in a subprocess to be able to use the --reload flag. see
-            # https://github.com/litestar-org/litestar/issues/1191 and https://github.com/encode/uvicorn/issues/1045
-            if sys.gettrace() is not None:
-                console.print(
-                    "[yellow]Debugger detected. Breakpoints might not work correctly inside route handlers when running"
-                    " with the --reload or --workers options[/]"
-                )
-
-            _run_uvicorn_in_subprocess(
-                env=env,
-                host=host,
-                port=port,
-                workers=workers,
-                reload=reload,
-                reload_dirs=reload_dirs,
-                reload_include=reload_include,
-                reload_exclude=reload_exclude,
-                fd=fd,
-                uds=uds,
-                certfile_path=certfile_path,
-                keyfile_path=keyfile_path,
-            )
-
-
-@command(name="routes")
-@option("--schema", help="Include schema routes", is_flag=True, default=False)
-@option("--exclude", help="routes to exclude via regex", type=str, is_flag=False, multiple=True)
-def routes_command(app: Litestar, exclude: tuple[str, ...], schema: bool) -> None:  # pragma: no cover
-    """Display information about the application's routes."""
-
-    sorted_routes = sorted(app.routes, key=lambda r: r.path)
-    if not schema:
-        openapi_config = app.openapi_config or DEFAULT_OPENAPI_CONFIG
-        sorted_routes = remove_default_schema_routes(sorted_routes, openapi_config)
-    if exclude is not None:
-        sorted_routes = remove_routes_with_patterns(sorted_routes, exclude)
-
-    console.print(_RouteTree(sorted_routes))
-
-
-class _RouteTree(Tree):
-    def __init__(self, routes: list[HTTPRoute | ASGIRoute | WebSocketRoute]) -> None:
-        super().__init__("", hide_root=True)
-        self._routes = routes
-        self._build()
-
-    def _build(self) -> None:
-        for route in self._routes:
-            if isinstance(route, HTTPRoute):
-                self._handle_http_route(route)
-            elif isinstance(route, WebSocketRoute):
-                self._handle_websocket_route(route)
-            else:
-                self._handle_asgi_route(route)
-
-    def _handle_asgi_like_route(self, route: ASGIRoute | WebSocketRoute, route_type: str) -> None:
-        branch = self.add(f"[green]{route.path}[/green] ({route_type})")
-        branch.add(f"[blue]{route.route_handler.name or route.route_handler.handler_name}[/blue]")
-
-    def _handle_asgi_route(self, route: ASGIRoute) -> None:
-        self._handle_asgi_like_route(route, route_type="ASGI")
-
-    def _handle_websocket_route(self, route: WebSocketRoute) -> None:
-        self._handle_asgi_like_route(route, route_type="WS")
-
-    def _handle_http_route(self, route: HTTPRoute) -> None:
-        branch = self.add(f"[green]{route.path}[/green] (HTTP)")
-        for handler in route.route_handlers:
-            handler_info = [
-                f"[blue]{handler.name or handler.handler_name}[/blue]",
-            ]
-
-            if inspect.iscoroutinefunction(unwrap_partial(handler.fn)):
-                handler_info.append("[magenta]async[/magenta]")
-            else:
-                handler_info.append("[yellow]sync[/yellow]")
-
-            handler_info.append(f'[cyan]{", ".join(sorted(handler.http_methods))}[/cyan]')
-
-            if len(handler.paths) > 1:
-                for path in handler.paths:
-                    branch.add(" ".join([f"[green]{path}[green]", *handler_info]))
-            else:
-                branch.add(" ".join(handler_info))
diff --git a/venv/lib/python3.11/site-packages/litestar/cli/commands/schema.py b/venv/lib/python3.11/site-packages/litestar/cli/commands/schema.py
deleted file mode 100644
index a323bc7..0000000
--- a/venv/lib/python3.11/site-packages/litestar/cli/commands/schema.py
+++ /dev/null
@@ -1,82 +0,0 @@
-from pathlib import Path
-
-import msgspec
-from click import Path as ClickPath
-from click import group, option
-from yaml import dump as dump_yaml
-
-from litestar import Litestar
-from litestar._openapi.typescript_converter.converter import (
-    convert_openapi_to_typescript,
-)
-from litestar.cli._utils import JSBEAUTIFIER_INSTALLED, LitestarCLIException, LitestarGroup
-from litestar.serialization import encode_json, get_serializer
-
-__all__ = ("generate_openapi_schema", "generate_typescript_specs", "schema_group")
-
-
-@group(cls=LitestarGroup, name="schema")
-def schema_group() -> None:
-    """Manage server-side OpenAPI schemas."""
-
-
-def _generate_openapi_schema(app: Litestar, output: Path) -> None:
-    """Generate an OpenAPI Schema."""
-    serializer = get_serializer(app.type_encoders)
-    if output.suffix in (".yml", ".yaml"):
-        content = dump_yaml(
-            msgspec.to_builtins(app.openapi_schema.to_schema(), enc_hook=serializer),
-            default_flow_style=False,
-            encoding="utf-8",
-        )
-    else:
-        content = msgspec.json.format(
-            encode_json(app.openapi_schema.to_schema(), serializer=serializer),
-            indent=4,
-        )
-
-    try:
-        output.write_bytes(content)
-    except OSError as e:  # pragma: no cover
-        raise LitestarCLIException(f"failed to write schema to path {output}") from e
-
-
-@schema_group.command("openapi")  # type: ignore[misc]
-@option(
-    "--output",
-    help="output file path",
-    type=ClickPath(dir_okay=False, path_type=Path),
-    default=Path("openapi_schema.json"),
-    show_default=True,
-)
-def generate_openapi_schema(app: Litestar, output: Path) -> None:
-    """Generate an OpenAPI Schema."""
-    _generate_openapi_schema(app, output)
-
-
-@schema_group.command("typescript")  # type: ignore[misc]
-@option(
-    "--output",
-    help="output file path",
-    type=ClickPath(dir_okay=False, path_type=Path),
-    default=Path("api-specs.ts"),
-    show_default=True,
-)
-@option("--namespace", help="namespace to use for the typescript specs", type=str, default="API")
-def generate_typescript_specs(app: Litestar, output: Path, namespace: str) -> None:
-    """Generate TypeScript specs from the OpenAPI schema."""
-    if JSBEAUTIFIER_INSTALLED:  # pragma: no cover
-        from jsbeautifier import Beautifier
-
-        beautifier = Beautifier()
-    else:
-        beautifier = None
-    try:
-        specs = convert_openapi_to_typescript(app.openapi_schema, namespace)
-        # beautifier will be defined if JSBEAUTIFIER_INSTALLED is True
-        specs_output = (
-            beautifier.beautify(specs.write()) if JSBEAUTIFIER_INSTALLED and beautifier else specs.write()  # pyright: ignore
-        )
-        output.write_text(specs_output)
-    except OSError as e:  # pragma: no cover
-        raise LitestarCLIException(f"failed to write schema to path {output}") from e
diff --git a/venv/lib/python3.11/site-packages/litestar/cli/commands/sessions.py b/venv/lib/python3.11/site-packages/litestar/cli/commands/sessions.py
deleted file mode 100644
index f048dd1..0000000
--- a/venv/lib/python3.11/site-packages/litestar/cli/commands/sessions.py
+++ /dev/null
@@ -1,58 +0,0 @@
-from click import argument, group
-from rich.prompt import Confirm
-
-from litestar import Litestar
-from litestar.cli._utils import LitestarCLIException, LitestarGroup, console
-from litestar.middleware import DefineMiddleware
-from litestar.middleware.session import SessionMiddleware
-from litestar.middleware.session.server_side import ServerSideSessionBackend
-from litestar.utils import is_class_and_subclass
-
-__all__ = ("clear_sessions_command", "delete_session_command", "get_session_backend", "sessions_group")
-
-
-def get_session_backend(app: Litestar) -> ServerSideSessionBackend:
-    """Get the session backend used by a ``Litestar`` app."""
-    for middleware in app.middleware:
-        if isinstance(middleware, DefineMiddleware):
-            if not is_class_and_subclass(middleware.middleware, SessionMiddleware):
-                continue
-            backend = middleware.kwargs["backend"]
-            if not isinstance(backend, ServerSideSessionBackend):
-                raise LitestarCLIException("Only server-side backends are supported")
-            return backend
-    raise LitestarCLIException("Session middleware not installed")
-
-
-@group(cls=LitestarGroup, name="sessions")
-def sessions_group() -> None:
-    """Manage server-side sessions."""
-
-
-@sessions_group.command("delete")  # type: ignore[misc]
-@argument("session-id")
-def delete_session_command(session_id: str, app: Litestar) -> None:
-    """Delete a specific session."""
-    import anyio
-
-    backend = get_session_backend(app)
-    store = backend.config.get_store_from_app(app)
-
-    if Confirm.ask(f"Delete session {session_id!r}?"):
-        anyio.run(backend.delete, session_id, store)
-        console.print(f"[green]Deleted session {session_id!r}")
-
-
-@sessions_group.command("clear")  # type: ignore[misc]
-def clear_sessions_command(app: Litestar) -> None:
-    """Delete all sessions."""
-    import anyio
-
-    backend = get_session_backend(app)
-    store = backend.config.get_store_from_app(app)
-    if not hasattr(store, "delete_all"):
-        raise LitestarCLIException(f"{type(store)} does not support clearing all sessions")
-
-    if Confirm.ask("[red]Delete all sessions?"):
-        anyio.run(store.delete_all)  # pyright: ignore
-        console.print("[green]All active sessions deleted")