OpenAPI Fixer Toolkit

# Clone o projeto
git clone https://github.com/rafactx/openapi-fixer-v2.git
cd openapi-fixer-v2

# Configure automaticamente
pnpm setup

# Processar OpenAPI completo
pnpm hydrate openapi.json config.yaml dictionary.json summaries.json

# Corrigir schemas com espaços
pnpm fix-schemas openapi.json --verbose

# Corrigir problemas semânticos
pnpm fix-semantic openapi.json --verbose

# Executar todas as correções
pnpm fix-all

# Gerar template de configuração
pnpm export-config

python3 1_hydrate_openapi.py openapi.json config.yaml dictionary.json summaries.json

python3 2_fix_schema_names_and_refs.py openapi.json --verbose

python3 3_fix_semantic_paths.py openapi.json --config custom.yaml

# Pipeline completo
pnpm hydrate openapi.json config.yaml dictionary.json summaries.json
pnpm fix-all  # Executa schemas + semânticas automaticamente

# 1. Gere template
pnpm export-config

# 2. Edite corrections-template.yaml
- id: "custom_fix"
  action: "DELETE_KEY"
  path: "paths./users/{id}/get"
  details:
    key_to_delete: "deprecated_field"

# 3. Execute
pnpm fix-semantic openapi.json --config corrections-template.yaml

pnpm clean       # Limpa arquivos temporários
pnpm help        # Lista todos os comandos
python3 script.py --help  # Ajuda específica

# Erro: "No module named 'yaml'"
pip install PyYAML

# Erro: "Arquivo não encontrado"
ls -la openapi.json

# Problemas de encoding
# Certifique-se que arquivos estão em UTF-8