egutierrez
4ef5c6e5b8
Los IDs de tipos Go usan PascalCase: Migration_go_infra, MigrationStatus_go_infra. Actualizar los .md de todas las funciones migration para referenciar los IDs correctos. Re-indexar: 681 funciones, 109 tipos, 0 errores de validacion. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
58 lines
2.5 KiB
Markdown
58 lines
2.5 KiB
Markdown
---
|
|
name: migration_status
|
|
kind: function
|
|
lang: go
|
|
domain: infra
|
|
version: "1.0.0"
|
|
purity: impure
|
|
signature: "func MigrationGetStatus(db *sql.DB, dir string) ([]MigrationStatus, error)"
|
|
description: "Cruza los archivos .sql del directorio con los registros en _migrations y retorna una lista ordenada por version con el estado de cada migracion (applied/pending). Migraciones en BD pero sin archivo en disco se marcan como orphaned. Si _migrations no existe aun, todas las migraciones del directorio aparecen como pending."
|
|
tags: [migration, database, sql, schema, sqlite, status, list]
|
|
uses_functions: [migration_parse_go_infra]
|
|
uses_types: [MigrationStatus_go_infra]
|
|
returns: [MigrationStatus_go_infra]
|
|
returns_optional: false
|
|
error_type: "error_go_core"
|
|
imports: ["database/sql", "fmt", "sort", "strings", "time"]
|
|
params:
|
|
- name: db
|
|
desc: "conexion *sql.DB abierta a la base de datos SQLite (puede no tener _migrations aun)"
|
|
- name: dir
|
|
desc: "path al directorio con los archivos .sql de migracion (puede no existir)"
|
|
output: "slice de MigrationStatus ordenado por version ascendente con Applied y AppliedAt para cada migracion"
|
|
tested: true
|
|
tests:
|
|
- "migraciones en disco pero no en BD aparecen como pending"
|
|
- "migraciones aplicadas aparecen con Applied=true y AppliedAt"
|
|
- "migraciones aplicadas sin archivo en disco aparecen como orphaned"
|
|
- "base de datos sin tabla _migrations retorna todas como pending"
|
|
test_file_path: "functions/infra/migration_status_test.go"
|
|
file_path: "functions/infra/migration_status.go"
|
|
---
|
|
|
|
## Ejemplo
|
|
|
|
```go
|
|
db, _ := SQLiteOpen("", "apps/my_app/operations.db")
|
|
defer db.Close()
|
|
|
|
statuses, err := MigrationGetStatus(db, "apps/my_app/migrations")
|
|
if err != nil {
|
|
log.Fatal(err)
|
|
}
|
|
for _, s := range statuses {
|
|
if s.Applied {
|
|
fmt.Printf("%03d %-30s applied at %s\n", s.Version, s.Name, s.AppliedAt.Format(time.RFC3339))
|
|
} else {
|
|
fmt.Printf("%03d %-30s pending\n", s.Version, s.Name)
|
|
}
|
|
}
|
|
// 001 create_users applied at 2026-04-13T10:30:00Z
|
|
// 002 add_roles applied at 2026-04-13T10:30:00Z
|
|
// 003 add_audit_log pending
|
|
```
|
|
|
|
## Notas
|
|
|
|
Combina informacion de disco (archivos .sql) y BD (tabla _migrations) para dar una vision completa del estado. Las migraciones "orphaned" son aquellas que aparecen en `_migrations` pero ya no tienen archivo en disco — esto puede indicar que el archivo fue eliminado despues de aplicarse. La tabla `_migrations` se crea con `MigrationUp`; si no existe aun, `MigrationStatus` las trata todas como pending.
|