Este guia é a referência canônica do Dev Toolkit: utilitários locais de painel duplo para semver, chmod, docker run → Compose e listas/JSON. Escolha um modo acima; tudo roda no navegador.

Dev Toolkit reúne seis transformações num painel estilo IDE. Cole à esquerda, escolha o modo e copie a saída estruturada à direita. Heurísticas da área de transferência podem sugerir Semver, Chmod ou Docker.

O que você obtém

• semver-parse — major/minor/patch, prerelease, build
• chmod-convert — octal ↔ symbolic (755 ↔ rwxr-xr-x)
• docker-compose — docker run → Compose YAML
• list-to-json — newline → JSON string array
• json-to-list — JSON array → newline list
• columns-to-json — header CSV → JSON objects (simple comma split)

Use quando

• Use quando: Semver / release notes / CI
• Use quando: chmod octal ↔ symbolic
• Use quando: docker run → Compose
• Use quando: list ↔ JSON cleanup

Modos do Dev Toolkit

Como esta ferramenta ajuda

1. Selecione o modo (Semver, Chmod, Docker Compose ou lista).
2. Cole a entrada à esquerda; em Docker comece com docker run; em Columns → JSON inclua o cabeçalho.
3. Leia o painel direito (e os blocos Semver/Chmod).
4. Copie a saída para Compose, docs, CI ou JSON Formatter.
5. Se houver erro, use os guias de correção; não mude de modo sem adaptar a entrada.

Modo: semver-parse — v?MAJOR.MINOR.PATCH[-pre][+build].

Quando usar

• Quando usar: changelog / flags
• Quando usar: normalize v1.0.0
• Quando usar: check prerelease/build

Erros comuns

• Erros comuns: 1.2 (need three parts)
• Erros comuns: ^1.2.3 ranges
• Erros comuns: Maven/CalVer

Modo: chmod-convert — octal ↔ rwxr-xr-x.

Quando usar

• Quando usar: Dockerfile 755 → symbolic
• Quando usar: ls -l → octal

Erros comuns

• Erros comuns: sticky bits round-trip
• Erros comuns: need nine r/w/x/- chars
• Erros comuns: permissions only

Modo: docker-compose — maps -e/-p/-v/--name only.

Quando usar

• Quando usar: one-liner → Compose starter
• Quando usar: document local deps

Flags mapeados

• -e / --env → environment
• -p / --publish → ports
• -v / --volume → volumes
• --name → service key

Erros comuns

• Erros comuns: must start with docker run
• Erros comuns: --rm/network/gpus ignored
• Erros comuns: missing image
• Erros comuns: complex quoting

Modo: list-to-json, json-to-list, columns-to-json.

List → JSON

Modo: list-to-json — trim lines, drop blanks, JSON array.

JSON → List

Modo: json-to-list — JSON array only; objects become [object Object].

Columns → JSON

Modo: columns-to-json — simple comma split, not full CSV. Use CSV Viewer for quoted commas.

Erros comuns: v2.4.0-rc.3+build for release checklist.

Como esta ferramenta ajuda

1. Selecione o modo (Semver, Chmod, Docker Compose ou lista).
2. Cole a entrada à esquerda; em Docker comece com docker run; em Columns → JSON inclua o cabeçalho.
3. Leia o painel direito (e os blocos Semver/Chmod).

Resultado: saída clara pronta para colar em docs, CI ou Compose.

Erros comuns: docker run -p/-e/--name only in README.

Como esta ferramenta ajuda

1. Selecione o modo (Semver, Chmod, Docker Compose ou lista).
2. Cole a entrada à esquerda; em Docker comece com docker run; em Columns → JSON inclua o cabeçalho.
3. Leia o painel direito (e os blocos Semver/Chmod).
4. Copie a saída para Compose, docs, CI ou JSON Formatter.

Resultado: saída clara pronta para colar em docs, CI ou Compose.

Erros comuns: messy lines → JSON array.

Como esta ferramenta ajuda

1. Selecione o modo (Semver, Chmod, Docker Compose ou lista).
2. Cole a entrada à esquerda; em Docker comece com docker run; em Columns → JSON inclua o cabeçalho.
3. Leia o painel direito (e os blocos Semver/Chmod).
4. Copie a saída para Compose, docs, CI ou JSON Formatter.

Resultado: saída clara pronta para colar em docs, CI ou Compose.

Erros comuns: Invalid semver — expected major.minor.patch.

Por que acontece

Por que acontece

Diagnóstico

Diagnóstico

Correções

1. Selecione o modo (Semver, Chmod, Docker Compose ou lista).
2. Cole a entrada à esquerda; em Docker comece com docker run; em Columns → JSON inclua o cabeçalho.
3. Leia o painel direito (e os blocos Semver/Chmod).

Erros comuns: missing networks/restart or docker run / image errors.

Por que acontece

Por que acontece

Diagnóstico

Diagnóstico

Correções

1. Selecione o modo (Semver, Chmod, Docker Compose ou lista).
2. Cole a entrada à esquerda; em Docker comece com docker run; em Columns → JSON inclua o cabeçalho.
3. Leia o painel direito (e os blocos Semver/Chmod).

Resultado: saída clara pronta para colar em docs, CI ou Compose.

• Columns → JSON em CSV com ponto e vírgula ou vírgulas entre aspas
• JSON → List com objeto que não é array
• Esperar round-trip perfeito de bits sticky no chmod
• Assumir que Docker preserva --rm, --network ou healthchecks
• Analisar intervalos semver como uma única versão