Konfigurationsmodul¶

config ¶

Configuration management for Weeb CLI.

This module provides a centralized configuration system that stores settings in a SQLite database with fallback to default values. Supports both interactive and headless (API) modes.

Configuration is stored persistently in the database and can be accessed throughout the application using the global config instance.

Example

Basic usage::

from weeb_cli.config import config

# Get configuration value
download_dir = config.get("download_dir")
aria2_enabled = config.get("aria2_enabled", True)

# Set configuration value
config.set("language", "tr")

# Enable headless mode (no database access)
config.set_headless(True)

Attributes:

Name	Type	Description
`APP_NAME`	`str`	Application name for directory naming.
`CONFIG_DIR`	`Path`	User configuration directory (~/.weeb-cli).
`DEFAULT_CONFIG`	`dict`	Default configuration values.
`config`	`Config`	Global configuration instance.

Config ¶

Configuration manager with database persistence.

Provides a simple key-value interface for application settings with automatic persistence to SQLite database. Supports headless mode for API usage without database access.

Attributes:

Name	Type	Description
`_db`	`Optional[Database]`	Lazy-loaded database instance.
`_headless`	`bool`	Whether running in headless mode (no database).

Source code in weeb_cli/config.py

class Config:
    """Configuration manager with database persistence.

    Provides a simple key-value interface for application settings with
    automatic persistence to SQLite database. Supports headless mode for
    API usage without database access.

    Attributes:
        _db (Optional[Database]): Lazy-loaded database instance.
        _headless (bool): Whether running in headless mode (no database).
    """

    def __init__(self) -> None:
        """Initialize configuration manager."""
        self._db: Optional['Database'] = None
        self._headless: bool = False

    @property
    def db(self) -> 'Database':
        """Get database instance with lazy loading.

        Returns:
            Database instance for configuration storage.
        """
        if self._db is None:
            from weeb_cli.services.database import db
            self._db = db
        return self._db

    def get(self, key: str, default: Optional[Any] = None) -> Any:
        """Get configuration value by key.

        Attempts to retrieve value from database first, then falls back to
        provided default or DEFAULT_CONFIG. Special handling for download_dir
        to generate localized default path.

        Args:
            key: Configuration key name.
            default: Default value if key not found in database.

        Returns:
            Configuration value, default, or None.

        Example:
            >>> config.get("language", "en")
            "tr"
            >>> config.get("aria2_max_connections")
            16
        """
        if not self._headless:
            try:
                val = self.db.get_config(key)
                if val is not None:
                    return val
            except Exception:
                # Avoid circular import with logger, just pass silently
                pass

        # Special handling for download_dir
        if key == "download_dir":
            return default if default is not None else get_default_download_dir()

        # Use provided default, fallback to DEFAULT_CONFIG, then None
        if default is not None:
            return default
        return DEFAULT_CONFIG.get(key)

    def set(self, key: str, value: Any) -> None:
        """Set configuration value.

        Persists the value to database for future retrieval.

        Args:
            key: Configuration key name.
            value: Value to store (must be JSON-serializable).

        Example:
            >>> config.set("language", "tr")
            >>> config.set("aria2_max_connections", 32)
        """
        self.db.set_config(key, value)

    def set_headless(self, headless: bool = True) -> None:
        """Enable or disable headless mode.

        In headless mode, configuration is read from DEFAULT_CONFIG only,
        without database access. Useful for API commands and testing.

        Args:
            headless: Whether to enable headless mode.
        """
        self._headless = headless

db `property` ¶

db: Database

Get database instance with lazy loading.

Returns:

Type	Description
`Database`	Database instance for configuration storage.

init ¶

__init__() -> None

Initialize configuration manager.

Source code in weeb_cli/config.py

def __init__(self) -> None:
    """Initialize configuration manager."""
    self._db: Optional['Database'] = None
    self._headless: bool = False

get ¶

get(key: str, default: Optional[Any] = None) -> Any

Get configuration value by key.

Attempts to retrieve value from database first, then falls back to provided default or DEFAULT_CONFIG. Special handling for download_dir to generate localized default path.

Parameters:

Name	Type	Description	Default
`key`	`str`	Configuration key name.	required
`default`	`Optional[Any]`	Default value if key not found in database.	`None`

Returns:

Type	Description
`Any`	Configuration value, default, or None.

Example

config.get("language", "en") "tr" config.get("aria2_max_connections") 16

Source code in weeb_cli/config.py

def get(self, key: str, default: Optional[Any] = None) -> Any:
    """Get configuration value by key.

    Attempts to retrieve value from database first, then falls back to
    provided default or DEFAULT_CONFIG. Special handling for download_dir
    to generate localized default path.

    Args:
        key: Configuration key name.
        default: Default value if key not found in database.

    Returns:
        Configuration value, default, or None.

    Example:
        >>> config.get("language", "en")
        "tr"
        >>> config.get("aria2_max_connections")
        16
    """
    if not self._headless:
        try:
            val = self.db.get_config(key)
            if val is not None:
                return val
        except Exception:
            # Avoid circular import with logger, just pass silently
            pass

    # Special handling for download_dir
    if key == "download_dir":
        return default if default is not None else get_default_download_dir()

    # Use provided default, fallback to DEFAULT_CONFIG, then None
    if default is not None:
        return default
    return DEFAULT_CONFIG.get(key)

set ¶

set(key: str, value: Any) -> None

Set configuration value.

Persists the value to database for future retrieval.

Parameters:

Name	Type	Description	Default
`key`	`str`	Configuration key name.	required
`value`	`Any`	Value to store (must be JSON-serializable).	required

Example

config.set("language", "tr") config.set("aria2_max_connections", 32)

Source code in weeb_cli/config.py

def set(self, key: str, value: Any) -> None:
    """Set configuration value.

    Persists the value to database for future retrieval.

    Args:
        key: Configuration key name.
        value: Value to store (must be JSON-serializable).

    Example:
        >>> config.set("language", "tr")
        >>> config.set("aria2_max_connections", 32)
    """
    self.db.set_config(key, value)

set_headless ¶

set_headless(headless: bool = True) -> None

Enable or disable headless mode.

In headless mode, configuration is read from DEFAULT_CONFIG only, without database access. Useful for API commands and testing.

Parameters:

Name	Type	Description	Default
`headless`	`bool`	Whether to enable headless mode.	`True`

Source code in weeb_cli/config.py

def set_headless(self, headless: bool = True) -> None:
    """Enable or disable headless mode.

    In headless mode, configuration is read from DEFAULT_CONFIG only,
    without database access. Useful for API commands and testing.

    Args:
        headless: Whether to enable headless mode.
    """
    self._headless = headless

get_default_download_dir ¶

get_default_download_dir() -> str

Get the default download directory path.

Uses localized folder name from i18n translations.

Returns:

Type	Description
`str`	Absolute path to default download directory in current working directory.

Source code in weeb_cli/config.py

def get_default_download_dir() -> str:
    """Get the default download directory path.

    Uses localized folder name from i18n translations.

    Returns:
        Absolute path to default download directory in current working directory.
    """
    from weeb_cli.i18n import i18n

    folder_name = i18n.t("downloads.default_folder_name", "weeb-downloads")
    return os.path.join(os.getcwd(), folder_name)

Übersicht¶

Das Konfigurationsmodul bietet zentralisierte Einstellungsverwaltung für Weeb CLI. Alle Konfiguration wird in einer SQLite-Datenbank mit Fallback auf sinnvolle Standardwerte gespeichert.

Verwendungsbeispiele¶

Konfigurationswerte abrufen¶

from weeb_cli.config import config

# Mit Standard-Fallback abrufen
language = config.get("language", "en")
download_dir = config.get("download_dir")
aria2_enabled = config.get("aria2_enabled", True)

Konfigurationswerte setzen¶

from weeb_cli.config import config

# Sprache setzen
config.set("language", "tr")

# Download-Verzeichnis setzen
config.set("download_dir", "/pfad/zu/downloads")

# Features aktivieren/deaktivieren
config.set("discord_rpc_enabled", False)

Headless-Modus¶

Für API-Nutzung ohne Datenbankzugriff:

from weeb_cli.config import config

# Headless-Modus aktivieren
config.set_headless(True)

# Jetzt gibt config.get() nur DEFAULT_CONFIG-Werte zurück
language = config.get("language")  # Gibt None zurück (Standard)

Standardkonfiguration¶

Die folgenden Standardwerte werden verwendet, wenn kein Datenbankwert existiert:

Schlüssel	Standardwert	Beschreibung
`language`	`None`	UI-Sprache (tr, en, de, pl)
`aria2_enabled`	`True`	Aria2 für Downloads aktivieren
`ytdlp_enabled`	`True`	yt-dlp für Downloads aktivieren
`aria2_max_connections`	`16`	Max. Verbindungen pro Download
`max_concurrent_downloads`	`3`	Max. gleichzeitige Downloads
`download_dir`	`None`	Download-Verzeichnispfad
`ytdlp_format`	`"bestvideo+bestaudio/best"`	yt-dlp-Format-String
`scraping_source`	`None`	Standard-Provider
`show_description`	`True`	Anime-Beschreibungen anzeigen
`debug_mode`	`False`	Debug-Protokollierung aktivieren
`download_max_retries`	`3`	Download-Wiederholungsversuche
`download_retry_delay`	`10`	Verzögerung zwischen Wiederholungen (Sekunden)
`discord_rpc_enabled`	`True`	Discord Rich Presence aktivieren
`shortcuts_enabled`	`False`	Tastaturkürzel aktivieren

Konfigurationsverzeichnis¶

Konfiguration und Daten werden gespeichert in:

~/.weeb-cli/
├── weeb.db          # SQLite-Datenbank
├── cache/           # Zwischengespeicherte Daten
├── bin/             # Heruntergeladene Abhängigkeiten
└── logs/            # Debug-Protokolle

API-Referenz¶

Configuration manager with database persistence.

Provides a simple key-value interface for application settings with automatic persistence to SQLite database. Supports headless mode for API usage without database access.

Attributes:

Name	Type	Description
`_db`	`Optional[Database]`	Lazy-loaded database instance.
`_headless`	`bool`	Whether running in headless mode (no database).

Source code in weeb_cli/config.py

class Config:
    """Configuration manager with database persistence.

    Provides a simple key-value interface for application settings with
    automatic persistence to SQLite database. Supports headless mode for
    API usage without database access.

    Attributes:
        _db (Optional[Database]): Lazy-loaded database instance.
        _headless (bool): Whether running in headless mode (no database).
    """

    def __init__(self) -> None:
        """Initialize configuration manager."""
        self._db: Optional['Database'] = None
        self._headless: bool = False

    @property
    def db(self) -> 'Database':
        """Get database instance with lazy loading.

        Returns:
            Database instance for configuration storage.
        """
        if self._db is None:
            from weeb_cli.services.database import db
            self._db = db
        return self._db

    def get(self, key: str, default: Optional[Any] = None) -> Any:
        """Get configuration value by key.

        Attempts to retrieve value from database first, then falls back to
        provided default or DEFAULT_CONFIG. Special handling for download_dir
        to generate localized default path.

        Args:
            key: Configuration key name.
            default: Default value if key not found in database.

        Returns:
            Configuration value, default, or None.

        Example:
            >>> config.get("language", "en")
            "tr"
            >>> config.get("aria2_max_connections")
            16
        """
        if not self._headless:
            try:
                val = self.db.get_config(key)
                if val is not None:
                    return val
            except Exception:
                # Avoid circular import with logger, just pass silently
                pass

        # Special handling for download_dir
        if key == "download_dir":
            return default if default is not None else get_default_download_dir()

        # Use provided default, fallback to DEFAULT_CONFIG, then None
        if default is not None:
            return default
        return DEFAULT_CONFIG.get(key)

    def set(self, key: str, value: Any) -> None:
        """Set configuration value.

        Persists the value to database for future retrieval.

        Args:
            key: Configuration key name.
            value: Value to store (must be JSON-serializable).

        Example:
            >>> config.set("language", "tr")
            >>> config.set("aria2_max_connections", 32)
        """
        self.db.set_config(key, value)

    def set_headless(self, headless: bool = True) -> None:
        """Enable or disable headless mode.

        In headless mode, configuration is read from DEFAULT_CONFIG only,
        without database access. Useful for API commands and testing.

        Args:
            headless: Whether to enable headless mode.
        """
        self._headless = headless

get ¶

get(key: str, default: Optional[Any] = None) -> Any

Get configuration value by key.

Attempts to retrieve value from database first, then falls back to provided default or DEFAULT_CONFIG. Special handling for download_dir to generate localized default path.

Parameters:

Name	Type	Description	Default
`key`	`str`	Configuration key name.	required
`default`	`Optional[Any]`	Default value if key not found in database.	`None`

Returns:

Type	Description
`Any`	Configuration value, default, or None.

Example

config.get("language", "en") "tr" config.get("aria2_max_connections") 16

Source code in weeb_cli/config.py

def get(self, key: str, default: Optional[Any] = None) -> Any:
    """Get configuration value by key.

    Attempts to retrieve value from database first, then falls back to
    provided default or DEFAULT_CONFIG. Special handling for download_dir
    to generate localized default path.

    Args:
        key: Configuration key name.
        default: Default value if key not found in database.

    Returns:
        Configuration value, default, or None.

    Example:
        >>> config.get("language", "en")
        "tr"
        >>> config.get("aria2_max_connections")
        16
    """
    if not self._headless:
        try:
            val = self.db.get_config(key)
            if val is not None:
                return val
        except Exception:
            # Avoid circular import with logger, just pass silently
            pass

    # Special handling for download_dir
    if key == "download_dir":
        return default if default is not None else get_default_download_dir()

    # Use provided default, fallback to DEFAULT_CONFIG, then None
    if default is not None:
        return default
    return DEFAULT_CONFIG.get(key)

set ¶

set(key: str, value: Any) -> None

Set configuration value.

Persists the value to database for future retrieval.

Parameters:

Name	Type	Description	Default
`key`	`str`	Configuration key name.	required
`value`	`Any`	Value to store (must be JSON-serializable).	required

Example

config.set("language", "tr") config.set("aria2_max_connections", 32)

Source code in weeb_cli/config.py

def set(self, key: str, value: Any) -> None:
    """Set configuration value.

    Persists the value to database for future retrieval.

    Args:
        key: Configuration key name.
        value: Value to store (must be JSON-serializable).

    Example:
        >>> config.set("language", "tr")
        >>> config.set("aria2_max_connections", 32)
    """
    self.db.set_config(key, value)

set_headless ¶

set_headless(headless: bool = True) -> None

Enable or disable headless mode.

In headless mode, configuration is read from DEFAULT_CONFIG only, without database access. Useful for API commands and testing.

Parameters:

Name	Type	Description	Default
`headless`	`bool`	Whether to enable headless mode.	`True`

Source code in weeb_cli/config.py

def set_headless(self, headless: bool = True) -> None:
    """Enable or disable headless mode.

    In headless mode, configuration is read from DEFAULT_CONFIG only,
    without database access. Useful for API commands and testing.

    Args:
        headless: Whether to enable headless mode.
    """
    self._headless = headless

Konfigurationsmodul¶

config ¶

Config ¶

db property ¶

__init__ ¶

get ¶

set ¶

set_headless ¶

get_default_download_dir ¶

Übersicht¶

Verwendungsbeispiele¶

Konfigurationswerte abrufen¶

Konfigurationswerte setzen¶

Headless-Modus¶

Standardkonfiguration¶

Konfigurationsverzeichnis¶

API-Referenz¶

get ¶

set ¶

set_headless ¶

db `property` ¶

init ¶