core: Melhorando logs com loguru

Author: henriquesebastiao

CHANGELOG.md

@@ -1,3 +1,10 @@
+## [0.2.2](https://github.com/henriquesebastiao/vagas-dev/releases/0.2.2) - 2026-03-10
+
+### Core
+
+- Melhorando logs com loguru
+
+
 ## [0.2.1](https://github.com/henriquesebastiao/vagas-dev/releases/0.2.1) - 2026-03-05
 
 ### Funcionalidade

backend/app/__init__.py

@@ -1 +1 @@
-__version__ = '0.2.1'
+__version__ = '0.2.2'

backend/app/api/routes/job.py

@@ -1,7 +1,7 @@
-import logging
 from typing import Annotated
 
 from fastapi import APIRouter, BackgroundTasks, HTTPException, Query, status
+from loguru import logger
 from sqlalchemy import func, select
 
 from app.enum import JobLevel, JobSource, Keyword, WorkplaceType
@@ -11,8 +11,6 @@
 from app.scrapers import gupy, linkedin
 from app.utils import Session
 
-logger = logging.getLogger(__name__)
-
 router = APIRouter(prefix='/jobs', tags=['jobs'])
 
 

backend/app/core/settings.py

@@ -14,6 +14,7 @@ class Settings(BaseSettings):
     # App
     APP_URL: str = 'http://localhost:8000'
     INTERVAL_SYNC: int = 60  # Intervalo de execução dos jobs do scheduler
+    DEBUG: bool = False
 
     # Telegram
     TELEGRAM_BOT_TOKEN: str = ''

backend/app/main.py

@@ -1,9 +1,11 @@
 import asyncio
 import logging
+import sys
 from contextlib import asynccontextmanager
 
 from fastapi import FastAPI
 from fastapi.middleware.cors import CORSMiddleware
+from loguru import logger
 
 from app import __version__
 from app.api.routes import job
@@ -12,9 +14,32 @@
 from app.schemas.health import HealthOut
 from app.wrappers.discord_bot import bot
 
-logging.basicConfig(level=logging.INFO)
 settings = get_settings()
 
+log_level = 'INFO'
+if settings.DEBUG:
+    log_level = 'DEBUG'
+
+
+class InterceptHandler(logging.Handler):
+    def emit(self, record: logging.LogRecord):
+        # Descobre o nível equivalente no loguru
+        try:
+            level = logger.level(record.levelname).name
+        except ValueError:
+            level = record.levelno
+
+        # Sobe na call stack para achar o chamador real
+        frame, depth = sys._getframe(6), 6
+        while frame and frame.f_code.co_filename == logging.__file__:
+            frame = frame.f_back
+            depth += 1
+
+        logger.opt(depth=depth, exception=record.exc_info).log(
+            level, record.getMessage()
+        )
+
+
 description = f"""
 Esta API fornece acesso a vagas de emprego para desenvolvedores, coletadas de diversas fontes.
 
@@ -28,6 +53,30 @@
 async def lifespan(app: FastAPI):
     # Startup
 
+    # Remove o handler padrão do loguru
+    logger.remove()
+
+    logger.add(
+        sys.stdout,
+        level=log_level,
+        colorize=True,
+    )
+
+    # Opcional: salvar em arquivo com rotação
+    logger.add(
+        'logs/app.log',
+        level=log_level,
+        rotation='10 MB',
+        retention='7 days',
+        compression='zip',
+    )
+
+    # Intercepta todos os loggers do Python (uvicorn, sqlalchemy, etc.)
+    logging.basicConfig(handlers=[InterceptHandler()], level=0, force=True)
+    for name in logging.root.manager.loggerDict:
+        logging.getLogger(name).handlers = [InterceptHandler()]
+        logging.getLogger(name).propagate = False
+
     # Aplica migrations pendentes automaticamente no startup
     proc = await asyncio.create_subprocess_exec(
         'alembic',

backend/app/notifiers.py

@@ -1,7 +1,7 @@
-import logging
 from dataclasses import asdict
 from typing import Any
 
+from loguru import logger
 from sqlalchemy import select
 
 from app.core.database import AsyncSessionLocal
@@ -10,8 +10,6 @@
 from app.wrappers.discord_bot import send_notification_jobs
 from app.wrappers.telegram import BotTelegram
 
-logger = logging.getLogger(__name__)
-
 
 async def get_jobs_for_selector(selector) -> dict[str, Any]:
     async with AsyncSessionLocal() as session:

backend/app/scheduler.py

@@ -1,15 +1,13 @@
-import logging
-
 from apscheduler.schedulers.asyncio import AsyncIOScheduler
 from apscheduler.triggers.interval import IntervalTrigger
+from loguru import logger
 
 from app.core.database import AsyncSessionLocal
 from app.core.settings import get_settings
 from app.keywords import KEYWORDS
 from app.notifiers import notify_new_jobs
 from app.scrapers import gupy, linkedin
 
-logger = logging.getLogger(__name__)
 scheduler = AsyncIOScheduler()
 settings = get_settings()
 

backend/app/scrapers/base.py

@@ -1,14 +1,12 @@
-import logging
 from abc import ABC, abstractmethod
 
+from loguru import logger
 from sqlalchemy import select
 from sqlalchemy.ext.asyncio import AsyncSession
 
 from app.keywords import KEYWORDS
 from app.models import Job
 
-logger = logging.getLogger(__name__)
-
 
 class BaseJobScraper(ABC):
     """Contrato base para todos os scrapers de vagas.

backend/app/scrapers/gupy.py

@@ -1,15 +1,13 @@
 import html
-import logging
 import re
 
 import httpx
+from loguru import logger
 
 from app.scrapers import transport
 from app.scrapers.base import BaseJobScraper
 from app.utils import get_level_seniority
 
-logger = logging.getLogger(__name__)
-
 
 class GupyScraper(BaseJobScraper):
     """

backend/app/scrapers/linkedin.py

@@ -1,16 +1,14 @@
 import asyncio
 import hashlib
-import logging
 from http import HTTPStatus
 
 import httpx
 from bs4 import BeautifulSoup
+from loguru import logger
 
 from app.scrapers import transport
 from app.scrapers.base import BaseJobScraper
 
-logger = logging.getLogger(__name__)
-
 linkedin_level_id = {
     'estagio': 1,
     'junior': 3,