[Phase 1] Task 3: Create config.py — Configuration management #7

New Issue

shoko · 2026-04-02T18:29:22+02:00

shoko commented

2026-04-02 18:29:22 +02:00

Task 3: Create config.py — Configuration management

Labels: phase-1, architecture
Dependency: None — can start immediately (parallel with Task 1, 2)

Goal

Create centralized configuration management with file-based config and environment variable overrides.

Files to create

config.py (at repo root)

Implementation

"""JIGAIDO Configuration Management."""

import json
import os
from pathlib import Path
from typing import Optional

# Default data directory
DEFAULT_DATA_DIR = Path.home() / ".jigaido"

class Config:
    """JIGAIDO configuration with precedence: ENV > config file > defaults."""
    
    def __init__(self):
        self.data_dir: Path = self._resolve_data_dir()
        self.bot_token: Optional[str] = os.environ.get("JIGAIDO_BOT_TOKEN")
    
    def _resolve_data_dir(self) -> Path:
        # Priority: JIGAIDO_DATA_DIR env > config file > default ~/.jigaido
        env_dir = os.environ.get("JIGAIDO_DATA_DIR")
        if env_dir:
            return Path(env_dir)
        
        config_file = Path("~/.jigaido/config.json").expanduser()
        if config_file.exists():
            with open(config_file) as f:
                config_data = json.load(f)
                if "data_dir" in config_data:
                    return Path(config_data["data_dir"])
        
        return DEFAULT_DATA_DIR
    
    def ensure_data_dir(self) -> None:
        """Ensure the data directory exists."""
        self.data_dir.mkdir(parents=True, exist_ok=True)

# Global config instance
config = Config()

Config file format (`~/.jigaido/config.json`)

{
    "data_dir": "/path/to/custom/data/dir"
}

Environment Variables

JIGAIDO_DATA_DIR — Override data directory
JIGAIDO_BOT_TOKEN — Telegram bot token (used by telegram-bot app)

Acceptance Criteria

Config class loads with correct precedence (ENV > config file > default)
config.data_dir returns a valid Path
config.ensure_data_dir() creates directory if missing
Config file is created at ~/.jigaido/config.json

## Task 3: Create config.py — Configuration management **Labels:** phase-1, architecture **Dependency:** None — can start immediately (parallel with Task 1, 2) ### Goal Create centralized configuration management with file-based config and environment variable overrides. ### Files to create - `config.py` (at repo root) ### Implementation ```python """JIGAIDO Configuration Management.""" import json import os from pathlib import Path from typing import Optional # Default data directory DEFAULT_DATA_DIR = Path.home() / ".jigaido" class Config: """JIGAIDO configuration with precedence: ENV > config file > defaults.""" def __init__(self): self.data_dir: Path = self._resolve_data_dir() self.bot_token: Optional[str] = os.environ.get("JIGAIDO_BOT_TOKEN") def _resolve_data_dir(self) -> Path: # Priority: JIGAIDO_DATA_DIR env > config file > default ~/.jigaido env_dir = os.environ.get("JIGAIDO_DATA_DIR") if env_dir: return Path(env_dir) config_file = Path("~/.jigaido/config.json").expanduser() if config_file.exists(): with open(config_file) as f: config_data = json.load(f) if "data_dir" in config_data: return Path(config_data["data_dir"]) return DEFAULT_DATA_DIR def ensure_data_dir(self) -> None: """Ensure the data directory exists.""" self.data_dir.mkdir(parents=True, exist_ok=True) # Global config instance config = Config() ``` ### Config file format (`~/.jigaido/config.json`) ```json { "data_dir": "/path/to/custom/data/dir" } ``` ### Environment Variables - `JIGAIDO_DATA_DIR` — Override data directory - `JIGAIDO_BOT_TOKEN` — Telegram bot token (used by telegram-bot app) ### Acceptance Criteria - [ ] Config class loads with correct precedence (ENV > config file > default) - [ ] `config.data_dir` returns a valid Path - [ ] `config.ensure_data_dir()` creates directory if missing - [ ] Config file is created at `~/.jigaido/config.json`

shoko referenced this issue

2026-04-02 18:29:54 +02:00

[Phase 1] Task 4: Create core/services.py — Business logic #8

shoko referenced this issue

2026-04-02 18:30:59 +02:00

[Phase 1] Task 6: Create CLI (jigaido-cli) #10

shoko referenced this issue

2026-04-02 18:31:15 +02:00

[Phase 1] Task 6: Create CLI (jigaido-cli) #11

shoko referenced this issue

2026-04-02 18:32:56 +02:00

[Phase 1] Architecture Extraction — Full Hexagonal Architecture Refactor #17