App Data

Application data directory management and user profile storage with Pydantic models and filesystem-based persistence.

Overview

vcti-app-data provides two components for managing application state on disk. AppDataDirectory is a context manager that creates and scopes operations to an application data directory. ProfileManager handles CRUD operations for named user profiles, each stored as a JSON file in its own directory, with active profile tracking and a default profile that cannot be deleted.

Installation

pip install vcti-app-data>=1.0.0

Quick Start

Application data directory

from vcti.app_data import AppDataDirectory

with AppDataDirectory("~/.config/my_app").context() as ctx:
    # Working directory is now ~/.config/my_app (created if needed)
    (ctx.path / "config.json").write_text('{"theme": "dark"}')
# Original working directory restored on exit

Profile management

from vcti.app_data import ProfileManager

mgr = ProfileManager("~/.config/my_app/profiles")

# Default profile created automatically
mgr.create_profile("dev", name="Development", tags=["dev"])
mgr.create_profile("prod", name="Production", attributes={"region": "us-east"})

mgr.set_active_profile("dev")
print(mgr.get_active_profile())  # "dev"

for profile in mgr.list_profiles():
    print(f"{profile.id}: {profile.info.name}")

mgr.delete_profile("prod")
# Deleting the active profile resets to default

Core API

AppDataDirectory

ProfileManager

Pydantic Models

Dependencies

• pydantic (>=2.0) — data validation and JSON serialization