Metadata-Version: 2.4
Name: powerpulse-core
Version: 0.0.1
Summary: Core PowerPulse SDK providing AWS integrations, caching, logging, and validation utilities for Django-based energy monitoring systems.
Home-page: https://github.com/madhupandhare/powerpulse-core
Author: Madhu Pandhare
Author-email: madhupandhare259@gmail.com
License: MIT
Keywords: aws django dynamodb cognito s3 sns sqs lambda cloud9 energy-monitoring analytics
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.9
Classifier: Framework :: Django
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: requires-python
Dynamic: summary

# ⚡ PowerPulse Core

**PowerPulse Core** is a modular Python library designed for real-time **energy monitoring and analytics platforms**.  
It provides AWS-integrated utility functions to streamline development of Django and serverless applications on AWS.

---

## 🚀 Features

- 🔐 **AWS Credential Auto-Detection**
  - Works seamlessly in **AWS Cloud9**, local, or production with IAM roles.
- 💾 **DynamoDB Resource Manager**
  - Built-in resource and client access with retry logic.
- 📡 **AWS Service Clients**
  - Preconfigured clients for **S3**, **SQS**, **SNS**, **Lambda**, **Cognito**, and **IoT Data**.
- ⚙️ **Smart Caching**
  - Lightweight thread-safe cache with TTL and decorators.
- 🧩 **Structured Logging**
  - Unified AWS and app-level logging via `PowerPulseLogger`.
- 🔍 **Validators**
  - Email, phone, and energy reading validation utilities.
- 🕒 **Utilities**
  - Timestamp formatting, ID generation, and JSON-safe DynamoDB item serialization.

---

## 🧰 Installation

You can install the library directly using `pip`:

```bash
pip install powerpulse-core
