drift_devtools 0.0.15

A Flutter package that provides a visual interface for inspecting and debugging Drift databases in real-time.

Drift DevTools (Flutter)

Uma biblioteca utilitária para facilitar a inspeção e depuração de bancos de dados Drift (SQLite) em desenvolvimento. Fornece um exemplo simples que gera um arquivo .sqlite com dados de amostra e integra-se bem com a extensão VS Code "Drift Studio" para visualização em tempo real.

[DB Viewer Screenshot]

Principais recursos

• Exemplo mínimo de AppDatabase com tabelas Users, Books e Loans.
• Script de seed para popular um banco SQLite de exemplo.
• Arquivos gerados (*.g.dart) via build_runner já incluídos em lib/.
• Exemplo Flutter em example/ que abre a DB e mostra os registros em abas.
• Compatível com a extensão VS Code Drift Studio para inspecionar o arquivo .sqlite gerado.

Extensão recomendada: use a extensão do VS Code Drift Studio para uma visualização completa e interação com os arquivos gerados:

https://marketplace.visualstudio.com/items?itemName=ErickTarzia.drift-studio

Quick start

Requisitos:

• Flutter SDK (para rodar o exemplo UI)
• Dart SDK (para executar o exemplo de console)

Gerar e executar o exemplo (Flutter):

cd drift_devtools/example
flutter pub get
flutter run

Executar apenas o script Dart que cria o banco (sem UI Flutter):

cd drift_devtools
dart pub get
dart run lib/flutter_drift_example.dart

Ao rodar o exemplo você verá que o arquivo drift_devtools_example.sqlite é criado no diretório de trabalho. Abra a extensão Drift Studio no VS Code e aponte para esse arquivo (ou use o comando da extensão para conectar), ou simplesmente arraste/abra o arquivo no visualizador.

Uso no desenvolvimento

Se você modificar as tabelas dentro de lib/flutter_drift_example.dart, gere os arquivos com:

dart pub get
dart run build_runner build --delete-conflicting-outputs

Os arquivos *.g.dart serão gerados ao lado dos arquivos anotados (ex.: lib/flutter_drift_example.g.dart). O exemplo do example/ já depende do pacote via path: .. para facilitar execução local.

Exemplo rápido (snippet)

final db = AppDatabase();
await db.seed(); // popula com dados de exemplo
final users = await db.allUsers();
print(users);
await db.close();

Contribuições

Contribuições são bem-vindas. Abra issues ou PRs com pequenos passos reproduzíveis. Para extensões e integração com a extensão VS Code, veja o repositório principal drift-studio.

Licença

Veja o arquivo LICENSE na raiz do repositório.