forensic-cli 1.5.2__tar.gz → 1.6.0__tar.gz

{forensic_cli-1.5.2/src/forensic_cli.egg-info → forensic_cli-1.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: forensic-cli
-Version: 1.5.2
+Version: 1.6.0
 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.2 → forensic_cli-1.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "forensic-cli"
-version = "1.5.2"
+version = "1.6.0"
 description = "DevKit Forense - CLI para análise de navegadores e rede"
 readme = "README.md"
 license = {text = "MIT"}
@@ -106,7 +106,7 @@ Issues = "https://github.com/ErickG123/devkit_forense/issues"
 
 [tool.setuptools.packages.find]
 where = ["src"]
-include = ["network*", "browser*", "email*", "shared*", "api*", "app*"]
+include = ["network*", "browser*", "mail*", "shared*", "api*", "app*"]
 
 [tool.ruff]
 line-length = 100
@@ -123,7 +123,7 @@ pythonpath = ["src"]
 
 [tool.commitizen]
 name = "cz_conventional_commits"
-version = "1.5.2"
+version = "1.6.0"
 version_files = [
     "pyproject.toml:version",
     "src/shared/__init__.py:__version__"

forensic_cli-1.6.0/src/browser/api.py

@@ -0,0 +1,23 @@
+from fastapi import APIRouter
+
+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
+    )
+    # Mock seguro simulando processamento
+    result_data = [
+        {"url": "https://example.com", "title": "Example", "visit_count": 10},
+        {"url": "https://google.com", "title": "Google", "visit_count": 5},
+    ]
+    if request.limit:
+        result_data = result_data[: request.limit]
+    return BrowserHistoryResponse(status="success", data=result_data)

forensic_cli-1.6.0/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.2 → forensic_cli-1.6.0/src/forensic_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: forensic-cli
-Version: 1.5.2
+Version: 1.6.0
 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.2 → forensic_cli-1.6.0}/src/forensic_cli.egg-info/SOURCES.txt

@@ -23,18 +23,20 @@ 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/email/__init__.py
-src/email/api.py
-src/email/cli.py
-src/email/email_parser.py
-src/email/header_analysis.py
 src/forensic_cli.egg-info/PKG-INFO
 src/forensic_cli.egg-info/SOURCES.txt
 src/forensic_cli.egg-info/dependency_links.txt
 src/forensic_cli.egg-info/entry_points.txt
 src/forensic_cli.egg-info/requires.txt
 src/forensic_cli.egg-info/top_level.txt
+src/mail/__init__.py
+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.5.2 → forensic_cli-1.6.0}/src/forensic_cli.egg-info/top_level.txt

@@ -1,6 +1,6 @@
 api
 app
 browser
-email
+mail
 network
 shared

forensic_cli-1.6.0/src/mail/api.py

@@ -0,0 +1,19 @@
+from fastapi import APIRouter
+
+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)
+    # Mock seguro simulando processamento
+    result_data = {
+        "headers": {"subject": "Mock Subject", "from": "test@example.com"},
+        "body": "Mock body content",
+    }
+    return MailAnalysisResponse(status="success", data=result_data)

{forensic_cli-1.5.2/src/email → forensic_cli-1.6.0/src/mail}/cli.py

@@ -7,8 +7,6 @@ stdlib `email` do Python.
 """
 
 import json
-from email.email_parser import parse_eml_folder
-from email.header_analysis import analyze_email_headers
 from pathlib import Path
 
 import typer
@@ -16,6 +14,9 @@ from rich.console import Console
 from rich.panel import Panel
 from rich.table import Table
 
+from mail.email_parser import parse_eml_folder
+from mail.header_analysis import analyze_email_headers
+
 email_app = typer.Typer(help="Ferramentas para análise e manipulação de dados de e-mail")
 console = Console()
 

forensic_cli-1.6.0/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.2 → forensic_cli-1.6.0}/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.0/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.2/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.2/src/email/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."
-        ),
-    }