Development server with hot reload.
Starts a pounce ASGI server with the live chirp App object. Uses single-worker mode with reload enabled for development.
server.dev
| Name | Type | Default | Description |
|---|---|---|---|
type
|
|
— | |
qualified_name
|
|
— | |
element_type
|
|
— | |
description
|
|
— | |
source_file
|
|
— | |
line_number
|
|
— | |
is_autodoc
|
|
— | |
autodoc_element
|
|
— | |
_autodoc_template
|
|
— | |
_autodoc_url_path
|
|
— | |
_autodoc_page_type
|
|
— | |
title
|
|
— | |
doc_content_hash
|
|
— |
Symbols on this page
run_dev_server
function
def run_dev_server(app: object, host: str, port: int, *, reload: bool = True, reload_include: tuple[str, ...] = (), reload_dirs: tuple[str, ...] = (), app_path: str | None = None, lifecycle_collector: LifecycleCollector | None = None, display: DisplayConfig | None = None) -> NoneStart a pounce dev server with the given chirp App.
Pounce'srun() takes an import string (e.g., "myapp:app"),
but chirp has a liveApp object. We use pounce.Server
directly with the ASGI callable.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
app
|
object
|
— | ASGI callable (chirp App instance). |
host
|
str
|
— | Bind host address. |
port
|
int
|
— | Bind port number. |
reload
|
bool
|
True
|
Enable auto-reload on file changes (default True). |
reload_include
|
tuple[str, ...]
|
()
|
Extra file extensions to watch when reload is active (e.g. ``(".html", ".css", ".md")``). |
reload_dirs
|
tuple[str, ...]
|
()
|
Extra directories to watch alongside cwd. |
app_path
|
str | None
|
None
|
Optional ``"module:attribute"`` import string. When provided, pounce reimports the app on each reload cycle so that code changes on disk take effect immediately. |
lifecycle_collector
|
LifecycleCollector | None
|
None
|
Optional Pounce LifecycleCollector for observability. Forwarded to the Pounce Server. |
display
|
DisplayConfig | None
|
None
|
Optional Pounce ``DisplayConfig`` forwarded unchanged as ``ServerConfig.display``. ``None`` leaves Pounce unset behavior intact (env / pyproject / app-hook resolution). |
View source · /home/runner/work/chirp/chirp/site/../src/chirp/server/dev.py:1