Lukas
ac2028e1c2
Consolidate the two divergent implementations of _since_unix from ban_service.py and history_service.py into a single shared utility function in time_utils.py. Changes: - Move _since_unix to app/utils/time_utils.py with consistent time.time() approach - Move TIME_RANGE_SLACK_SECONDS constant to app/utils/constants.py - Update ban_service.py to import since_unix from time_utils - Update history_service.py to import since_unix from time_utils - Both services now use the same window boundary calculation with 60-second slack - Add comprehensive tests for the shared since_unix function - Document timestamp handling rationale in Backend-Development.md This ensures dashboard and history queries return consistent row counts for the same time range by using the same timestamp calculation and slack window across all services. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
94 lines
3.4 KiB
Python
94 lines
3.4 KiB
Python
"""Application-wide constants.
|
|
|
|
All magic numbers, default paths, and limit values live here.
|
|
Import from this module rather than hard-coding values in business logic.
|
|
"""
|
|
|
|
from typing import Final
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# fail2ban integration
|
|
# ---------------------------------------------------------------------------
|
|
|
|
DEFAULT_FAIL2BAN_SOCKET: Final[str] = "/var/run/fail2ban/fail2ban.sock"
|
|
"""Default path to the fail2ban Unix domain socket."""
|
|
|
|
FAIL2BAN_SOCKET_TIMEOUT_FAST: Final[float] = 5.0
|
|
"""Maximum seconds for fast operations (health checks, metadata probes)."""
|
|
|
|
FAIL2BAN_SOCKET_TIMEOUT: Final[float] = 10.0
|
|
"""Maximum seconds for command operations (config, jail management)."""
|
|
|
|
FAIL2BAN_TRUTHY_VALUES: Final[frozenset[str]] = frozenset({"true", "yes", "1"})
|
|
"""String values treated as boolean true by fail2ban configuration parsers."""
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Database
|
|
# ---------------------------------------------------------------------------
|
|
|
|
DEFAULT_DATABASE_PATH: Final[str] = "bangui.db"
|
|
"""Default filename for the BanGUI application SQLite database."""
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Authentication
|
|
# ---------------------------------------------------------------------------
|
|
|
|
DEFAULT_SESSION_DURATION_MINUTES: Final[int] = 60
|
|
"""Default session lifetime in minutes."""
|
|
|
|
SESSION_TOKEN_BYTES: Final[int] = 32
|
|
"""Number of random bytes used when generating a session token."""
|
|
|
|
SESSION_TOKEN_SIGNATURE_SEPARATOR: Final[str] = "."
|
|
"""Separator used to append a signature to a signed session token."""
|
|
|
|
SESSION_COOKIE_NAME: Final[str] = "bangui_session"
|
|
"""Name of the session cookie used by the browser SPA."""
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Time-range presets (used by dashboard and history endpoints)
|
|
# ---------------------------------------------------------------------------
|
|
|
|
TIME_RANGE_24H: Final[str] = "24h"
|
|
TIME_RANGE_7D: Final[str] = "7d"
|
|
TIME_RANGE_30D: Final[str] = "30d"
|
|
TIME_RANGE_365D: Final[str] = "365d"
|
|
|
|
VALID_TIME_RANGES: Final[frozenset[str]] = frozenset(
|
|
{TIME_RANGE_24H, TIME_RANGE_7D, TIME_RANGE_30D, TIME_RANGE_365D}
|
|
)
|
|
|
|
TIME_RANGE_HOURS: Final[dict[str, int]] = {
|
|
TIME_RANGE_24H: 24,
|
|
TIME_RANGE_7D: 7 * 24,
|
|
TIME_RANGE_30D: 30 * 24,
|
|
TIME_RANGE_365D: 365 * 24,
|
|
}
|
|
|
|
TIME_RANGE_SLACK_SECONDS: Final[int] = 60
|
|
"""Clock drift and test seeding tolerance for timestamp comparisons."""
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Pagination
|
|
# ---------------------------------------------------------------------------
|
|
|
|
DEFAULT_PAGE_SIZE: Final[int] = 100
|
|
MAX_PAGE_SIZE: Final[int] = 500
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Blocklist import
|
|
# ---------------------------------------------------------------------------
|
|
|
|
BLOCKLIST_IMPORT_DEFAULT_HOUR: Final[int] = 3
|
|
"""Default hour (UTC) for the nightly blocklist import job."""
|
|
|
|
BLOCKLIST_PREVIEW_MAX_LINES: Final[int] = 100
|
|
"""Maximum number of IP lines returned by the blocklist preview endpoint."""
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Health check
|
|
# ---------------------------------------------------------------------------
|
|
|
|
HEALTH_CHECK_INTERVAL_SECONDS: Final[int] = 30
|
|
"""How often the background health-check task polls fail2ban."""
|