capturatestdocs.dev
Testdocs — exemplos de documentação executáveis
Extrai blocos de código TypeScript de ficheiros Markdown e executa-os como testes, mantendo os exemplos sincronizados com o código.
mantemos
Prática de engenharia
Testes automatizados
Testes unitários rápidos, HTTP gravado, e documentação que faz falhar a compilação quando fica desatualizada.
- Vitest
- Playwright
- testdocs
- MSW
- Codecov
O que é
As verificações que permitem alterar uma base de código com confiança: testes rápidos à lógica, testes realistas às integrações, e alguns que conduzem a interface real.
Porque o escolhemos
O Vitest corre a maior parte, suficientemente próximo da compilação para que testes e código partilhem uma configuração. O HTTP de terceiros é gravado uma vez e reproduzido a seguir, o que mantém os testes de integração realistas e offline, em vez de instáveis ou fictícios. O Playwright cobre o punhado de percursos que só fazem sentido de ponta a ponta. O testdocs, que publicamos, executa os blocos de código dentro da nossa documentação como testes, por isso um exemplo que deixa de funcionar faz falhar a compilação em vez de enganar um leitor durante um ano.
Onde o usamos
Em cada repositório que mantemos, e como bibliotecas que publicamos porque primeiro precisámos delas.
capturauptask.dev
Uptask — executor de tarefas em TypeScript
Executor de tarefas em TypeScript que transforma funções exportadas em comandos de CLI sem código repetitivo.
mantemos
Entre em contacto
Diga-nos o que precisa de construir.
Somos uma equipa pequena em Portugal, a trabalhar no horário de Londres. Um site, uma aplicação, uma ferramenta interna, ou a plataforma por trás deles — comece por uma frase sobre o problema e nós tratamos do resto.