translate to english!
This commit is contained in:
@@ -1,84 +1,84 @@
|
||||
# PROMETEU
|
||||
|
||||
PROMETEU é um **ecossistema educacional e experimental** inspirado em consoles clássicos, com foco em **ensinar programação, arquitetura de sistemas e conceitos de hardware através de software**.
|
||||
PROMETEU is an **educational and experimental ecosystem** inspired by classic consoles, focusing on **teaching programming, system architecture, and hardware concepts through software**.
|
||||
|
||||
> PROMETEU é uma máquina virtual simples, explícita e didática.
|
||||
> PROMETEU is a simple, explicit, and educational virtual machine.
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Objetivos do Projeto
|
||||
## 🎯 Project Goals
|
||||
|
||||
- **Simular um “hardware lógico” simples**: Criar uma barreira de entrada baixa para entender como computadores funcionam.
|
||||
- **Loop Determinístico**: Garantir que o mesmo código produza o mesmo resultado em qualquer plataforma.
|
||||
- **Portabilidade Total**: O núcleo não depende de sistema operacional, permitindo rodar de computadores modernos a hardware dedicado.
|
||||
- **Ferramentas de Primeiro Nível**: Oferecer depuração e inspeção profunda como parte central da experiência.
|
||||
- **Simulate simple "logical hardware"**: Create a low entry barrier for understanding how computers work.
|
||||
- **Deterministic Loop**: Ensure the same code produces the same result on any platform.
|
||||
- **Total Portability**: The core does not depend on an operating system, allowing it to run from modern computers to dedicated hardware.
|
||||
- **First-Class Tools**: Offer deep debugging and inspection as a central part of the experience.
|
||||
|
||||
---
|
||||
|
||||
## 🧠 Filosofia de Design
|
||||
## 🧠 Design Philosophy
|
||||
|
||||
- **Sem magia**: tudo é explícito.
|
||||
- **Sem heurística implícita**: o sistema não “adivinha intenções”.
|
||||
- **Determinístico**: mesmo input → mesmo resultado.
|
||||
- **Hardware-first**: APIs modelam periféricos, não frameworks modernos.
|
||||
- **Portável por definição**: se não funciona em todas as plataformas, não existe.
|
||||
- **No magic**: everything is explicit.
|
||||
- **No implicit heuristics**: the system doesn't "guess intentions".
|
||||
- **Deterministic**: same input → same result.
|
||||
- **Hardware-first**: APIs model peripherals, not modern frameworks.
|
||||
- **Portable by definition**: if it doesn't work on all platforms, it doesn't exist.
|
||||
|
||||
---
|
||||
|
||||
## 📦 Estrutura do Monorepo
|
||||
## 📦 Monorepo Structure
|
||||
|
||||
Este repositório é organizado como um workspace Rust e contém diversos componentes:
|
||||
This repository is organized as a Rust workspace and contains several components:
|
||||
|
||||
- **[crates/](./crates)**: Implementação do software em Rust.
|
||||
- **[prometeu](./crates/prometeu)**: Interface de linha de comando (CLI) unificada.
|
||||
- **[prometeu-core](./crates/prometeu-core)**: O núcleo lógico, VM e SO interno.
|
||||
- **[prometeu-runtime-desktop](./crates/prometeu-runtime-desktop)**: Host para execução em sistemas Desktop.
|
||||
- **[docs/](./docs)**: Documentação técnica e especificações do sistema.
|
||||
- **[devtools-protocol/](./devtools-protocol)**: Definição do protocolo de comunicação para ferramentas de desenvolvimento.
|
||||
- **[test-cartridges/](./test-cartridges)**: Exemplos e suítes de teste de cartuchos.
|
||||
- **[crates/](./crates)**: Software implementation in Rust.
|
||||
- **[prometeu](./crates/prometeu)**: Unified command-line interface (CLI).
|
||||
- **[prometeu-core](./crates/prometeu-core)**: The logical core, VM, and internal OS.
|
||||
- **[prometeu-runtime-desktop](./crates/prometeu-runtime-desktop)**: Host for execution on Desktop systems.
|
||||
- **[docs/](./docs)**: Technical documentation and system specifications.
|
||||
- **[devtools-protocol/](./devtools-protocol)**: Definition of the communication protocol for development tools.
|
||||
- **[test-cartridges/](./test-cartridges)**: Cartridge examples and test suites.
|
||||
|
||||
---
|
||||
|
||||
## 🛠️ Requisitos
|
||||
## 🛠️ Requirements
|
||||
|
||||
- **Rust**: Versão definida em `rust-toolchain.toml`.
|
||||
- **Instalação**: Use o [rustup](https://rustup.rs/) para instalar a toolchain necessária.
|
||||
- **Rust**: Version defined in `rust-toolchain.toml`.
|
||||
- **Installation**: Use [rustup](https://rustup.rs/) to install the required toolchain.
|
||||
|
||||
---
|
||||
|
||||
## ▶️ Início Rápido
|
||||
## ▶️ Quick Start
|
||||
|
||||
Para compilar o projeto completo:
|
||||
To compile the full project:
|
||||
|
||||
```bash
|
||||
cargo build
|
||||
```
|
||||
|
||||
Para rodar um cartucho de exemplo:
|
||||
To run an example cartridge:
|
||||
|
||||
```bash
|
||||
./target/debug/prometeu run test-cartridges/color-square
|
||||
```
|
||||
|
||||
Para mais detalhes sobre como usar a CLI, veja o README de **[prometeu](./crates/prometeu)**.
|
||||
For more details on how to use the CLI, see the **[prometeu](./crates/prometeu)** README.
|
||||
|
||||
---
|
||||
|
||||
## 🚧 Status do Projeto
|
||||
## 🚧 Project Status
|
||||
|
||||
⚠️ **Em estágio inicial (bootstrap)**
|
||||
⚠️ **Early stage (bootstrap)**
|
||||
|
||||
Atualmente o foco é na estabilização da arquitetura do core e do protocolo de depuração. Nada aqui deve ser considerado uma API estável ainda.
|
||||
Currently, the focus is on stabilizing the core architecture and debugging protocol. Nothing here should be considered a stable API yet.
|
||||
|
||||
---
|
||||
|
||||
## 📜 Licença
|
||||
## 📜 License
|
||||
|
||||
Este projeto está licenciado sob a Licença MIT - veja o arquivo [LICENSE](LICENSE) para detalhes.
|
||||
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
|
||||
|
||||
---
|
||||
|
||||
## ✨ Nota Final
|
||||
## ✨ Final Note
|
||||
|
||||
PROMETEU é tanto um projeto técnico quanto pedagógico. A ideia não é esconder complexidade, mas **expor a complexidade certa**, no nível certo, para que ela possa ser entendida, estudada e explorada.
|
||||
PROMETEU is both a technical and pedagogical project. The idea is not to hide complexity, but to **expose the right complexity**, at the right level, so it can be understood, studied, and explored.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user