Metadata-Version: 2.4
Name: stackmate
Version: 0.1.0
Summary: A Full-Stack Development Toolkit for Python developers.
Author-email: Sudhakar K <sudhakark4227@gmail.com>
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PyJWT>=2.8.0
Requires-Dist: pydantic>=2.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: isort>=5.12.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Dynamic: license-file

# StackMate

**StackMate** is a production-ready Full-Stack Development Toolkit for Python developers. It provides essential utilities for building robust APIs, managing authentication, handling errors, and simplifying database operations.

## Features

- **Logger**: Structured request/response logging with latency tracking.
- **Validator**: API payload validation using type hints and schema checks.
- **DB Helper**: Generic CRUD utilities for SQL/NoSQL databases.
- **Auth**: Secure JWT token management (creation and verification).
- **Error Handler**: Standardized API response formatting.
- **Utils**: Common helper functions (UUIDs, timestamps, etc.).

## Installation

```bash
pip install stackmate
```

## Quick Start

```python
from stackmate.logger import AppLogger
from stackmate.auth import AuthManager

# Initialize components
logger = AppLogger("my-app")
auth = AuthManager(secret_key="your-secret-key")

# Use them in your application
token = auth.create_token({"user_id": 123})
```

## Project Structure

```text
stackmate/
├── stackmate/           # Core library files
├── examples/            # Example usage scripts
├── tests/               # Unit tests
├── pyproject.toml       # Build configuration
└── README.md            # Project documentation
```

## Author

- **Sudhakar K** - [sudhakark4227@gmail.com](mailto:sudhakark4227@gmail.com)

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
