forensic-cli 1.4.1__tar.gz → 1.4.3__tar.gz

{forensic_cli-1.4.1/src/forensic_cli.egg-info → forensic_cli-1.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: forensic-cli
-Version: 1.4.1
+Version: 1.4.3
 Summary: DevKit Forense - CLI para análise de navegadores e rede
 Home-page: https://github.com/ErickG123/devkit_forense
 Author: Erick Gabriel dos Santos Alves
@@ -95,7 +95,9 @@ Dynamic: requires-python
 
 # DevKit Forense – Ferramenta Educacional de Perícia Digital
 
-![Python](https://img.shields.io/badge/Python-3.11-blue.svg) ![FastAPI](https://img.shields.io/badge/FastAPI-0.100-green.svg) ![Typer](https://img.shields.io/badge/Typer-0.7-orange.svg) ![SQLite](https://img.shields.io/badge/SQLite-3.41.2-lightgrey.svg)
+![Python](https://img.shields.io/badge/Python-3.11-blue.svg) ![Typer](https://img.shields.io/badge/Typer-0.7-orange.svg) ![SQLite](https://img.shields.io/badge/SQLite-3.41.2-lightgrey.svg)
+
+**ForenseLab** é um toolkit modular de análise forense digital, desenvolvido como um Trabalho de Conclusão de Curso em Engenharia da Computação. Seu principal objetivo é servir como uma ponte educacional para estudantes, educadores e entusiastas da área de segurança da informação.
 
 ## Sumário
 1. [Introdução](#introdução)  
@@ -111,31 +113,31 @@ Dynamic: requires-python
 
 ---
 
-## 1. Introdução
+## 🎯 O Problema
+O ensino prático de computação forense enfrenta uma barreira significativa. Ferramentas comerciais padrão de mercado, como EnCase e FTK, são robustas, mas possuem um custo proibitivo para ambientes acadêmicos. Por outro lado, alternativas open-source consolidadas, como Autopsy e Volatility Framework, embora poderosas e gratuitas, apresentam uma curva de aprendizado íngreme que pode intimidar e frustrar iniciantes.
 
-**Objetivo:**  
-O DevKit Forense é uma suíte de ferramentas educacionais para análise de evidências digitais, projetada para auxiliar no ensino de perícia digital. Combina **CLI**, **API** e **aplicações de apoio**, tornando o uso mais interativo, visual e didático.  
+Essa dualidade cria uma lacuna educacional: falta uma plataforma que permita ao estudante focar na **metodologia investigativa**, sem se perder na complexidade operacional da ferramenta.
 
-**Escopo:**  
-- Execução de análises forenses em browsers, arquivos, emails e redes.  
-- Visualização interativa de resultados.  
-- Geração de relatórios automáticos.  
-- Assistente interativo (Wizard) para guiar o usuário em tarefas complexas.  
+## 💡 A Proposta do ForenseLab
+O **ForenseLab** nasce para preencher essa lacuna, atuando como um "laboratório digital" introdutório. Ele não busca competir em funcionalidades com as suítes profissionais, mas sim oferecer um ambiente controlado, simplificado e didático para a aplicação de conceitos teóricos.
 
-**Público-alvo:**  
-- Estudantes e professores de Segurança da Informação e Perícia Digital.  
+Este projeto é destinado a **estudantes e professores da área de Segurança da Informação e Perícia Digital**, servindo como uma ponte entre a teoria e a prática.
 
----
+## ✨ Recursos Principais
 
-## 2. Estrutura do Projeto
+* **💻 Interface de Linha de Comando (CLI) Intuitiva:** Todas as análises são executadas através de uma CLI clara e bem documentada, ideal para automação, scripts e para quem busca agilidade no terminal.
+* **🧩 Arquitetura Modular e Extensível:** O toolkit é organizado em módulos independentes (Navegadores, Rede, E-mails), o que permite que a comunidade adicione facilmente novas capacidades de análise sem alterar o núcleo do sistema.
+* **🎓 Foco Didático:** Ao abstrair complexidades desnecessárias, a ferramenta permite que o aluno se concentre em entender os artefatos digitais e desenvolver o raciocínio investigativo.
 
-O DevKit está organizado em três camadas principais:
+## 🏛️ Arquitetura do Projeto
 
-1. **CLI** – Executa os módulos forenses pelo terminal.  
-2. **API** – Interface programática para execução de módulos e integração com dashboards.  
-3. **Core** – Contém a lógica central, classes, funções e utilitários compartilhados pelos módulos.  
+Para garantir a manutenibilidade e a clareza do código, o ForenseLab adota uma arquitetura de duas camadas principais, organizada em um monorepositório:
 
----
+1.  **`Core`**
+    * **O que faz:** É o cérebro do projeto. Contém toda a lógica de negócio, as classes de análise forense e as funções utilitárias. Centralizar a lógica no Core garante que as regras sejam consistentes e o código seja reutilizável.
+
+2.  **`CLI (Command-Line Interface)`**
+    * **O que faz:** É a interface do usuário e o ponto de entrada para todas as funcionalidades. Construída com Typer, ela invoca a lógica do `Core` para executar as análises e apresentar os resultados de forma estruturada no terminal.
 
 ## 3. Módulos Forenses
 
@@ -169,16 +171,11 @@ O DevKit está organizado em três camadas principais:
 | `email_parser` | Extrai e organiza informações de emails. |
 | `header_analysis` | Analisa cabeçalhos para identificar origem, roteamento e possíveis fraudes. |
 
----
-
 ## 4. Tecnologias Utilizadas
 
-- **Python** – Linguagem principal do projeto.  
-- **FastAPI** – API para integração e execução de módulos.  
-- **Typer** – CLI estruturada e interativa.  
-- **SQLite** – Banco de dados local leve.  
-
----
+* **Python:** Linguagem principal do projeto, escolhida por sua simplicidade e pelo vasto ecossistema de bibliotecas para manipulação de dados.
+* **Typer:** Utilizado para criar a interface de linha de comando (CLI) de forma robusta e intuitiva.
+* **SQLite:** Várias análises, como a de históricos de navegadores, interagem diretamente com bancos de dados SQLite.
 
 ## 5. Planejamento e Futuras Extensões
 
@@ -190,8 +187,6 @@ O DevKit está organizado em três camadas principais:
 | Novos módulos CLI | Expansão da análise forense | Logs de sistemas, recuperação de dispositivos móveis, análise de mídia, detecção de malware, integração com threat intelligence |
 | Ferramentas auxiliares | Suporte a módulos existentes e novos | Exportação avançada de relatórios, dashboards customizáveis, notificações em tempo real |
 
----
-
 ## 6. Instalação
 A forma mais simples de instalar a CLI é utilizando o **PyPI**.  
 Execute o seguinte comando no terminal:

{forensic_cli-1.4.1 → forensic_cli-1.4.3}/README.md

@@ -1,6 +1,8 @@
 # DevKit Forense – Ferramenta Educacional de Perícia Digital
 
-![Python](https://img.shields.io/badge/Python-3.11-blue.svg) ![FastAPI](https://img.shields.io/badge/FastAPI-0.100-green.svg) ![Typer](https://img.shields.io/badge/Typer-0.7-orange.svg) ![SQLite](https://img.shields.io/badge/SQLite-3.41.2-lightgrey.svg)
+![Python](https://img.shields.io/badge/Python-3.11-blue.svg) ![Typer](https://img.shields.io/badge/Typer-0.7-orange.svg) ![SQLite](https://img.shields.io/badge/SQLite-3.41.2-lightgrey.svg)
+
+**ForenseLab** é um toolkit modular de análise forense digital, desenvolvido como um Trabalho de Conclusão de Curso em Engenharia da Computação. Seu principal objetivo é servir como uma ponte educacional para estudantes, educadores e entusiastas da área de segurança da informação.
 
 ## Sumário
 1. [Introdução](#introdução)  
@@ -16,31 +18,31 @@
 
 ---
 
-## 1. Introdução
+## 🎯 O Problema
+O ensino prático de computação forense enfrenta uma barreira significativa. Ferramentas comerciais padrão de mercado, como EnCase e FTK, são robustas, mas possuem um custo proibitivo para ambientes acadêmicos. Por outro lado, alternativas open-source consolidadas, como Autopsy e Volatility Framework, embora poderosas e gratuitas, apresentam uma curva de aprendizado íngreme que pode intimidar e frustrar iniciantes.
 
-**Objetivo:**  
-O DevKit Forense é uma suíte de ferramentas educacionais para análise de evidências digitais, projetada para auxiliar no ensino de perícia digital. Combina **CLI**, **API** e **aplicações de apoio**, tornando o uso mais interativo, visual e didático.  
+Essa dualidade cria uma lacuna educacional: falta uma plataforma que permita ao estudante focar na **metodologia investigativa**, sem se perder na complexidade operacional da ferramenta.
 
-**Escopo:**  
-- Execução de análises forenses em browsers, arquivos, emails e redes.  
-- Visualização interativa de resultados.  
-- Geração de relatórios automáticos.  
-- Assistente interativo (Wizard) para guiar o usuário em tarefas complexas.  
+## 💡 A Proposta do ForenseLab
+O **ForenseLab** nasce para preencher essa lacuna, atuando como um "laboratório digital" introdutório. Ele não busca competir em funcionalidades com as suítes profissionais, mas sim oferecer um ambiente controlado, simplificado e didático para a aplicação de conceitos teóricos.
 
-**Público-alvo:**  
-- Estudantes e professores de Segurança da Informação e Perícia Digital.  
+Este projeto é destinado a **estudantes e professores da área de Segurança da Informação e Perícia Digital**, servindo como uma ponte entre a teoria e a prática.
 
----
+## ✨ Recursos Principais
 
-## 2. Estrutura do Projeto
+* **💻 Interface de Linha de Comando (CLI) Intuitiva:** Todas as análises são executadas através de uma CLI clara e bem documentada, ideal para automação, scripts e para quem busca agilidade no terminal.
+* **🧩 Arquitetura Modular e Extensível:** O toolkit é organizado em módulos independentes (Navegadores, Rede, E-mails), o que permite que a comunidade adicione facilmente novas capacidades de análise sem alterar o núcleo do sistema.
+* **🎓 Foco Didático:** Ao abstrair complexidades desnecessárias, a ferramenta permite que o aluno se concentre em entender os artefatos digitais e desenvolver o raciocínio investigativo.
 
-O DevKit está organizado em três camadas principais:
+## 🏛️ Arquitetura do Projeto
 
-1. **CLI** – Executa os módulos forenses pelo terminal.  
-2. **API** – Interface programática para execução de módulos e integração com dashboards.  
-3. **Core** – Contém a lógica central, classes, funções e utilitários compartilhados pelos módulos.  
+Para garantir a manutenibilidade e a clareza do código, o ForenseLab adota uma arquitetura de duas camadas principais, organizada em um monorepositório:
 
----
+1.  **`Core`**
+    * **O que faz:** É o cérebro do projeto. Contém toda a lógica de negócio, as classes de análise forense e as funções utilitárias. Centralizar a lógica no Core garante que as regras sejam consistentes e o código seja reutilizável.
+
+2.  **`CLI (Command-Line Interface)`**
+    * **O que faz:** É a interface do usuário e o ponto de entrada para todas as funcionalidades. Construída com Typer, ela invoca a lógica do `Core` para executar as análises e apresentar os resultados de forma estruturada no terminal.
 
 ## 3. Módulos Forenses
 
@@ -74,16 +76,11 @@ O DevKit está organizado em três camadas principais:
 | `email_parser` | Extrai e organiza informações de emails. |
 | `header_analysis` | Analisa cabeçalhos para identificar origem, roteamento e possíveis fraudes. |
 
----
-
 ## 4. Tecnologias Utilizadas
 
-- **Python** – Linguagem principal do projeto.  
-- **FastAPI** – API para integração e execução de módulos.  
-- **Typer** – CLI estruturada e interativa.  
-- **SQLite** – Banco de dados local leve.  
-
----
+* **Python:** Linguagem principal do projeto, escolhida por sua simplicidade e pelo vasto ecossistema de bibliotecas para manipulação de dados.
+* **Typer:** Utilizado para criar a interface de linha de comando (CLI) de forma robusta e intuitiva.
+* **SQLite:** Várias análises, como a de históricos de navegadores, interagem diretamente com bancos de dados SQLite.
 
 ## 5. Planejamento e Futuras Extensões
 
@@ -95,8 +92,6 @@ O DevKit está organizado em três camadas principais:
 | Novos módulos CLI | Expansão da análise forense | Logs de sistemas, recuperação de dispositivos móveis, análise de mídia, detecção de malware, integração com threat intelligence |
 | Ferramentas auxiliares | Suporte a módulos existentes e novos | Exportação avançada de relatórios, dashboards customizáveis, notificações em tempo real |
 
----
-
 ## 6. Instalação
 A forma mais simples de instalar a CLI é utilizando o **PyPI**.  
 Execute o seguinte comando no terminal:

{forensic_cli-1.4.1 → forensic_cli-1.4.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "forensic-cli"
-version = "1.4.1"
+version = "1.4.3"
 description = "DevKit Forense - CLI para análise de navegadores e rede"
 readme = "README.md"
 license = {text = "MIT"}

{forensic_cli-1.4.1 → forensic_cli-1.4.3}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="forensic_cli",
-    version="1.4.1",
+    version="1.4.3",
     author="Erick Gabriel dos Santos Alves",
     author_email="erickgabrielalves0@gmail.com",
     description="Toolkit modular para análise de evidências digitais",

{forensic_cli-1.4.1 → forensic_cli-1.4.3/src/forensic_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: forensic-cli
-Version: 1.4.1
+Version: 1.4.3
 Summary: DevKit Forense - CLI para análise de navegadores e rede
 Home-page: https://github.com/ErickG123/devkit_forense
 Author: Erick Gabriel dos Santos Alves
@@ -95,7 +95,9 @@ Dynamic: requires-python
 
 # DevKit Forense – Ferramenta Educacional de Perícia Digital
 
-![Python](https://img.shields.io/badge/Python-3.11-blue.svg) ![FastAPI](https://img.shields.io/badge/FastAPI-0.100-green.svg) ![Typer](https://img.shields.io/badge/Typer-0.7-orange.svg) ![SQLite](https://img.shields.io/badge/SQLite-3.41.2-lightgrey.svg)
+![Python](https://img.shields.io/badge/Python-3.11-blue.svg) ![Typer](https://img.shields.io/badge/Typer-0.7-orange.svg) ![SQLite](https://img.shields.io/badge/SQLite-3.41.2-lightgrey.svg)
+
+**ForenseLab** é um toolkit modular de análise forense digital, desenvolvido como um Trabalho de Conclusão de Curso em Engenharia da Computação. Seu principal objetivo é servir como uma ponte educacional para estudantes, educadores e entusiastas da área de segurança da informação.
 
 ## Sumário
 1. [Introdução](#introdução)  
@@ -111,31 +113,31 @@ Dynamic: requires-python
 
 ---
 
-## 1. Introdução
+## 🎯 O Problema
+O ensino prático de computação forense enfrenta uma barreira significativa. Ferramentas comerciais padrão de mercado, como EnCase e FTK, são robustas, mas possuem um custo proibitivo para ambientes acadêmicos. Por outro lado, alternativas open-source consolidadas, como Autopsy e Volatility Framework, embora poderosas e gratuitas, apresentam uma curva de aprendizado íngreme que pode intimidar e frustrar iniciantes.
 
-**Objetivo:**  
-O DevKit Forense é uma suíte de ferramentas educacionais para análise de evidências digitais, projetada para auxiliar no ensino de perícia digital. Combina **CLI**, **API** e **aplicações de apoio**, tornando o uso mais interativo, visual e didático.  
+Essa dualidade cria uma lacuna educacional: falta uma plataforma que permita ao estudante focar na **metodologia investigativa**, sem se perder na complexidade operacional da ferramenta.
 
-**Escopo:**  
-- Execução de análises forenses em browsers, arquivos, emails e redes.  
-- Visualização interativa de resultados.  
-- Geração de relatórios automáticos.  
-- Assistente interativo (Wizard) para guiar o usuário em tarefas complexas.  
+## 💡 A Proposta do ForenseLab
+O **ForenseLab** nasce para preencher essa lacuna, atuando como um "laboratório digital" introdutório. Ele não busca competir em funcionalidades com as suítes profissionais, mas sim oferecer um ambiente controlado, simplificado e didático para a aplicação de conceitos teóricos.
 
-**Público-alvo:**  
-- Estudantes e professores de Segurança da Informação e Perícia Digital.  
+Este projeto é destinado a **estudantes e professores da área de Segurança da Informação e Perícia Digital**, servindo como uma ponte entre a teoria e a prática.
 
----
+## ✨ Recursos Principais
 
-## 2. Estrutura do Projeto
+* **💻 Interface de Linha de Comando (CLI) Intuitiva:** Todas as análises são executadas através de uma CLI clara e bem documentada, ideal para automação, scripts e para quem busca agilidade no terminal.
+* **🧩 Arquitetura Modular e Extensível:** O toolkit é organizado em módulos independentes (Navegadores, Rede, E-mails), o que permite que a comunidade adicione facilmente novas capacidades de análise sem alterar o núcleo do sistema.
+* **🎓 Foco Didático:** Ao abstrair complexidades desnecessárias, a ferramenta permite que o aluno se concentre em entender os artefatos digitais e desenvolver o raciocínio investigativo.
 
-O DevKit está organizado em três camadas principais:
+## 🏛️ Arquitetura do Projeto
 
-1. **CLI** – Executa os módulos forenses pelo terminal.  
-2. **API** – Interface programática para execução de módulos e integração com dashboards.  
-3. **Core** – Contém a lógica central, classes, funções e utilitários compartilhados pelos módulos.  
+Para garantir a manutenibilidade e a clareza do código, o ForenseLab adota uma arquitetura de duas camadas principais, organizada em um monorepositório:
 
----
+1.  **`Core`**
+    * **O que faz:** É o cérebro do projeto. Contém toda a lógica de negócio, as classes de análise forense e as funções utilitárias. Centralizar a lógica no Core garante que as regras sejam consistentes e o código seja reutilizável.
+
+2.  **`CLI (Command-Line Interface)`**
+    * **O que faz:** É a interface do usuário e o ponto de entrada para todas as funcionalidades. Construída com Typer, ela invoca a lógica do `Core` para executar as análises e apresentar os resultados de forma estruturada no terminal.
 
 ## 3. Módulos Forenses
 
@@ -169,16 +171,11 @@ O DevKit está organizado em três camadas principais:
 | `email_parser` | Extrai e organiza informações de emails. |
 | `header_analysis` | Analisa cabeçalhos para identificar origem, roteamento e possíveis fraudes. |
 
----
-
 ## 4. Tecnologias Utilizadas
 
-- **Python** – Linguagem principal do projeto.  
-- **FastAPI** – API para integração e execução de módulos.  
-- **Typer** – CLI estruturada e interativa.  
-- **SQLite** – Banco de dados local leve.  
-
----
+* **Python:** Linguagem principal do projeto, escolhida por sua simplicidade e pelo vasto ecossistema de bibliotecas para manipulação de dados.
+* **Typer:** Utilizado para criar a interface de linha de comando (CLI) de forma robusta e intuitiva.
+* **SQLite:** Várias análises, como a de históricos de navegadores, interagem diretamente com bancos de dados SQLite.
 
 ## 5. Planejamento e Futuras Extensões
 
@@ -190,8 +187,6 @@ O DevKit está organizado em três camadas principais:
 | Novos módulos CLI | Expansão da análise forense | Logs de sistemas, recuperação de dispositivos móveis, análise de mídia, detecção de malware, integração com threat intelligence |
 | Ferramentas auxiliares | Suporte a módulos existentes e novos | Exportação avançada de relatórios, dashboards customizáveis, notificações em tempo real |
 
----
-
 ## 6. Instalação
 A forma mais simples de instalar a CLI é utilizando o **PyPI**.  
 Execute o seguinte comando no terminal: