Classes
ServerConfig
89
▼
Immutable server configuration.
All settings for a pounce server instance. Created once at startup…
ServerConfig
89
▼
Immutable server configuration.
All settings for a pounce server instance. Created once at startup, shared across all worker threads (safe because frozen).
Attributes
| Name | Type | Description |
|---|---|---|
host |
str
|
— |
port |
int
|
— |
workers |
int
|
— |
backlog |
int
|
— |
worker_mode |
str
|
— |
worker_startup_failure |
str
|
— |
cpu_affinity |
bool
|
— |
executor_threads_per_worker |
int
|
— |
keep_alive_timeout |
float
|
— |
request_timeout |
float
|
— |
header_timeout |
float
|
— |
startup_timeout |
float
|
— |
shutdown_timeout |
float
|
— |
max_request_size |
int
|
— |
max_header_size |
int
|
— |
max_headers |
int
|
— |
max_connections |
int
|
— |
max_requests_per_connection |
int
|
— |
access_log |
bool
|
— |
log_level |
str
|
— |
log_format |
str
|
— |
display |
DisplayConfig | None
|
— |
app_name |
str | None
|
— |
app_tagline |
str | None
|
— |
app_version |
str | None
|
— |
signage |
str | None
|
— |
access_log_filter |
Callable[[str, str, int], bool] | None
|
— |
server_header |
str
|
— |
date_header |
bool
|
— |
root_path |
str
|
— |
compression |
bool
|
— |
compression_min_size |
int
|
— |
compression_dictionaries |
tuple[Any, ...]
|
— |
server_timing |
bool
|
— |
debug |
bool
|
— |
reload |
bool
|
— |
reload_include |
tuple[str, ...]
|
— |
reload_dirs |
tuple[str, ...]
|
— |
h11_max_incomplete_event_size |
int | None
|
— |
trusted_hosts |
frozenset[str]
|
— |
trusted_hosts_wildcard |
bool
|
— |
health_check_path |
str | None
|
— |
introspection_enabled |
bool
|
— |
introspection_bind |
str
|
— |
introspection_path |
str
|
— |
uds |
str | None
|
— |
uds_permissions |
int
|
— |
ssl_certfile |
str | None
|
— |
ssl_keyfile |
str | None
|
— |
static_files |
dict[str, str]
|
— |
static_cache_control |
str
|
— |
static_precompressed |
bool
|
— |
static_follow_symlinks |
bool
|
— |
static_index_file |
str | None
|
— |
middleware |
list[Middleware]
|
— |
websocket_compression |
bool
|
— |
websocket_max_message_size |
int
|
— |
reload_timeout |
float
|
— |
otel_endpoint |
str | None
|
— |
otel_service_name |
str
|
— |
lifecycle_logging |
bool
|
— |
log_slow_requests_threshold |
float
|
— |
metrics_enabled |
bool
|
— |
metrics_path |
str
|
— |
rate_limit_enabled |
bool
|
— |
rate_limit_requests_per_second |
float
|
— |
rate_limit_burst |
int
|
— |
request_queue_enabled |
bool
|
— |
request_queue_max_depth |
int
|
— |
http3_enabled |
bool
|
— |
http3_max_connections |
int
|
— |
http3_idle_timeout |
float
|
— |
http3_qpack_max_table_capacity |
int
|
— |
http3_zero_rtt_enabled |
bool
|
— |
sentry_dsn |
str | None
|
— |
sentry_environment |
str | None
|
— |
sentry_release |
str | None
|
— |
sentry_traces_sample_rate |
float
|
— |
sentry_profiles_sample_rate |
float
|
— |
_VALID_LOG_LEVELS |
frozenset[str]
|
— |
_VALID_LOG_FORMATS |
frozenset[str]
|
— |
_VALID_WORKER_MODES |
frozenset[str]
|
— |
_VALID_WORKER_STARTUP_FAILURE |
frozenset[str]
|
— |
Methods
resolve_workers
0
int
▼
Return the effective worker count.
If ``workers`` is 0 (auto-detect), returns …
resolve_workers
0
int
▼
def resolve_workers(self) -> int
Return the effective worker count.
Ifworkers is 0 (auto-detect), returns os.cpu_count()
(minimum 1). Otherwise returns the explicit value.
Returns
int
to_iic_dict
0
dict[str, object]
▼
Serialize to a JSON-compatible dict for IIC transfer.
Drops non-serializable f…
to_iic_dict
0
dict[str, object]
▼
def to_iic_dict(self) -> dict[str, object]
Serialize to a JSON-compatible dict for IIC transfer.
Drops non-serializable fields (callables, middleware, display). Converts frozenset to sorted list for JSON round-tripping.
Returns
dict[str, object]
to_json
0
str
▼
Serialize to a JSON string for IIC transfer.
to_json
0
str
▼
def to_json(self) -> str
Returns
str
from_iic_dict
1
ServerConfig
▼
Reconstruct from a dict produced by `to_iic_dict`().
Converts list back to fro…
classmethod
from_iic_dict
1
ServerConfig
▼
def from_iic_dict(cls, d: dict[str, Any]) -> ServerConfig
Reconstruct from a dict produced byto_iic_dict().
Converts list back to frozenset fortrusted_hosts, and
drops any keys that are not valid constructor parameters.
Parameters
| Name | Type | Description |
|---|---|---|
d |
— |
Returns
ServerConfig
from_json
1
ServerConfig
▼
Reconstruct from a JSON string produced by `to_json`().
classmethod
from_json
1
ServerConfig
▼
def from_json(cls, s: str) -> ServerConfig
Parameters
| Name | Type | Description |
|---|---|---|
s |
— |
Returns
ServerConfig
Internal Methods 1 ▼
__post_init__
0
▼
Validate configuration values.
__post_init__
0
▼
def __post_init__(self) -> None