gcl26-testing-workshop - GitLite

KO | EN

gitlite — search

#cross-platform #rust #nodejs #claude #editor #kubernetes #database #ios #linux #vue

gcl26-testing-workshop

(★ 9)

Material dos participantes do workshop Go Testing Moderno na GopherCon LATAM 2026

파일 탐색기

ZIP 다운로드

- - cache.go
  - cache_bench_test.go
  - cache_test.go
  - README.md
- - codec.go
  - codec_fuzz_test.go
  - codec_test.go
  - README.md
- - lifecycle.go
  - lifecycle_test.go
  - README.md
- - contracts.go
  - contracts_test.go
  - README.md
- - README.md
  - store.go
  - store_test.go
- - cache.go
  - cache_test.go
  - README.md
- - README.md
  - watcher.go
  - watcher_test.go
- - README.md
  - shipping.go
  - shipping_test.go
- - normalize.go
  - normalize_fuzz_test.go
  - normalize_test.go
  - property_clinic_test.go
  - README.md
- check-progress.sh
- mutation-check.sh
- property-mutants.sh
- verify.sh
- - cache.go
  - cache_bench_test.go
  - cache_test.go
- - codec.go
  - codec_fuzz_test.go
  - codec_test.go
- - lifecycle.go
  - lifecycle_test.go
- - contracts.go
  - contracts_test.go
- - store.go
  - store_test.go
- - cache.go
  - cache_test.go
- fuzz-crasher
- property-tests-crasher
.gitignore
go.mod
go.sum
mise.toml
README.md
REFERENCES.md
SYLLABUS.md

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Material dos participantes para o workshop presencial sobre
recursos e técnicas recentes ou menos dominadas de teste em Go.

## Para quem é

O workshop pressupõe que você já:

- escreve testes de unidade em Go;
- conhece subtests e table-driven tests;
- entende goroutines, channels, interfaces e `context.Context`;
- consegue ler um benchmark simples com `b.N`.

Você pode participar sem conhecer fuzzing, `B.Loop`, `synctest` ou o perfil
`goroutineleak`.

## Preparação obrigatória

Use Go 1.27 diretamente ou instale-o com [mise](https://mise.jdx.dev/):

```bash
mise trust
mise install
mise exec -- go version
mise exec -- go mod download
mise run preflight
```

Sem mise:

```bash
go version
go mod download
bash scripts/verify.sh
```

A primeira linha de `go version` deve começar com `go version go1.27` e o
preflight deve terminar em `OK`. Depois de `go mod download`, todo o material
funciona offline. Docker, banco de dados, credenciais e serviços externos não
são necessários.

O workshop usa o race detector. Em Linux e outros sistemas não Darwin, ele
requer cgo, um compilador C instalado e uma plataforma suportada.

## Conteúdo

```text
exercises/
├── 01-benchmarks/         # B.Loop, workloads e benchstat
├── 02-fuzzing/            # propriedade, falha e regressão
├── 03-lifecycle/          # contexto, cleanup, saída e artefatos
├── 04-contracts/          # fstest e iotest
├── 05-failure-injection/  # erro controlado e estado parcial
├── 06-synctest/           # tempo virtual e HTTP em memória
├── 07-goroutine-leaks/    # perfil goroutineleak do Go 1.27
├── 08-mutation-testing/   # bônus: qualidade da suíte por mutantes
└── 09-property-tests/     # bônus: propriedades além do round-trip

support/                   # corpora de fallback e mutantes usados nos exercícios
```

Consulte [SYLLABUS.md](SYLLABUS.md) para a agenda e
[REFERENCES.md](REFERENCES.md) para a documentação primária.

As lições 08 e 09 são opcionais. Elas não bloqueiam `mise run progress` nem
alteram a agenda obrigatória.

## Fluxo de trabalho

Cada exercício contém contexto, tarefas, comandos e critério de conclusão. Os
starters compilam e marcam trabalho obrigatório com `TODO:` e `t.Skip`. Remova
cada marcador somente depois de implementar e validar a etapa correspondente.

Para estudar por conta própria, siga as lições 01 a 07 na ordem e depois as
opcionais. Execute todos os comandos a partir da raiz deste repositório. Os
blocos de comandos usam Bash. Se o Go foi instalado pelo mise, abra uma sessão
com esse ambiente antes de seguir as lições:

```bash
mise exec -- bash
go version
```

Mantenha essa sessão para os comandos `go`, scripts `bash` e loops das lições:
os subprocessos também precisam encontrar o Go 1.27. Se o Go já estiver no
`PATH`, use uma sessão Bash diretamente.

Em cada etapa, leia a base conceitual, escreva o resultado que espera observar,
implemente o teste e compare a execução com essa previsão. `SKIP` identifica
trabalho pendente; `PASS` só é evidência para as asserções realmente executadas.
Quando a atividade pede uma falha inicial, preserve a mensagem e o input antes
de corrigir a produção. Uma falha de compilação não substitui essa evidência.

Não apague todos os marcadores de uma vez. Substitua os placeholders, como
`_ = helper`, conforme usar as funções, trate os erros e remova cada `TODO:`
somente depois de conferir a etapa. Se ficar sem direção, use as pistas da
própria lição e registre entrada, resultado esperado e resultado observado.

Use os comandos documentados no `README.md` de cada exercício. Para acompanhar
o conjunto obrigatório:

```bash
mise run progress
```

Sem mise, o comando equivalente é:

```bash
bash scripts/check-progress.sh
```

No checkout inicial, ele deve falhar listando os `TODO:` ainda pendentes.
Depois dos sete exercícios obrigatórios, o resultado esperado é `PROGRESS OK`.
O script verifica ausência desses marcadores, executa os testes, faz uma
execução curta dos benchmarks e roda o race detector nos exercícios 06 e 07.
Ele não avalia a qualidade das asserções, não faz novas buscas de fuzzing nem
compara amostras com `benchstat`. Apagar marcadores sem concluir os exercícios
pode produzir um resultado verde sem evidência de aprendizado.

Antes de considerar uma lição concluída, confira a seção “Concluído quando”
do README correspondente e registre a evidência pedida: saída do teste, corpus
de regressão, comparação de benchmarks ou artefato, conforme a atividade.

## Comandos úteis

```bash
mise run test              # executa testes e corpora já preservados
mise run bench             # exercício 01
mise run fuzz              # exercício 02
mise run lifecycle         # exercício 03
mise run contracts         # exercício 04
mise run failure           # exercício 05
mise run synctest          # exercício 06, também com -race
mise run leaks             # exercício 07, também com -race
mise run mutation          # exercício bônus 08
mise run property          # exercício bônus 09
mise run property-mutants  # força das propriedades da lição 09
mise run preflight         # ambiente e integridade do kit
mise run progress          # progresso nos sete exercícios obrigatórios
```

`preflight` verde significa que o kit está pronto para o workshop. Não significa
que os exercícios foram resolvidos.