forensic-cli 1.5.3__tar.gz → 1.6.1__tar.gz

{forensic_cli-1.5.3/src/forensic_cli.egg-info → forensic_cli-1.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: forensic-cli
-Version: 1.5.3
+Version: 1.6.1
 Summary: DevKit Forense - CLI para análise de navegadores e rede
 Author-email: Erick Gabriel dos Santos Alves <erickgabrielalves0@gmail.com>
 License: MIT

{forensic_cli-1.5.3 → forensic_cli-1.6.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "forensic-cli"
-version = "1.5.3"
+version = "1.6.1"
 description = "DevKit Forense - CLI para análise de navegadores e rede"
 readme = "README.md"
 license = {text = "MIT"}
@@ -123,7 +123,7 @@ pythonpath = ["src"]
 
 [tool.commitizen]
 name = "cz_conventional_commits"
-version = "1.5.3"
+version = "1.6.1"
 version_files = [
     "pyproject.toml:version",
     "src/shared/__init__.py:__version__"

forensic_cli-1.6.1/src/browser/api.py

@@ -0,0 +1,35 @@
+from fastapi import APIRouter, HTTPException
+
+from browser.browser_history import locale_database
+from browser.schemas import BrowserHistoryRequest, BrowserHistoryResponse
+from shared.logger import get_logger
+
+logger = get_logger(__name__)
+
+router = APIRouter(prefix="/api/browser", tags=["Browser"])
+
+
+@router.post("/history", response_model=BrowserHistoryResponse)
+def get_history(request: BrowserHistoryRequest):
+    logger.info(
+        "API /history chamada para navegador: %s com limite: %s", request.browser, request.limit
+    )
+    try:
+        all_results = locale_database()
+
+        filtered_data = []
+        for res in all_results:
+            if (
+                not request.browser
+                or request.browser.lower() == "all"
+                or res.get("Navegador", "").lower() == request.browser.lower()
+            ):
+                filtered_data.extend(res.get("Dados", []))
+
+        if request.limit:
+            filtered_data = filtered_data[: request.limit]
+
+        return BrowserHistoryResponse(status="success", data=filtered_data)
+    except Exception as exc:
+        logger.exception("Erro na extração de histórico.")
+        raise HTTPException(status_code=500, detail=str(exc))

forensic_cli-1.6.1/src/browser/schemas.py

@@ -0,0 +1,13 @@
+from typing import Any, Dict, List, Optional
+
+from pydantic import BaseModel, Field
+
+
+class BrowserHistoryRequest(BaseModel):
+    browser: str = Field(..., description="Nome do navegador (ex: chrome, firefox)")
+    limit: Optional[int] = Field(None, description="Limite de registros a retornar")
+
+
+class BrowserHistoryResponse(BaseModel):
+    status: str
+    data: List[Dict[str, Any]]

{forensic_cli-1.5.3 → forensic_cli-1.6.1/src/forensic_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: forensic-cli
-Version: 1.5.3
+Version: 1.6.1
 Summary: DevKit Forense - CLI para análise de navegadores e rede
 Author-email: Erick Gabriel dos Santos Alves <erickgabrielalves0@gmail.com>
 License: MIT

{forensic_cli-1.5.3 → forensic_cli-1.6.1}/src/forensic_cli.egg-info/SOURCES.txt

@@ -23,6 +23,7 @@ src/browser/common_words.py
 src/browser/downloads_history.py
 src/browser/fav_screen.py
 src/browser/logins.py
+src/browser/schemas.py
 src/browser/unusual_patterns.py
 src/forensic_cli.egg-info/PKG-INFO
 src/forensic_cli.egg-info/SOURCES.txt
@@ -35,6 +36,7 @@ src/mail/api.py
 src/mail/cli.py
 src/mail/email_parser.py
 src/mail/header_analysis.py
+src/mail/schemas.py
 src/network/__init__.py
 src/network/api.py
 src/network/arp_scan.py
@@ -45,6 +47,7 @@ src/network/ip_info.py
 src/network/network_map.py
 src/network/ping_sweep.py
 src/network/port_scanner.py
+src/network/schemas.py
 src/network/smb_scan.py
 src/network/snmp_scan.py
 src/network/traceroute.py

forensic_cli-1.6.1/src/mail/api.py

@@ -0,0 +1,26 @@
+import os
+
+from fastapi import APIRouter, HTTPException
+
+from mail.email_parser import parse_eml_file
+from mail.schemas import MailAnalysisRequest, MailAnalysisResponse
+from shared.logger import get_logger
+
+logger = get_logger(__name__)
+
+router = APIRouter(prefix="/api/mail", tags=["Mail"])
+
+
+@router.post("/analyze", response_model=MailAnalysisResponse)
+def analyze_mail(request: MailAnalysisRequest):
+    logger.info("API /analyze chamada para: %s", request.file_path)
+    try:
+        if not os.path.exists(request.file_path):
+            raise HTTPException(status_code=404, detail="Arquivo não encontrado.")
+        result_data = parse_eml_file(request.file_path)
+        return MailAnalysisResponse(status="success", data=result_data)
+    except HTTPException:
+        raise
+    except Exception as exc:
+        logger.exception("Erro ao processar arquivo .eml.")
+        raise HTTPException(status_code=500, detail=str(exc))

forensic_cli-1.6.1/src/mail/schemas.py

@@ -0,0 +1,12 @@
+from typing import Any, Dict
+
+from pydantic import BaseModel, Field
+
+
+class MailAnalysisRequest(BaseModel):
+    file_path: str = Field(..., description="Caminho para o arquivo .eml ou cabeçalho")
+
+
+class MailAnalysisResponse(BaseModel):
+    status: str
+    data: Dict[str, Any]

{forensic_cli-1.5.3 → forensic_cli-1.6.1}/src/network/api.py

@@ -15,13 +15,14 @@ from network.dns_recon import dns_recon
 from network.ip_info import ip_info_lookup
 from network.ping_sweep import parse_network, ping_host
 from network.port_scanner import scan_host
+from network.schemas import NetworkScanRequest, NetworkScanResponse
 from network.traceroute import traceroute_host
 from shared.config import get as cfg_get
 from shared.logger import get_logger
 
 logger = get_logger(__name__)
 
-router = APIRouter()
+router = APIRouter(prefix="/api/network", tags=["Network"])
 
 _DEFAULT_PORTS = cfg_get("network", "default_ports", default="21,22,53,80,443,445,3306,8080")
 
@@ -31,15 +32,6 @@ _DEFAULT_PORTS = cfg_get("network", "default_ports", default="21,22,53,80,443,44
 # ---------------------------------------------------------------------------
 
 
-class ScanRequest(BaseModel):
-    target: str = Field(..., examples=["192.168.1.1"], description="IP ou hostname do alvo")
-    ports: str = Field(
-        default=_DEFAULT_PORTS,
-        examples=["22,80,443"],
-        description="Portas a escanear. Ex: '22,80,100-200'",
-    )
-
-
 class SweepRequest(BaseModel):
     network: str = Field(
         ..., examples=["192.168.1.1-254"], description="Range de IPs. Ex: 192.168.1.1-254"
@@ -66,13 +58,15 @@ class TracerouteRequest(BaseModel):
     "/scan",
     summary="Port Scan",
     description="Realiza um scan de portas TCP em um host e retorna as portas abertas com serviços e banners.",
+    response_model=NetworkScanResponse,
 )
-def run_port_scan(request: ScanRequest):
-    logger.info("API /scan — alvo: %s | portas: %s", request.target, request.ports)
+def run_port_scan(request: NetworkScanRequest):
+    logger.info("API /scan — alvo: %s | portas (list): %s", request.target, request.ports)
     try:
-        results = scan_host(target=request.target, ports=request.ports)
+        ports_str = ",".join(map(str, request.ports)) if request.ports else _DEFAULT_PORTS
+        results = scan_host(target=request.target, ports=ports_str)
         logger.info("API /scan concluído — %d resultado(s).", len(results))
-        return {"target": request.target, "status": "success", "data": results}
+        return NetworkScanResponse(target=request.target, status="success", data=results)
     except Exception as exc:
         logger.exception("Erro em /scan para '%s'.", request.target)
         raise HTTPException(status_code=500, detail=str(exc))

forensic_cli-1.6.1/src/network/schemas.py

@@ -0,0 +1,16 @@
+from typing import Any, List, Optional
+
+from pydantic import BaseModel, Field
+
+
+class NetworkScanRequest(BaseModel):
+    target: str = Field(..., examples=["192.168.1.1"], description="IP ou hostname do alvo")
+    ports: Optional[list[int]] = Field(
+        None, examples=[[22, 80, 443]], description="Lista de portas a escanear"
+    )
+
+
+class NetworkScanResponse(BaseModel):
+    target: str
+    status: str
+    data: List[Any]

forensic_cli-1.5.3/src/browser/api.py

@@ -1,39 +0,0 @@
-"""
-API Router da feature Browser.
-
-Expõe endpoints REST para extração de artefatos de navegadores.
-Os endpoints de extração são operações de longa duração — em produção
-considere movê-los para tarefas assíncronas (ex: Celery/BackgroundTasks).
-"""
-
-from fastapi import APIRouter
-
-from shared.logger import get_logger
-
-logger = get_logger(__name__)
-
-router = APIRouter()
-
-
-# ---------------------------------------------------------------------------
-# Health-check da feature
-# ---------------------------------------------------------------------------
-
-
-@router.get(
-    "/health",
-    summary="Browser Feature Health-check",
-    description="Confirma que o módulo de análise de navegadores está disponível.",
-)
-def browser_health():
-    return {
-        "feature": "browser",
-        "status": "online",
-        "endpoints_available": [
-            "GET  /browser/health",
-        ],
-        "note": (
-            "Os endpoints de extração (history, downloads, logins) operam sobre "
-            "o sistema de arquivos local e serão expostos em versões futuras da API."
-        ),
-    }

forensic_cli-1.5.3/src/mail/api.py

@@ -1,37 +0,0 @@
-"""
-API Router da feature Email.
-
-Expõe endpoints REST para análise forense de e-mails.
-"""
-
-from fastapi import APIRouter
-
-from shared.logger import get_logger
-
-logger = get_logger(__name__)
-
-router = APIRouter()
-
-
-# ---------------------------------------------------------------------------
-# Health-check da feature
-# ---------------------------------------------------------------------------
-
-
-@router.get(
-    "/health",
-    summary="Email Feature Health-check",
-    description="Confirma que o módulo de análise de e-mails está disponível.",
-)
-def email_health():
-    return {
-        "feature": "email",
-        "status": "online",
-        "endpoints_available": [
-            "GET  /email/health",
-        ],
-        "note": (
-            "Os endpoints de parsing (.eml) e análise de cabeçalhos serão "
-            "expostos em versões futuras da API REST."
-        ),
-    }