Files
flaskpaste/app/api/__init__.py
Username 7063f8718e feat: add observability and CLI enhancements
Audit logging:
- audit_log table with event tracking
- app/audit.py module with log_event(), query_audit_log()
- GET /audit endpoint (admin only)
- configurable retention and cleanup

Prometheus metrics:
- app/metrics.py with custom counters
- paste create/access/delete, rate limit, PoW, dedup metrics
- instrumentation in API routes

CLI clipboard integration:
- fpaste create -C/--clipboard (read from clipboard)
- fpaste create --copy-url (copy result URL)
- fpaste get -c/--copy (copy content)
- cross-platform: xclip, xsel, pbcopy, wl-copy

Shell completions:
- completions/ directory with bash/zsh/fish scripts
- fpaste completion --shell command
2025-12-23 22:39:50 +01:00

78 lines
2.4 KiB
Python

"""API blueprint registration."""
import threading
import time
from flask import Blueprint, current_app
bp = Blueprint("api", __name__)
# Thread-safe cleanup scheduling
_cleanup_lock = threading.Lock()
_cleanup_times: dict[str, float] = {
"pastes": 0.0,
"hashes": 0.0,
"rate_limits": 0.0,
"audit": 0.0,
}
_CLEANUP_INTERVALS = {
"pastes": 3600, # 1 hour
"hashes": 900, # 15 minutes
"rate_limits": 300, # 5 minutes
"audit": 86400, # 24 hours
}
def reset_cleanup_times() -> None:
"""Reset cleanup timestamps. For testing only."""
with _cleanup_lock:
for key in _cleanup_times:
_cleanup_times[key] = 0.0
@bp.before_request
def run_scheduled_cleanup():
"""Periodically run cleanup tasks on schedule."""
now = time.time()
with _cleanup_lock:
# Cleanup expired pastes
if now - _cleanup_times["pastes"] >= _CLEANUP_INTERVALS["pastes"]:
_cleanup_times["pastes"] = now
from app.database import cleanup_expired_pastes
count = cleanup_expired_pastes()
if count > 0:
current_app.logger.info(f"Cleaned up {count} expired paste(s)")
# Cleanup expired content hashes
if now - _cleanup_times["hashes"] >= _CLEANUP_INTERVALS["hashes"]:
_cleanup_times["hashes"] = now
from app.database import cleanup_expired_hashes
count = cleanup_expired_hashes()
if count > 0:
current_app.logger.info(f"Cleaned up {count} expired hash(es)")
# Cleanup rate limit entries
if now - _cleanup_times["rate_limits"] >= _CLEANUP_INTERVALS["rate_limits"]:
_cleanup_times["rate_limits"] = now
from app.api.routes import cleanup_rate_limits
count = cleanup_rate_limits()
if count > 0:
current_app.logger.info(f"Cleaned up {count} rate limit entries")
# Cleanup old audit logs
if now - _cleanup_times["audit"] >= _CLEANUP_INTERVALS["audit"]:
_cleanup_times["audit"] = now
if current_app.config.get("AUDIT_ENABLED", True):
from app.audit import cleanup_old_audit_logs
count = cleanup_old_audit_logs()
if count > 0:
current_app.logger.info(f"Cleaned up {count} old audit log entries")
from app.api import routes # noqa: E402, F401