notify-utils 0.0.1__py3-none-any.whl

notify_utils-0.0.1.dist-info/METADATA

@@ -0,0 +1,133 @@
+Metadata-Version: 2.4
+Name: notify-utils
+Version: 0.0.1
+Summary: Biblioteca Python para parsing de preços de scraping, cálculo de descontos e análise estatística de histórico de preços.
+Author-email: Naruto Uzumaki <naruto_uzumaki@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/jefersonAlbara/notify-utils
+Project-URL: Repository, https://github.com/jefersonAlbara/notify-utils
+Project-URL: Issues, https://github.com/jefersonAlbara/notify-utils/issues
+Keywords: price-tracking,discount-calculator,web-scraping,e-commerce,price-history,discount-analysis,promotion-detection,statistics
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Office/Business :: Financial
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: discord-webhook>=1.4.1
+Dynamic: license-file
+
+# notify-utils
+
+Biblioteca Python para parsing de preços de scraping, cálculo de descontos e análise estatística de histórico de preços.
+
+## Funcionalidades
+
+- **Parser de Preços**: Normaliza strings de preços de diferentes formatos (BR, US)
+- **Cálculo de Descontos**: Detecta descontos reais vs anunciados usando histórico
+- **Análise Estatística**: Média, mediana, tendências e volatilidade de preços
+- **Validação de Preços**: Sistema inteligente para validar preços antes de adicionar ao histórico
+- **Notificações Discord**: Envio de alertas de preço via webhook (opcional)
+
+## Instalação
+
+```bash
+pip install notify-utils
+```
+
+## Uso Básico
+
+### Parsing de Preços
+
+```python
+from notify_utils import parse_price
+
+preco = parse_price("R$ 1.299,90")  # → 1299.90
+preco = parse_price("$1,299.90")    # → 1299.90
+```
+
+### Cálculo de Desconto com Histórico
+
+```python
+from notify_utils import Price, get_discount_info
+from datetime import datetime, timedelta
+
+# Histórico de preços
+precos = [
+    Price(value=1299.90, date=datetime.now() - timedelta(days=60)),
+    Price(value=1199.90, date=datetime.now() - timedelta(days=30)),
+]
+
+# Calcular desconto real baseado no histórico
+info = get_discount_info(
+    current_price=899.90,
+    price_history=precos,
+    period_days=30
+)
+
+print(f"Desconto real: {info.discount_percentage:.2f}%")
+print(f"É desconto real? {info.is_real_discount}")
+```
+
+### Análise de Tendência
+
+```python
+from notify_utils import calculate_price_trend
+
+trend = calculate_price_trend(precos, days=30)
+
+print(f"Direção: {trend.direction}")  # 'increasing', 'decreasing', 'stable'
+print(f"Mudança: {trend.change_percentage:.2f}%")
+print(f"Confiança: {trend.confidence}")
+```
+
+### Validação de Preços
+
+```python
+from notify_utils import PriceHistory, Price, PriceAdditionStrategy
+
+history = PriceHistory(product_id="PROD123", prices=precos)
+
+# Validar antes de adicionar
+novo_preco = Price(value=899.90, date=datetime.now())
+result = history.add_price(
+    novo_preco,
+    strategy=PriceAdditionStrategy.SMART
+)
+
+if result.action.value == "added":
+    print(f"Preço adicionado: R$ {result.affected_price.value:.2f}")
+```
+
+### Notificações Discord
+
+```python
+from notify_utils import Product, DiscordEmbedBuilder
+
+produto = Product(
+    product_id="PROD123",
+    name="Notebook Gamer",
+    url="https://loja.com/produto"
+)
+
+builder = DiscordEmbedBuilder()
+embed = builder.build_embed(produto, info, precos)
+# Enviar via webhook Discord
+```
+
+## Documentação Completa
+
+Para mais detalhes, consulte o arquivo [CLAUDE.md](CLAUDE.md) na raiz do projeto.
+
+## Requisitos
+
+- Python >= 3.12
+- discord-webhook >= 1.4.1 (opcional, apenas para notificações)
+
+## Licença
+
+MIT

notify_utils-0.0.1.dist-info/RECORD

@@ -0,0 +1,14 @@
+notify_utils/__init__.py,sha256=ebhDsS5auEWFGobvgDkUIQa3lTBT1Ykz6wUvEz1NF14,2034
+notify_utils/discount.py,sha256=tIjifk7OkQEcLCXaHeY7QIAQyy1f_6FF4srusHyfTHw,12975
+notify_utils/models.py,sha256=jRNZjVyXorMzA5sZUfU3M4IICzZhuOlmCOB793skuLo,19361
+notify_utils/parser.py,sha256=IgEnClPQAOiAftkIVgQelIlSwDQvIFGIROWhOTiICbI,3191
+notify_utils/statistics.py,sha256=-ggrNiF3LnC-SN6tgXrsijk9k2V8h1vP8GoXp-v5yZU,10390
+notify_utils/validators.py,sha256=oa9fgTWVb1iKJmMgUpFGy8lMmMeggd9BvEkmeN5jOVc,2383
+notify_utils/notifiers/__init__.py,sha256=sWDgtEYr7fSzWt7JcXnGnWW5GCFsvr9OfIJ_87IYOOQ,290
+notify_utils/notifiers/discord_notifier.py,sha256=05w7e4IrxMlB-HnqsLSrLn9La-yHqeG72jpTGWTo8Jc,3640
+notify_utils/notifiers/formatters.py,sha256=OH81_ibaUW5F9QezWxlZyUblYkO0SYAtuttFZPFNhdo,2928
+notify_utils-0.0.1.dist-info/licenses/LICENSE,sha256=EAGnUR97L4E41x_9rLn8R8tVXrJrWFRt4gbaWNpKg54,1071
+notify_utils-0.0.1.dist-info/METADATA,sha256=pm80DurbFJkj4ylu6sCMlLnIN_rtcnmutGPwCQvBjug,3986
+notify_utils-0.0.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+notify_utils-0.0.1.dist-info/top_level.txt,sha256=FAuoT6qfsWZmQUxWC3kbB-5yLQONkFW-HWdfAwVXGGY,13
+notify_utils-0.0.1.dist-info/RECORD,,

notify_utils-0.0.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

notify_utils-0.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Naruto Uzumaki
+
+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.

notify_utils-0.0.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+notify_utils