- Desenvolvida para tornar trechos de código em documentos realmente executáveis, aumentando a utilidade e a confiabilidade de runbooks, documentos operacionais e READMEs
- Executa os blocos de código do Markdown exatamente como estão, permitindo seguir e validar o documento facilmente passo a passo
- Executa comandos, verifica resultados intermediários e confirma se a saída desejada foi alcançada
- Suporta diversos runtimes com base em shebang, como Shell/Bash, Python, JavaScript/TypeScript e Ruby
- Ao executar células de código, mantém variáveis de ambiente e o contexto de execução, possibilitando uma execução passo a passo como em uma sessão de terminal
- Também oferece suporte a um fluxo de execução em pipeline que passa a saída da célula anterior para a próxima
- É totalmente compatível com definições de tarefas existentes como Makefile, npm scripts, Gradle e Deno task
- Com os comandos
run, list e print, é possível explorar, executar e validar workflows executáveis dentro dos documentos
- Reduz o problema de bitrot em documentos operacionais e é especialmente adequado para documentos práticos que exigem execução passo a passo
- bitrot: fenômeno em que documentos ou código perdem confiabilidade com o tempo por deixarem de refletir o ambiente real
- Pode ser instalado via Homebrew, npm, Go install ou binário único
- Licença Apache 2.0
Ainda não há comentários.