Metadata-Version: 2.4
Name: storm-logger
Version: 2.0.0
Summary: Enterprise-grade logging system with business intelligence for Storm Development
Author-email: Storm Development Team <development@stormdevelopment.com>
Maintainer-email: Storm Development Team <development@stormdevelopment.com>
License-Expression: GPL-2.0-only
Project-URL: Homepage, https://stormdevelopment.com
Project-URL: Documentation, https://docs.stormdevelopment.com/storm-logger
Project-URL: Repository, https://github.com/storm-development/storm-logger
Project-URL: Bug Tracker, https://github.com/storm-development/storm-logger/issues
Project-URL: Changelog, https://github.com/storm-development/storm-logger/blob/main/CHANGELOG.md
Keywords: logging,business-intelligence,django,enterprise,storm
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Logging
Classifier: Topic :: Office/Business
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: rich>=13.0.0
Requires-Dist: colorama>=0.4.6
Requires-Dist: typing-extensions>=4.0.0
Provides-Extra: django
Requires-Dist: django>=4.0; extra == "django"
Provides-Extra: flask
Requires-Dist: flask>=2.0; extra == "flask"
Provides-Extra: fastapi
Requires-Dist: fastapi>=0.68.0; extra == "fastapi"
Provides-Extra: enhanced
Requires-Dist: colorlog>=6.7.0; extra == "enhanced"
Requires-Dist: python-json-logger>=2.0.7; extra == "enhanced"
Provides-Extra: security
Requires-Dist: cryptography>=3.4.8; extra == "security"
Provides-Extra: cloud
Requires-Dist: boto3>=1.26.0; extra == "cloud"
Requires-Dist: azure-monitor-opentelemetry>=1.0.0; extra == "cloud"
Requires-Dist: google-cloud-logging>=3.0.0; extra == "cloud"
Provides-Extra: performance
Requires-Dist: uvloop>=0.17.0; sys_platform != "win32" and extra == "performance"
Requires-Dist: orjson>=3.8.0; extra == "performance"
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Requires-Dist: mypy>=1.5.0; extra == "dev"
Requires-Dist: isort>=5.12.0; extra == "dev"
Requires-Dist: pre-commit>=3.0.0; extra == "dev"
Provides-Extra: docs
Requires-Dist: sphinx>=5.0.0; extra == "docs"
Requires-Dist: sphinx-rtd-theme>=1.2.0; extra == "docs"
Requires-Dist: myst-parser>=0.18.0; extra == "docs"
Requires-Dist: sphinx-autodoc-typehints>=1.19.0; extra == "docs"
Provides-Extra: all
Requires-Dist: storm-logger[cloud,django,enhanced,fastapi,flask,performance,security]; extra == "all"

# Storm Development Logging

This directory contains log files for the Storm Development application.

## Directory Structure

- `app/` - Application-specific logs
  - `storm_app.log` - Main application log
  - `debug.log` - Debug information (development only)

- `django/` - Django framework logs
  - `django.log` - Django system logs

- `errors/` - Error-specific logs
  - `errors.log` - All error and critical messages

- `archive/` - Archived/rotated log files

## Log Levels

- **DEBUG**: Detailed information for debugging
- **INFO**: General information about application flow
- **WARNING**: Something unexpected happened, but the app is still working
- **ERROR**: A serious problem occurred
- **CRITICAL**: A very serious error occurred

## Log Rotation

Log files are automatically rotated when they reach their maximum size:
- Application logs: 10MB max, 5 backups
- Django logs: 5MB max, 3 backups
- Error logs: 5MB max, 10 backups
- Debug logs: 20MB max, 2 backups

## Usage in Code

```python
import logging

# Get logger for your module
logger = logging.getLogger('storm.your_module')

# Log messages
logger.debug('Debug information')
logger.info('General information')
logger.warning('Warning message')
logger.error('Error occurred')
logger.critical('Critical error')
```

## Environment-Specific Behavior

**Development (DEBUG=True):**
- Colored console output
- Debug logs written to file
- All log levels displayed

**Production (DEBUG=False):**
- Simple console output
- No debug file logging
- Error emails sent to admins
- Syslog integration
