Metadata-Version: 2.4
Name: AppDataManager
Version: 1.0.0
Summary: Zero-config user data manager - manage application data like a dictionary, automatically saved to system user directory
License: MIT
License-File: LICENSE
Keywords: app,data,storage,config,localdata,appdata,persistence,settings
Author: qiufeng
Author-email: appleidqiufeng@outlook.com
Requires-Python: >=3.8,<4.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Filesystems
Project-URL: Changelog, https://github.com/qiufengcute/AppDataManager/blob/main/CHANGELOG.md
Project-URL: Homepage, https://github.com/qiufengcute/AppDataManager
Project-URL: Repository, https://github.com/qiufengcute/AppDataManager
Description-Content-Type: text/markdown

# AppDataManager

[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/downloads/)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![Version](https://img.shields.io/pypi/v/AppDataManager.svg)]()
[![Download](https://img.shields.io/pypi/dm/AppDataManager.svg)]()

**Zero-config user data manager** - Manage application data like a dictionary, automatically saved to system user directory.

## Features

- 🚀 **Zero dependencies** - Only Python standard library
- 📁 **Automatic paths** - Auto-saved to system user directory
- 🐍 **Pythonic** - Dict-like and attribute-like access
- 🔒 **Namespace isolation** - Multiple apps don't interfere
- ✨ **Simple & intuitive** - No configuration needed

## Installation

```bash
pip install AppDataManager
```

## Quick Start

```python
from AppDataManager import AppDataManager

# Create manager
dm = AppDataManager("myapp")

# Dict-style access
dm["config.json"] = '{"theme": "dark"}'
print(dm["config.json"])

# Attribute-style access
dm.setting = "enabled"
print(dm.setting)

# Iterate all data
for key in dm:
    print(f"{key}: {dm[key]}")

# Check existence
if "config.json" in dm:
    print("Config exists")

# Delete
del dm.setting

# Count
print(f"Total: {len(dm)} files")
```

## Storage Locations

- **Windows**: `%LOCALAPPDATA%\<namespace>`
- **macOS**: `~/Library/Application Support/<namespace>`
- **Linux**: `~/.local/share/<namespace>`
