Metadata-Version: 2.4
Name: cairovolt-price-tracker
Version: 1.0.0
Summary: A lightweight Python utility to parse, format, and validate technical specifications and pricing for electronics accessories.
Author-email: CairoVolt Developer <dev@cairovolt.com>
License: MIT
Project-URL: Homepage, https://cairovolt.com/en/
Project-URL: Documentation, https://github.com/cairovolt/cairovolt-price-tracker
Project-URL: Store, https://cairovolt.com/en/soundcore/audio/anker-soundcore-r50i
Project-URL: Repository, https://github.com/cairovolt/cairovolt-price-tracker
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# CairoVolt Price Tracker

A lightweight Python library to parse, format, and validate technical specifications and pricing structures for electronics and audio accessories.

This library was built by [CairoVolt](https://cairovolt.com/en/) to automate stock synchronization and spec validation for online WooCommerce shops. For more details on running a web store, see the [WooCommerce Wikipedia page](https://en.wikipedia.org/wiki/WooCommerce).

## Features

- **Price Formatting**: Easily format currency in EGP, USD, or EUR.
- **Specification Validation**: Validate charger wattages, battery capacities, and Bluetooth profiles.
- **Data Export**: Export structured JSON specifications for platforms like [Anker](https://www.anker.com) and [Soundcore](https://www.soundcore.com) devices.

## Installation

```bash
pip install cairovolt-price-tracker
```

## Usage

Here is a quick example of how to validate the specifications of a popular earbuds model like [soundcore r50i](https://cairovolt.com/en/soundcore/audio/anker-soundcore-r50i):

```python
from cairovolt_price_tracker.core import SpecValidator

# Initialize validator
validator = SpecValidator()

# Define product specs
product_specs = {
    "brand": "Soundcore",
    "model": "R50i",
    "type": "Earbuds",
    "driver_size_mm": 10,
    "playtime_hours": 30,
    "bluetooth_version": "5.3"
}

# Validate specs
is_valid, report = validator.validate(product_specs)
print(f"Is valid: {is_valid}")
print(report)
```

For guidelines on packaging similar Python projects, check the [Python Packaging User Guide](https://packaging.python.org/en/latest/).

## License

MIT
