Home Information - Your home, your data, organized.
Python
import time
from .constants import (
VIEW_INTRO_HELP_SESSION_KEY,
VIEW_INTRO_HELP_DURATION_SECONDS,
EDIT_INTRO_HELP_SESSION_KEY,
EDIT_INTRO_HELP_DURATION_SECONDS,
EDIT_MODE_ENTRY_COUNT_KEY,
)
def mark_profile_initialized(request):
"""Called when a profile is initialized to start view mode help timer."""
request.session[VIEW_INTRO_HELP_SESSION_KEY] = time.time()
def mark_first_location_created(request):
"""Called when first location created (when no predefined profile flow is chosen)."""
request.session[VIEW_INTRO_HELP_SESSION_KEY] = time.time()
request.session[EDIT_INTRO_HELP_SESSION_KEY] = time.time()
request.session[EDIT_MODE_ENTRY_COUNT_KEY] = 1
def mark_edit_mode_entry(request):
"""
Called when entering edit mode.
Only tracks if this is the same session that initialized the profile.
"""
if VIEW_INTRO_HELP_SESSION_KEY not in request.session:
return
count = request.session.get(EDIT_MODE_ENTRY_COUNT_KEY, 0)
if count == 0:
request.session[EDIT_INTRO_HELP_SESSION_KEY] = time.time()
request.session[EDIT_MODE_ENTRY_COUNT_KEY] = count + 1
def dismiss_view_intro_help(request):
"""Dismiss view mode help early by removing the session timestamp."""
request.session.pop(VIEW_INTRO_HELP_SESSION_KEY, None)
def should_show_view_intro_help(request):
timestamp = request.session.get(VIEW_INTRO_HELP_SESSION_KEY)
if not timestamp:
return False
return (time.time() - timestamp) < VIEW_INTRO_HELP_DURATION_SECONDS
def should_show_edit_intro_help(request):
"""
Check if edit mode help should be shown.
Only shows if:
1. We're in the same session that initialized the profile
2. This is the first edit mode entry
3. We're still within the time window
"""
if VIEW_INTRO_HELP_SESSION_KEY not in request.session:
return False
timestamp = request.session.get(EDIT_INTRO_HELP_SESSION_KEY)
if not timestamp:
return False
return (time.time() - timestamp) < EDIT_INTRO_HELP_DURATION_SECONDS