CLI

dataforge add

add, remove, install, list, search, pack e publish — o gerenciador de pacotes.

A referência completa do gerenciador está em Pacotes. Esta página é o resumo dos comandos.

add#

bash

dataforge add validador              # a versão mais recente, gravada como ^
dataforge add validador@1.2.0        # exata
dataforge add validador@^2.0         # faixa
dataforge add tabela datas cofre     # vários
dataforge add ../lib-interna         # pasta local
dataforge add git+https://github.com/voce/lib.git

Resolve, baixa, instala em forge_modules/, grava no forge.toml e atualiza o forge.lock.

remove#

bash

dataforge remove tabela
dataforge rm tabela          # o mesmo

install#

bash

dataforge install            # tudo o que o forge.toml declara
dataforge install --dry-run  # o plano, sem baixar
dataforge install --offline  # só com o cache local

É o comando que se roda depois de clonar um projeto, e na esteira de CI.

list#

bash

dataforge list

bash

meu-app 0.1.0
  ✓ datas@1.0.0
  ✓ tabela@1.0.0  (transitiva)
  ✓ validador@1.0.0

Um ✗ marca o que está no lock mas sumiu do disco — nesse caso, dataforge install reconstrói.

search#

bash

dataforge search cpf
dataforge search ""          # lista tudo

Procura no nome, na descrição e nas tags.

pack#

bash

dataforge pack

Gera dist/<nome>-<versao>.tar.gz com o sha256. Reprodutível: mesma fonte, mesmo hash.

publish#

bash

dataforge publish --registry=/caminho/do/registro

Veja Publicar um pacote.

Variáveis de ambiente#

Variável	Para que serve
`DATAFORGE_REGISTRY`	o índice a consultar
`DATAFORGE_REGISTRY_DIR`	a pasta padrão do `publish`