Spark
a6d2ed9eae
- board_events append-only + log_event/get_events/column_entry_times/
get_metrics (débit, temps de cycle); journalisation des moves,
créations, fermetures/rouvertures (UI et réconciliation Gitea),
commentaires; un reclassement intra-colonne ne journalise pas
- client Gitea: get_issue, get_issue_comments (paginés), create_comment
- API: GET /api/issues/{o}/{r}/{n} (404 propre), POST .../comments,
GET /api/events, GET /api/metrics, page /activity
- config: KANBANTE_WIP_LIMITS (colonne:limite) et KANBANTE_AGING_DAYS;
le board calcule le temps en colonne (journal, replis updated_at
puis création de l'issue)
- reconcile_board_state retourne aussi les numéros fermés/purgés
108 lines
3.9 KiB
Python
108 lines
3.9 KiB
Python
"""
|
|
Centralised settings for Kanbante.
|
|
|
|
Every setting is read from the environment at call time (no import-time
|
|
freezing), so tests and operators can change them without code edits.
|
|
|
|
Environment variables:
|
|
GITEA_URL Base URL of the Gitea instance.
|
|
GITEA_TOKEN Gitea API token (read/write issues).
|
|
KANBANTE_DB_PATH Path of the local SQLite database.
|
|
KANBANTE_AUTH_USER Basic-auth username (with _PASSWORD: enables auth).
|
|
KANBANTE_AUTH_PASSWORD Basic-auth password.
|
|
KANBANTE_REQUIRE_AUTH "1" = refuse to serve if auth is not configured.
|
|
KANBANTE_ACTIVE_WINDOW_DAYS A non-archived repo updated within this many
|
|
days counts as "active" (default 365).
|
|
KANBANTE_CACHE_TTL Seconds to cache Gitea list responses (default 30).
|
|
KANBANTE_MAX_NOTE_CHARS Maximum size of a project note (default 20000).
|
|
KANBANTE_SYNC_GITEA "1" (default) = moving a card to/from "done"
|
|
closes / reopens the Gitea issue.
|
|
KANBANTE_WIP_LIMITS Comma list "column:limit" (e.g.
|
|
"in_progress:5,review:3"). Columns not
|
|
listed are unlimited. Soft limits: the UI
|
|
warns, moves are never blocked.
|
|
KANBANTE_AGING_DAYS Days in the same column before a card is
|
|
flagged as aging (default 7; "stale" at 2x).
|
|
"""
|
|
|
|
import os
|
|
from dataclasses import dataclass
|
|
from pathlib import Path
|
|
|
|
BASE_DIR = Path(__file__).resolve().parent.parent
|
|
|
|
APP_VERSION = "0.3.0"
|
|
|
|
|
|
def _env_bool(name: str, default: bool) -> bool:
|
|
raw = os.getenv(name)
|
|
if raw is None:
|
|
return default
|
|
return raw.strip().lower() in ("1", "true", "yes", "on")
|
|
|
|
|
|
def _env_int(name: str, default: int) -> int:
|
|
raw = os.getenv(name)
|
|
try:
|
|
return int(raw) if raw is not None else default
|
|
except ValueError:
|
|
return default
|
|
|
|
|
|
def _env_float(name: str, default: float) -> float:
|
|
raw = os.getenv(name)
|
|
try:
|
|
return float(raw) if raw is not None else default
|
|
except ValueError:
|
|
return default
|
|
|
|
|
|
def _env_wip_limits(name: str) -> dict[str, int]:
|
|
limits: dict[str, int] = {}
|
|
for chunk in os.getenv(name, "").split(","):
|
|
column, sep, value = chunk.partition(":")
|
|
column = column.strip()
|
|
if sep and column and value.strip().isdigit():
|
|
limits[column] = int(value.strip())
|
|
return limits
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
class Settings:
|
|
gitea_url: str = "https://git.dracodev.net"
|
|
gitea_token: str = ""
|
|
db_path: str = "~/.kanbante/kanbante.db"
|
|
auth_user: str = ""
|
|
auth_password: str = ""
|
|
require_auth: bool = False
|
|
active_window_days: int = 365
|
|
cache_ttl: float = 30.0
|
|
max_note_chars: int = 20_000
|
|
sync_gitea: bool = True
|
|
wip_limits: dict | None = None
|
|
aging_days: int = 7
|
|
|
|
@property
|
|
def auth_enabled(self) -> bool:
|
|
return bool(self.auth_user and self.auth_password)
|
|
|
|
|
|
def get_settings() -> Settings:
|
|
"""Build settings from the current environment."""
|
|
return Settings(
|
|
gitea_url=os.getenv("GITEA_URL", "https://git.dracodev.net").rstrip("/"),
|
|
gitea_token=os.getenv("GITEA_TOKEN", ""),
|
|
db_path=os.getenv(
|
|
"KANBANTE_DB_PATH", os.path.expanduser("~/.kanbante/kanbante.db")
|
|
),
|
|
auth_user=os.getenv("KANBANTE_AUTH_USER", ""),
|
|
auth_password=os.getenv("KANBANTE_AUTH_PASSWORD", ""),
|
|
require_auth=_env_bool("KANBANTE_REQUIRE_AUTH", False),
|
|
active_window_days=_env_int("KANBANTE_ACTIVE_WINDOW_DAYS", 365),
|
|
cache_ttl=_env_float("KANBANTE_CACHE_TTL", 30.0),
|
|
max_note_chars=_env_int("KANBANTE_MAX_NOTE_CHARS", 20_000),
|
|
sync_gitea=_env_bool("KANBANTE_SYNC_GITEA", True),
|
|
wip_limits=_env_wip_limits("KANBANTE_WIP_LIMITS"),
|
|
aging_days=_env_int("KANBANTE_AGING_DAYS", 7),
|
|
)
|