Update README.md
This commit is contained in:
153
README.md
153
README.md
@@ -1 +1,152 @@
|
|||||||
# reddust
|
# **RedDust Language**
|
||||||
|

|
||||||
|

|
||||||
|

|
||||||
|

|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
**RedDust** é uma linguagem minimalista projetada para simular lógica em computadores construídos com Redstone no *Minecraft*.
|
||||||
|
Este repositório contém o interpretador, suporte para sintaxe em múltiplos editores e scripts para instalação global.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## **📌 Funcionalidades**
|
||||||
|
✔ Interpretador `reddust` disponível globalmente
|
||||||
|
✔ `--help`, `--version`, `--debug` adicionados
|
||||||
|
✔ Ícone e associação de arquivos `.redd` no sistema
|
||||||
|
✔ Syntax Highlight para:
|
||||||
|
- [x] **VSCode**
|
||||||
|
- [x] **Geany**
|
||||||
|
- [x] **Vim**
|
||||||
|
- [ ] Nano (em breve)
|
||||||
|
✔ Instalação fácil via **curl**
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## **🚀 Instalação Rápida**
|
||||||
|
Execute:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -fsSL https://raw.githubusercontent.com/SynthX7/RedDust/main/redd-install.sh | bash
|
||||||
|
```
|
||||||
|
|
||||||
|
✅ Após a instalação:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
reddust --help
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## **🗑️ Desinstalação**
|
||||||
|
```bash
|
||||||
|
curl -fsSL https://raw.githubusercontent.com/SynthX7/RedDust/main/redd-uninstall.sh | bash
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## **📦 Requisitos**
|
||||||
|
- Linux (Debian/Ubuntu, Arch testado)
|
||||||
|
- **Python 3** (instalado automaticamente se não existir)
|
||||||
|
- Curl (`sudo apt-get install curl` ou `sudo pacman -S curl`)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## **📖 Como usar**
|
||||||
|
### **Modo arquivo**
|
||||||
|
```bash
|
||||||
|
reddust programa.redd
|
||||||
|
```
|
||||||
|
|
||||||
|
### **Modo interativo (REPL)**
|
||||||
|
```bash
|
||||||
|
reddust
|
||||||
|
```
|
||||||
|
|
||||||
|
### **Opções adicionais**
|
||||||
|
```
|
||||||
|
--help Mostra ajuda
|
||||||
|
--version Exibe versão do interpretador
|
||||||
|
--debug Executa mostrando estado da memória
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## **📂 Estrutura do Projeto**
|
||||||
|
```
|
||||||
|
RedDust/
|
||||||
|
├── highlighting
|
||||||
|
│ ├── geany-reddust
|
||||||
|
│ │ └── filetypes.reddust.conf
|
||||||
|
│ ├── vim-reddust
|
||||||
|
│ │ └── reddust.vim
|
||||||
|
│ └── vscode-reddust
|
||||||
|
│ ├── icon.png
|
||||||
|
│ ├── language-configuration.json
|
||||||
|
│ ├── package.json
|
||||||
|
│ ├── reddust-1.0.0.vsix
|
||||||
|
│ └── reddust.tmLanguage.json
|
||||||
|
├── icon
|
||||||
|
│ └── reddust.png
|
||||||
|
├── redd-install.sh
|
||||||
|
├── redd-uninstall.sh
|
||||||
|
└── reddust
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## **🖌 Suporte para editores**
|
||||||
|
✔ **VSCode:** instalado automaticamente pelo script
|
||||||
|
✔ **Geany:** syntax highlight básico
|
||||||
|
✔ **Vim:** syntax highlight com grupos (Keywords, Numbers, Comments)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## **📜 Exemplo de programa (`hello.redd`)**
|
||||||
|
```
|
||||||
|
// Solicita valor do usuário e exibe
|
||||||
|
1;1;0;0 // INPUT → mem[1]
|
||||||
|
2;1;0;0 // OUTPUT mem[1]
|
||||||
|
0;0;0;0 // HALT
|
||||||
|
```
|
||||||
|
|
||||||
|
Execute:
|
||||||
|
```bash
|
||||||
|
reddust hello.redd
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## **🔢 Tabela de Instruções**
|
||||||
|
| Código | Instrução | Descrição |
|
||||||
|
|--------|-------------------|----------------------------------------|
|
||||||
|
| 0 | HALT | Finaliza execução |
|
||||||
|
| 1 | INPUT | Lê valor do usuário (ou imediato) |
|
||||||
|
| 2 | OUTPUT | Exibe valor de um endereço |
|
||||||
|
| 3 | ADD | Soma (A+B → C) |
|
||||||
|
| 4 | SUB | Subtração (A-B → C) |
|
||||||
|
| 5 | DIV | Divisão inteira |
|
||||||
|
| 6 | MUL | Multiplicação |
|
||||||
|
| 7 | COND JUMP | Salta se valor = esperado |
|
||||||
|
| 8 | JUMP | Salto incondicional |
|
||||||
|
| 9 | CLEAR | Zera memória no endereço |
|
||||||
|
| A | RANDOM | Aleatório (0-15) em endereço |
|
||||||
|
| B | CMP GREATER | 1 se A>B, senão 0 |
|
||||||
|
| C | CMP EQUAL | 1 se A=B, senão 0 |
|
||||||
|
| D | MOVE | Copia valor entre endereços |
|
||||||
|
| E | INC/DEC | Incrementa ou decrementa (flag) |
|
||||||
|
| F | WAIT | Pausa em segundos |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## **📌 Roadmap**
|
||||||
|
- [ ] Suporte para Nano
|
||||||
|
- [ ] Pacote `.deb` e `.pkg.tar.zst`
|
||||||
|
- [ ] Simulador gráfico opcional
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## **👨💻 Autor**
|
||||||
|
**Syntax Echonomics**
|
||||||
|
[GitHub](https://github.com/SynthX7)
|
||||||
|
|||||||
Reference in New Issue
Block a user