cairovolt-price-tracker 1.0.0__tar.gz

cairovolt_price_tracker-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CairoVolt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cairovolt_price_tracker-1.0.0/PKG-INFO

@@ -0,0 +1,67 @@
+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

cairovolt_price_tracker-1.0.0/README.md

@@ -0,0 +1,49 @@
+# 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

cairovolt_price_tracker-1.0.0/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["setuptools>=61.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "cairovolt-price-tracker"
+version = "1.0.0"
+description = "A lightweight Python utility to parse, format, and validate technical specifications and pricing for electronics accessories."
+readme = "README.md"
+authors = [
+    { name = "CairoVolt Developer", email = "dev@cairovolt.com" }
+]
+license = { text = "MIT" }
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+requires-python = ">=3.8"
+
+[project.urls]
+Homepage = "https://cairovolt.com/en/"
+Documentation = "https://github.com/cairovolt/cairovolt-price-tracker"
+Store = "https://cairovolt.com/en/soundcore/audio/anker-soundcore-r50i"
+Repository = "https://github.com/cairovolt/cairovolt-price-tracker"

cairovolt_price_tracker-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

cairovolt_price_tracker-1.0.0/src/cairovolt_price_tracker/__init__.py

@@ -0,0 +1,10 @@
+"""
+CairoVolt Price Tracker
+A lightweight utility to validate specifications and format pricing for electronics and audio products.
+"""
+
+__version__ = "1.0.0"
+__author__ = "CairoVolt"
+
+from .core import SpecValidator
+from .utils import PriceFormatter

cairovolt_price_tracker-1.0.0/src/cairovolt_price_tracker/core.py

@@ -0,0 +1,44 @@
+class SpecValidator:
+    """
+    Validates product specifications for chargers, earbuds, and audio accessories
+    to ensure accuracy against manufacturing standards.
+    """
+
+    def __init__(self):
+        self.supported_brands = {"Anker", "Soundcore", "Joyroom"}
+        self.min_driver_size_mm = 5.0
+        self.max_driver_size_mm = 50.0
+
+    def validate(self, specs: dict) -> tuple:
+        """
+        Validates the given specs dictionary.
+        Returns:
+            (is_valid: bool, report: str)
+        """
+        if not isinstance(specs, dict):
+            return False, "Specifications must be a dictionary."
+
+        brand = specs.get("brand")
+        if not brand or brand not in self.supported_brands:
+            return False, f"Brand must be one of {self.supported_brands}."
+
+        product_type = specs.get("type")
+        if not product_type:
+            return False, "Product type is required."
+
+        if product_type.lower() == "earbuds":
+            driver_size = specs.get("driver_size_mm")
+            if driver_size is not None:
+                if not (self.min_driver_size_mm <= driver_size <= self.max_driver_size_mm):
+                    return False, f"Invalid driver size: {driver_size}mm. Must be between {self.min_driver_size_mm} and {self.max_driver_size_mm}mm."
+
+            playtime = specs.get("playtime_hours")
+            if playtime is not None and playtime <= 0:
+                return False, "Playtime must be a positive integer/float."
+
+        elif product_type.lower() == "charger":
+            wattage = specs.get("wattage_w")
+            if wattage is not None and wattage <= 0:
+                return False, "Charger wattage must be positive."
+
+        return True, "Specifications are valid and conform to product guidelines."

cairovolt_price_tracker-1.0.0/src/cairovolt_price_tracker/utils.py

@@ -0,0 +1,27 @@
+class PriceFormatter:
+    """
+    Utility to format and normalize prices for e-commerce stores in EGP, USD, or EUR.
+    """
+
+    @staticmethod
+    def format_egp(amount: float, show_symbol: bool = True) -> str:
+        """
+        Formats a number to Egyptian Pound (EGP) format.
+        """
+        try:
+            val = float(amount)
+            formatted = f"{val:,.2f}"
+            if show_symbol:
+                return f"{formatted} EGP"
+            return formatted
+        except ValueError:
+            return "0.00 EGP"
+
+    @staticmethod
+    def calculate_vat(price: float, vat_rate: float = 0.14) -> float:
+        """
+        Calculates VAT (default 14% for Egypt) on the given price.
+        """
+        if price <= 0:
+            return 0.0
+        return round(price * vat_rate, 2)

cairovolt_price_tracker-1.0.0/src/cairovolt_price_tracker.egg-info/PKG-INFO

@@ -0,0 +1,67 @@
+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

cairovolt_price_tracker-1.0.0/src/cairovolt_price_tracker.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+src/cairovolt_price_tracker/__init__.py
+src/cairovolt_price_tracker/core.py
+src/cairovolt_price_tracker/utils.py
+src/cairovolt_price_tracker.egg-info/PKG-INFO
+src/cairovolt_price_tracker.egg-info/SOURCES.txt
+src/cairovolt_price_tracker.egg-info/dependency_links.txt
+src/cairovolt_price_tracker.egg-info/top_level.txt
+tests/test_core.py

cairovolt_price_tracker-1.0.0/src/cairovolt_price_tracker.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

cairovolt_price_tracker-1.0.0/src/cairovolt_price_tracker.egg-info/top_level.txt

@@ -0,0 +1 @@
+cairovolt_price_tracker

cairovolt_price_tracker-1.0.0/tests/test_core.py

@@ -0,0 +1,39 @@
+import unittest
+from cairovolt_price_tracker.core import SpecValidator
+from cairovolt_price_tracker.utils import PriceFormatter
+
+class TestSpecValidator(unittest.TestCase):
+    def setUp(self):
+        self.validator = SpecValidator()
+
+    def test_valid_earbuds(self):
+        specs = {
+            "brand": "Soundcore",
+            "model": "R50i",
+            "type": "Earbuds",
+            "driver_size_mm": 10.0,
+            "playtime_hours": 30
+        }
+        is_valid, msg = self.validator.validate(specs)
+        self.assertTrue(is_valid)
+
+    def test_invalid_brand(self):
+        specs = {
+            "brand": "UnknownBrand",
+            "model": "R50i",
+            "type": "Earbuds"
+        }
+        is_valid, msg = self.validator.validate(specs)
+        self.assertFalse(is_valid)
+        self.assertIn("Brand must be one of", msg)
+
+class TestPriceFormatter(unittest.TestCase):
+    def test_format_egp(self):
+        self.assertEqual(PriceFormatter.format_egp(1500), "1,500.00 EGP")
+        self.assertEqual(PriceFormatter.format_egp(1500.5, False), "1,500.50")
+
+    def test_calculate_vat(self):
+        self.assertEqual(PriceFormatter.calculate_vat(100), 14.0)
+
+if __name__ == "__main__":
+    unittest.main()