Startup¶

def get_or_create(self) -> StartupVariables:
    """Retrieve the singleton StartupVariables record, creating if absent.

    Returns:
        StartupVariables: The singleton startup state entity.

    Note:
        This is a singleton entity - only one row should exist in the table.
        Creates with default values (welcome_popup_has_already_displayed=False) if missing.
    """
    logger.debug("Retrieving or creating StartupVariables singleton")
    vars = self.db.query(StartupVariables).first()

    if not vars:
        logger.info("StartupVariables not found, creating new record")
        vars = StartupVariables(welcome_popup_has_already_displayed=False)
        self.db.add(vars)
        self.db.flush()
        self.db.refresh(vars)
        logger.info(f"Created StartupVariables {vars.id}")

    return vars

def get_welcome_popup_status(self) -> bool:
    """Check if welcome popup has already been displayed to user.

    Returns:
        bool: True if popup was already shown, False if first time.
    """
    logger.debug("Checking welcome popup display status")
    vars = self.get_or_create()
    return vars.welcome_popup_has_already_displayed

def mark_welcome_popup_displayed(self, vars: StartupVariables) -> StartupVariables:
    """Mark welcome popup as displayed (set flag to True).

    Args:
        vars: StartupVariables entity to update.

    Returns:
        StartupVariables: Updated entity (not yet committed, use flush()).
    """
    logger.info("Marking welcome popup as displayed")
    vars.welcome_popup_has_already_displayed = True
    self.db.flush()
    self.db.refresh(vars)
    return vars

def reset(self, vars: StartupVariables) -> StartupVariables:
    """Reset all startup variables to default values.

    Args:
        vars: StartupVariables entity to reset.

    Returns:
        StartupVariables: Reset entity (not yet committed, use flush()).
    """
    logger.info("Resetting StartupVariables to defaults")
    vars.welcome_popup_has_already_displayed = False
    self.db.flush()
    self.db.refresh(vars)
    return vars

def update_field(self, vars: StartupVariables, field: str, value) -> StartupVariables:
    """Update a specific field on the StartupVariables entity.

    Args:
        vars: StartupVariables entity to update.
        field: Name of the field to update.
        value: New value for the field.

    Returns:
        StartupVariables: Updated entity (not yet committed, use flush()).

    Raises:
        AttributeError: If field does not exist on entity.
    """
    logger.info(f"Updating StartupVariables field: {field} = {value}")
    if not hasattr(vars, field):
        raise AttributeError(f"StartupVariables has no field '{field}'")

    setattr(vars, field, value)
    self.db.flush()
    self.db.refresh(vars)
    return vars