feat: funciones impuras migration_create, migration_up, migration_down, migration_status
Fase 2 del issue 0015. MigrationCreate (crea archivo .sql template con version auto-calculada), MigrationUp (aplica migraciones pendientes en transacciones individuales), MigrationDown (revierte ultimas N via down_sql de _migrations), MigrationGetStatus (cruza disco con BD, detecta orphaned). Tests de integracion: ciclo completo create->up->status->down->status. 26 tests, todos pasan. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,57 @@
|
||||
---
|
||||
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: [migration_status_go_infra]
|
||||
returns: [migration_status_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.
|
||||
Reference in New Issue
Block a user