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.
- Recipes: Receitas de uso comuns.
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. |
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
Directories
¶
| Path | Synopsis |
|---|---|
|
demos
|
|
|
readonly
command
|
|
|
typed-watch
command
|
|
|
features
|
|
|
csv_smart_json
command
|
|
|
csv_smart_json/typed
command
|
|
|
observability
command
|
|
|
limitations
|
|
|
csv_smart_json_edge_case
command
|
|
|
strict_yaml_fidelity
command
|
Click to show internal directories.
Click to hide internal directories.