logservice 0.1.9

Reusable CloudWatch log sender

logservice

An async Python module for sending structured JSON logs to AWS CloudWatch Logs from any Python application, including FastAPI, Flask, background workers, and CLI tools.

---

📦 Installation

Install directly from PyPI:

pip install logservice

🚀 Usage

from fastapi import FastAPI
from logservice import AsyncCloudWatchLogService, LogEntry

app = FastAPI()

log_service = AsyncCloudWatchLogService(
    aws_access_key="...",
    aws_secret_key="...",
    region_name="us-east-1",
    log_group_name="app-logs",
    log_stream_name="login-events"
)

@app.post("/login")
async def login():
    await log_service.log(LogEntry(
        level="INFO",
        message="User logged in",
        service_name="LoginService",
        extra={"user_id": 123}
    ))
    return {"message": "Logged"}

---

🔧 Development & Deployment

Prerequisites

pip install twine build

Deployment Steps

1. Update version in setup.py
2. Clean old builds:

   rm -rf dist/ build/ *.egg-info/
   

3. Build package:

   python setup.py sdist bdist_wheel
   

4. Upload to PyPI:

   twine upload dist/*
   

Quick Deploy Script

# Clean, build, and deploy
rm -rf dist/ build/ *.egg-info/
python setup.py sdist bdist_wheel
twine upload dist/*