examples/

README

Exemplos Loam

Este diretório contém exemplos de uso e provas de conceito do projeto Loam.

Estrutura

• Demos: Aplicações completas demonstrando casos de uso reais.
• Basics: Exemplos focados em funcionalidades específicas da API.
• Features: Exemplos focados em uma feature específica do core.
• Recipes: Receitas de uso comuns.
• Benchmarks: Benchmarks e stress tests isolados do core.
• Limitations: Casos limite e cenários de risco conhecidos.

Basics

• Hello World: O ponto de partida.
• CRUD: Operações básicas de Create, Read, Update, Delete.
• Configuration: Como configurar o Vault.
• Semantic Commits: Uso avançado de razões de mudança.

Recipes (Padrões de Uso)

• CLI Scripting: Scripts Shell (Bash/PowerShell) para ETL e automação.
• ETL & Migration: Técnicas de migração de dados legados.

Demos (Funcionalidades)

Projeto	Descrição
Calendar	Um assistente de agenda (Calendar as Code) usando commits semânticos.
Ledger	Um livro razão financeiro imutável.
ERP	Um mini-ERP usando links bidirecionais entre notas.
Conversion	Conversão de arquivos entre formatos suportados.
Formats	Demonstração de suporte a múltiplos formatos de arquivos.
Typed	Demonstração de suporte a TypedRetrieval (Typed Repository).
Stress Test	Demonstra a segurança de concorrência do Loam (100+ threads).
Benchmark	Compara performance de escritas individuais vs Batch Transactions.
Read-Only	Demonstra o acesso seguro a arquivos reais em modo go run.
Typed Watch	Demonstra reatividade em repositórios tipados.

Features (Funcionalidades Isoladas)

• Config Loading: Carregamento de configs sem sequestro da chave content.
• CSV Smart JSON: Parsing inteligente de JSON aninhado em CSV.
• Observability: Introspecao e diagnostico via introspection.

Benchmarks

• Scale Bench: Testes de escala e performance do adapter.

Limitations (Edge Cases)

• Smart CSV JSON: Demo de parsing de JSON aninhado em CSV.
• Strict YAML: Demo de fidelidade de tipos em YAML.

Como Executar

Go Examples (Demos & Basics)

Cada pasta nessas categorias é um módulo Go independente.

cd examples/demos/calendar
go mod tidy
go run .

Recipes (Scripts)

As receitas de scripting utilizam a CLI do Loam (loam) e scripts nativos do sistema.

# Unix (Linux/Mac/WSL)
cd examples/recipes/cli_scripting
./demo.sh

# Windows (PowerShell)
cd examples/recipes/cli_scripting
./demo.ps1