Metadata-Version: 2.2
Name: sunsoft-utils
Version: 0.1.0
Summary: Shared utilities for Sunsoft packages
Home-page: https://github.com/greatbody/macpy-scripts
Author: greatbody
Author-email: sunruicode@gmail.com
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: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.32.3
Requires-Dist: termcolor>=2.3.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# sunsoft-utils

Shared utilities for Sunsoft packages.

## Installation

```bash
pip install sunsoft-utils
```

## Usage

### Download Tracking

```python
from sunsoft import send_first_run_stats

def main():
    # Send first run statistics
    send_first_run_stats(
        script_name='your-package-name',
        version='1.0.0'
    )

    # Your code here...
```

### Features

- Anonymous download tracking
- First-run detection
- Version tracking
- Support for `--no-track-install` flag
- Colored console output

### Configuration

The tracking data is stored in `~/.sunsoft.json` and includes:
- First run date
- Registration date
- Version information
- Installation status

## Requirements

- Python 3.8 or higher
- requests>=2.32.3
- termcolor>=2.3.0

## License

MIT License
