mud_server.config

Server configuration management.

This module handles loading and accessing server configuration from multiple sources with a clear priority order:

1. Environment variables (highest priority) - for containerized deployments

2. Config file (config/server.ini) - for static deployments

3. Built-in defaults (lowest priority) - sensible fallbacks

Configuration is loaded once at module import time and cached. The ServerConfig dataclass provides typed access to all settings.

Usage:

from mud_server.config import config

# Access settings print(config.server.host) print(config.security.cors_origins) print(config.is_production)

Environment Variable Mapping:

MUD_HOST -> server.host MUD_PORT -> server.port MUD_PRODUCTION -> security.production MUD_CORS_ORIGINS -> security.cors_origins MUD_DB_PATH -> database.path MUD_LOG_LEVEL -> logging.level MUD_SESSION_TTL_MINUTES -> session.ttl_minutes MUD_SESSION_SLIDING_EXPIRATION -> session.sliding_expiration MUD_SESSION_ALLOW_MULTIPLE -> session.allow_multiple_sessions MUD_SESSION_ACTIVE_WINDOW_MINUTES -> session.active_window_minutes MUD_CHAR_DEFAULT_SLOTS -> characters.default_slots MUD_CHAR_MAX_SLOTS -> characters.max_slots

Attributes

PROJECT_ROOT
CONFIG_DIR
CONFIG_FILE
CONFIG_EXAMPLE
config

Classes

ServerSettings	Network server configuration.
SecuritySettings	Security-related configuration.
SessionSettings	Session management configuration.
DatabaseSettings	Database configuration.
LoggingSettings	Logging configuration.
RateLimitSettings	Rate limiting configuration.
CharacterSettings	Character slot limits and defaults.
FeatureSettings	Feature flags.
WorldSettings	Multi-world configuration settings.
ServerConfig	Complete server configuration.
use_test_database	Context manager for using a temporary test database.

Functions

load_config()	Load configuration from all sources with proper priority.
reload_config()	Reload configuration from disk and environment.
get_config_status()	Get configuration status for diagnostics.
print_config_summary()	Print a summary of current configuration to stdout.

Module Contents

mud_server.config.PROJECT_ROOT

mud_server.config.CONFIG_DIR

mud_server.config.CONFIG_FILE

mud_server.config.CONFIG_EXAMPLE

class mud_server.config.ServerSettings

Network server configuration.

host: str = '0.0.0.0'

port: int = 8000

class mud_server.config.SecuritySettings

Security-related configuration.

production: bool = False

cors_origins: list[str] = ['http://localhost:7860']

cors_allow_credentials: bool = True

cors_allow_methods: list[str] = ['*']

cors_allow_headers: list[str] = ['*']

docs_enabled: Literal['auto', 'enabled', 'disabled'] = 'auto'

class mud_server.config.SessionSettings

Session management configuration.

ttl_minutes: int = 480

sliding_expiration: bool = True

allow_multiple_sessions: bool = False

active_window_minutes: int = 30

class mud_server.config.DatabaseSettings

Database configuration.

path: str = 'data/mud.db'

property absolute_path: pathlib.Path

Get absolute path to database file.

class mud_server.config.LoggingSettings

Logging configuration.

level: str = 'INFO'

format: Literal['simple', 'detailed', 'json'] = 'detailed'

class mud_server.config.RateLimitSettings

Rate limiting configuration.

enabled: bool = False

login_per_minute: int = 5

register_per_minute: int = 5

api_per_second: int = 30

class mud_server.config.CharacterSettings

Character slot limits and defaults.

default_slots: int = 2

max_slots: int = 10

class mud_server.config.FeatureSettings

Feature flags.

ollama_enabled: bool = True

verbose_errors: bool = False

class mud_server.config.WorldSettings

Multi-world configuration settings.

worlds_root: str = 'data/worlds'

default_world_id: str = 'pipeworks_web'

allow_multi_world_characters: bool = False

class mud_server.config.ServerConfig

Complete server configuration.

This is the main configuration object that aggregates all settings sections. Access via the module-level config singleton.

server: ServerSettings

security: SecuritySettings

session: SessionSettings

database: DatabaseSettings

logging: LoggingSettings

rate_limit: RateLimitSettings

characters: CharacterSettings

features: FeatureSettings

worlds: WorldSettings

property is_production: bool

Convenience property for production mode check.

property docs_should_be_enabled: bool

Determine if API docs should be enabled based on settings.

mud_server.config.load_config()

Load configuration from all sources with proper priority.

Priority (highest wins):

1. Environment variables

2. config/server.ini

3. config/server.example.ini (fallback for development)

4. Built-in defaults

Returns:

Fully populated configuration object.

Return type:

ServerConfig

mud_server.config.reload_config()

Reload configuration from disk and environment.

This updates the module-level config singleton. Use sparingly as it doesn’t update already-running server middleware.

Returns:

The newly loaded configuration.

Return type:

ServerConfig

mud_server.config.config

mud_server.config.get_config_status()

Get configuration status for diagnostics.

Returns a dictionary with configuration source information, useful for debugging and admin dashboards.

mud_server.config.print_config_summary()

Print a summary of current configuration to stdout.

class mud_server.config.use_test_database(db_path)

Context manager for using a temporary test database.

This is the recommended way to set up test databases. It properly configures the config system to use a temporary database path.

Usage:

from mud_server.config import use_test_database

def test_something(tmp_path):

db_path = tmp_path / “test.db” with use_test_database(db_path):

# Database operations will use db_path database.init_database()

Parameters:

db_path (pathlib.Path | str) – Path to the test database file

db_path

original_path: str | None = None