zombie-escape 1.5.4__py3-none-any.whl

zombie_escape/__about__.py

@@ -0,0 +1,4 @@
+# SPDX-FileCopyrightText: 2025-present Toshihiro Kamiya <kamiya@mbj.nifty.com>
+#
+# SPDX-License-Identifier: MIT
+__version__ = "1.5.4"

zombie_escape/__init__.py

@@ -0,0 +1,7 @@
+# SPDX-FileCopyrightText: 2025-present Toshihiro Kamiya <kamiya@mbj.nifty.com>
+#
+# SPDX-License-Identifier: MIT
+
+from .zombie_escape import main as main
+
+__all__ = ["main"]

zombie_escape/colors.py

@@ -0,0 +1,170 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+# Basic palette
+WHITE: tuple[int, int, int] = (255, 255, 255)
+BLACK: tuple[int, int, int] = (0, 0, 0)
+RED: tuple[int, int, int] = (255, 0, 0)
+GREEN: tuple[int, int, int] = (0, 255, 0)
+BLUE: tuple[int, int, int] = (0, 0, 255)
+GRAY: tuple[int, int, int] = (100, 100, 100)
+LIGHT_GRAY: tuple[int, int, int] = (200, 200, 200)
+YELLOW: tuple[int, int, int] = (255, 255, 0)
+ORANGE: tuple[int, int, int] = (255, 165, 0)
+DARK_RED: tuple[int, int, int] = (139, 0, 0)
+TRACKER_OUTLINE_COLOR: tuple[int, int, int] = (170, 70, 220)
+WALL_FOLLOWER_OUTLINE_COLOR: tuple[int, int, int] = (140, 140, 140)
+
+
+@dataclass(frozen=True)
+class EnvironmentPalette:
+    """Collection of colors that define the ambient environment."""
+
+    floor_primary: tuple[int, int, int]
+    floor_secondary: tuple[int, int, int]
+    outside: tuple[int, int, int]
+    inner_wall: tuple[int, int, int]
+    inner_wall_border: tuple[int, int, int]
+    outer_wall: tuple[int, int, int]
+    outer_wall_border: tuple[int, int, int]
+
+
+def _clamp(value: float) -> int:
+    return max(0, min(255, int(value)))
+
+
+def _adjust_color(
+    color: tuple[int, int, int], *, brightness: float = 1.0, saturation: float = 1.0
+) -> tuple[int, int, int]:
+    """Return color tinted by brightness/saturation multipliers."""
+
+    r, g, b = color
+    gray = 0.2126 * r + 0.7152 * g + 0.0722 * b
+    def mix(component: int) -> int:
+        value = gray + (component - gray) * saturation
+        value *= brightness
+        return _clamp(value)
+
+    return mix(r), mix(g), mix(b)
+
+
+DEFAULT_AMBIENT_PALETTE_KEY = "default"
+NO_FLASHLIGHT_PALETTE_KEY = "no_flashlight"
+DAWN_AMBIENT_PALETTE_KEY = "dawn"
+
+# Base palette used throughout gameplay (matches the previous constants).
+_DEFAULT_ENVIRONMENT_PALETTE = EnvironmentPalette(
+    floor_primary=(43, 57, 70),
+    floor_secondary=(50, 64, 79),
+    outside=(32, 60, 40),
+    inner_wall=(125, 101, 78),
+    inner_wall_border=(136, 110, 85),
+    outer_wall=(136, 135, 128),
+    outer_wall_border=(147, 146, 138),
+)
+
+# Dark, desaturated palette that sells the "alone without a flashlight" vibe.
+_GLOOM_ENVIRONMENT_PALETTE = EnvironmentPalette(
+    floor_primary=_adjust_color(
+        _DEFAULT_ENVIRONMENT_PALETTE.floor_primary, brightness=0.725, saturation=0.675
+    ),
+    floor_secondary=_adjust_color(
+        _DEFAULT_ENVIRONMENT_PALETTE.floor_secondary, brightness=0.74, saturation=0.65
+    ),
+    outside=_adjust_color(
+        _DEFAULT_ENVIRONMENT_PALETTE.outside, brightness=0.7, saturation=0.625
+    ),
+    inner_wall=_adjust_color(
+        _DEFAULT_ENVIRONMENT_PALETTE.inner_wall, brightness=0.775, saturation=0.7
+    ),
+    inner_wall_border=_adjust_color(
+        _DEFAULT_ENVIRONMENT_PALETTE.inner_wall_border, brightness=0.775, saturation=0.7
+    ),
+    outer_wall=_adjust_color(
+        _DEFAULT_ENVIRONMENT_PALETTE.outer_wall, brightness=0.75, saturation=0.675
+    ),
+    outer_wall_border=_adjust_color(
+        _DEFAULT_ENVIRONMENT_PALETTE.outer_wall_border, brightness=0.75, saturation=0.675
+    ),
+)
+
+_DAWN_ENVIRONMENT_PALETTE = EnvironmentPalette(
+    floor_primary=(58, 70, 84),
+    floor_secondary=(66, 78, 92),
+    outside=(118, 140, 104),
+    inner_wall=(125, 101, 78),
+    inner_wall_border=(136, 110, 85),
+    outer_wall=(136, 135, 128),
+    outer_wall_border=(147, 146, 138),
+)
+
+ENVIRONMENT_PALETTES: dict[str, EnvironmentPalette] = {
+    DEFAULT_AMBIENT_PALETTE_KEY: _DEFAULT_ENVIRONMENT_PALETTE,
+    NO_FLASHLIGHT_PALETTE_KEY: _GLOOM_ENVIRONMENT_PALETTE,
+    DAWN_AMBIENT_PALETTE_KEY: _DAWN_ENVIRONMENT_PALETTE,
+}
+
+
+def get_environment_palette(key: str | None) -> EnvironmentPalette:
+    """Return the color palette for the provided key (falls back to default)."""
+
+    if not key:
+        return ENVIRONMENT_PALETTES[DEFAULT_AMBIENT_PALETTE_KEY]
+    return ENVIRONMENT_PALETTES.get(key, ENVIRONMENT_PALETTES[DEFAULT_AMBIENT_PALETTE_KEY])
+
+
+def ambient_palette_key_for_flashlights(count: int) -> str:
+    """Return the palette key for the provided flashlight inventory count."""
+
+    return (
+        DEFAULT_AMBIENT_PALETTE_KEY
+        if max(0, count) > 0
+        else NO_FLASHLIGHT_PALETTE_KEY
+    )
+
+
+# World colors (default palette versions preserved for backwards compatibility).
+INTERNAL_WALL_COLOR: tuple[int, int, int] = _DEFAULT_ENVIRONMENT_PALETTE.inner_wall
+INTERNAL_WALL_BORDER_COLOR: tuple[int, int, int] = _DEFAULT_ENVIRONMENT_PALETTE.inner_wall_border
+OUTER_WALL_COLOR: tuple[int, int, int] = _DEFAULT_ENVIRONMENT_PALETTE.outer_wall
+OUTER_WALL_BORDER_COLOR: tuple[int, int, int] = _DEFAULT_ENVIRONMENT_PALETTE.outer_wall_border
+FLOOR_COLOR_PRIMARY: tuple[int, int, int] = _DEFAULT_ENVIRONMENT_PALETTE.floor_primary
+FLOOR_COLOR_SECONDARY: tuple[int, int, int] = _DEFAULT_ENVIRONMENT_PALETTE.floor_secondary
+FLOOR_COLOR_OUTSIDE: tuple[int, int, int] = _DEFAULT_ENVIRONMENT_PALETTE.outside
+FOOTPRINT_COLOR: tuple[int, int, int] = (110, 200, 255)
+STEEL_BEAM_COLOR: tuple[int, int, int] = (110, 50, 50)
+STEEL_BEAM_LINE_COLOR: tuple[int, int, int] = (180, 90, 90)
+
+
+__all__ = [
+    "WHITE",
+    "BLACK",
+    "RED",
+    "GREEN",
+    "BLUE",
+    "GRAY",
+    "LIGHT_GRAY",
+    "YELLOW",
+    "ORANGE",
+    "DARK_RED",
+    "TRACKER_OUTLINE_COLOR",
+    "WALL_FOLLOWER_OUTLINE_COLOR",
+    "DAWN_AMBIENT_PALETTE_KEY",
+    "INTERNAL_WALL_COLOR",
+    "INTERNAL_WALL_BORDER_COLOR",
+    "OUTER_WALL_COLOR",
+    "OUTER_WALL_BORDER_COLOR",
+    "FLOOR_COLOR_PRIMARY",
+    "FLOOR_COLOR_SECONDARY",
+    "FLOOR_COLOR_OUTSIDE",
+    "FOOTPRINT_COLOR",
+    "STEEL_BEAM_COLOR",
+    "STEEL_BEAM_LINE_COLOR",
+    "EnvironmentPalette",
+    "DEFAULT_AMBIENT_PALETTE_KEY",
+    "NO_FLASHLIGHT_PALETTE_KEY",
+    "ENVIRONMENT_PALETTES",
+    "get_environment_palette",
+    "ambient_palette_key_for_flashlights",
+]

zombie_escape/config.py

@@ -0,0 +1,58 @@
+import json
+from copy import deepcopy
+from pathlib import Path
+from typing import Any
+
+from platformdirs import user_config_dir
+
+APP_NAME = "ZombieEscape"
+
+# Defaults for all configurable options
+DEFAULT_CONFIG: dict[str, Any] = {
+    "language": "en",
+    "footprints": {"enabled": True},
+    "fast_zombies": {"enabled": False, "ratio": 0.1},
+    "car_hint": {"enabled": True, "delay_ms": 180_000},
+    "steel_beams": {"enabled": False, "chance": 0.05},
+}
+
+
+def user_config_path() -> Path:
+    """Return the platform-specific config file path."""
+    return Path(user_config_dir(APP_NAME, APP_NAME)) / "config.json"
+
+
+def _deep_merge(base: dict[str, Any], override: dict[str, Any]) -> dict[str, Any]:
+    """Deep-merge dictionaries, with override winning on conflicts."""
+    merged: dict[str, Any] = deepcopy(base)
+    for key, val in override.items():
+        if isinstance(val, dict) and isinstance(merged.get(key), dict):
+            merged[key] = _deep_merge(merged[key], val)
+        else:
+            merged[key] = val
+    return merged
+
+
+def load_config(*, path: Path | None = None) -> tuple[dict[str, Any], Path]:
+    """Load config from disk, falling back to defaults on errors."""
+    config_path = path or user_config_path()
+    config: dict[str, Any] = deepcopy(DEFAULT_CONFIG)
+
+    try:
+        if config_path.exists():
+            loaded = json.loads(config_path.read_text(encoding="utf-8"))
+            if isinstance(loaded, dict):
+                config = _deep_merge(config, loaded)
+    except Exception as exc:  # noqa: BLE001
+        print(f"Failed to load config ({config_path}): {exc}")
+
+    return config, config_path
+
+
+def save_config(config: dict[str, Any], path: Path) -> None:
+    """Persist config to disk, creating parent dirs as needed."""
+    try:
+        path.parent.mkdir(parents=True, exist_ok=True)
+        path.write_text(json.dumps(config, indent=2), encoding="utf-8")
+    except Exception as exc:  # noqa: BLE001
+        print(f"Failed to save config ({path}): {exc}")