How to Design a Cloud Data Helper Class in Python

import json
from pathlib import Path
from datetime import datetime


class CloudDataHelper:
    """Beginner-friendly helper for working with cloud-based JSON data."""

    def __init__(self, base_dir="cloud_data"):
        self.base_dir = Path(base_dir)
        self.base_dir.mkdir(exist_ok=True)

    def save_record(self, record: dict, filename: str) -> Path:
        """Save a record to a JSON file with timestamp."""
        filepath = self.base_dir / f"{filename}_{datetime.now():%Y%m%d_%H%M%S}.json"
        filepath.write_text(json.dumps(record, indent=2))
        return filepath

    def load_records(self, prefix: str) -> list:
        """Load all JSON records with given prefix."""
        records = []
        for filepath in self.base_dir.glob(f"{prefix}_*.json"):
            records.append(json.loads(filepath.read_text()))
        return records

    def aggregate(self, records: list, key: str) -> dict:
        """Count occurrences of each value for a given key."""
        counts = {}
        for record in records:
            value = record.get(key, "unknown")
            counts[value] = counts.get(value, 0) + 1
        return counts


if __name__ == "__main__":
    helper = CloudDataHelper()

    helper.save_record({"user": "alice", "plan": "free", "region": "us-east"}, "user")
    helper.save_record({"user": "bob", "plan": "pro", "region": "eu-west"}, "user")
    helper.save_record({"user": "carol", "plan": "free", "region": "us-east"}, "user")

    all_users = helper.load_records("user")
    plan_counts = helper.aggregate(all_users, "plan")

    print(f"Loaded {len(all_users)} user records")
    print(f"Plan distribution: {plan_counts}")