Instalação

Guia completo: requisitos, ambiente virtual, Windows, editor e solução de problemas.

A forma mais rápida é o instalador: um comando, e o dataforge fica pronto. Ele não mexe no Python do sistema — cria um ambiente próprio em ~/.dataforge.

Instalação em um comando#

macOS e Linux#

curl -fsSL https://dataforge-lang.vercel.app/instalar.sh | sh

Com wget, se preferir:

wget -qO- https://dataforge-lang.vercel.app/instalar.sh | sh

Windows (PowerShell)#

irm https://dataforge-lang.vercel.app/instalar.ps1 | iex

O instalador acrescenta o DataForge ao PATH do usuário. Abra um terminal novo depois.

Ajustar a instalação#

# instalar em outro lugar
DATAFORGE_PREFIX=/opt/dataforge curl -fsSL https://dataforge-lang.vercel.app/instalar.sh | sh

# desinstalar é apagar a pasta
rm -rf ~/.dataforge

O editor, junto#

O instalador também instala a coloração de sintaxe no VS Code, Insiders, Cursor, VSCodium e Windsurf — todos os que encontrar. Reinicie o editor e todo .df abre com as palavras reservadas coloridas, 23 snippets e a indentação de 4 espaços que a linguagem exige.

dataforge editor           # refaz a instalação
dataforge editor status    # mostra onde está
DATAFORGE_SEM_EDITOR=1 …   # pula a etapa

Detalhes em Editor e cores.

Docker#

Sem instalar nada no seu sistema — nem Python:

# console interativo
docker run --rm -it estevan5s/dataforge repl

# rodar um arquivo da pasta atual
docker run --rm -v "$PWD:/app" estevan5s/dataforge run main.df

# a suíte de testes de um projeto
docker run --rm -v "$PWD:/app" estevan5s/dataforge test tests/

Um apelido no shell deixa o uso igual ao nativo:

alias dataforge='docker run --rm -it -v "$PWD:/app" estevan5s/dataforge'
dataforge run main.df

Construir a imagem você mesmo#

docker build -t estevan5s/dataforge:1.0.0 .
docker compose run --rm repl

A imagem é multi-estágio e roda como usuário sem privilégio. Cerca de 217 MB, a maior parte sendo o Python.

Baixar o tarball direto#

Se você prefere controlar cada passo:

curl -fsSL -O https://dataforge-lang.vercel.app/dist/dataforge-1.0.0.tar.gz
curl -fsSL -O https://dataforge-lang.vercel.app/dist/dataforge-1.0.0.tar.gz.sha256
shasum -a 256 -c dataforge-1.0.0.tar.gz.sha256

tar -xzf dataforge-1.0.0.tar.gz
cd dataforge-1.0.0
pip install .

A partir do código-fonte#

Requisitos#

DataForge é um interpretador escrito em Python puro. Não há dependências externas obrigatórias — nada de compilar, nada de toolchain.

Se você ainda não tem Python#

# macOS
brew install python@3.12

# Ubuntu / Debian
sudo apt update && sudo apt install -y python3 python3-pip python3-venv

No Windows, baixe em python.org/downloads e marque "Add Python to PATH" durante a instalação.

Clonar e instalar#

git clone https://github.com/estevam5s/DataForge.git
cd DataForge
pip install -e .

O -e instala em modo editável: mudanças no código valem na hora, sem reinstalar. É como você trabalha se for contribuir.

Ambiente virtual#

O ambiente virtual isola o DataForge do Python do sistema. É opcional, mas evita conflitos.

# macOS / Linux
python3 -m venv .venv
source .venv/bin/activate

# Windows (PowerShell)
python -m venv .venv
.venv\Scripts\Activate.ps1

O prompt passa a exibir (.venv). Para sair depois: deactivate.

Instalar#

pip install .              # instalação normal
pip install -e ".[dev]"    # editável, com pytest — para mexer no interpretador

O modo editável faz suas alterações em dataforge/*.py valerem imediatamente, sem reinstalar.

Editor#

A gramática TextMate para realce de sintaxe está em editor/vscode/:

mkdir -p ~/.vscode/extensions/dataforge
cp -r editor/vscode/* ~/.vscode/extensions/dataforge/

Reinicie o VS Code. Arquivos .df passam a ter realce.

Verificar a instalação#

dataforge version
python3 -m pytest tests/ -q          # 272 testes
python3 exercicios/run_all.py        # 190 exercícios

Problemas comuns#

`command not found: dataforge`#

O ambiente virtual não está ativo, ou o pip install não rodou. A alternativa que sempre funciona dentro da pasta do projeto é python3 -m dataforge run arquivo.df.

`No module named dataforge`#

Você está fora da pasta do projeto e não instalou o pacote. Instale com pip install . ou volte para a raiz do repositório.

`SyncError: Tab character detected`#

DataForge exige espaços, nunca tabs. No VS Code: paleta de comandos → "Convert Indentation to Spaces".

`SyncError: Indentation mismatch`#

Um bloco tem recuo inconsistente. Use sempre 4 espaços por nível.

Erro de build no `pip install`#

pip install --upgrade pip setuptools wheel

Desinstalar#

pip uninstall dataforge-lang

Se usou ambiente virtual, apagar a pasta .venv também resolve.