Package Exports
- @jrmc/adonis-lucid-commands
- @jrmc/adonis-lucid-commands/commands
- @jrmc/adonis-lucid-commands/commands/db/db_create
- @jrmc/adonis-lucid-commands/commands/db/db_drop
- @jrmc/adonis-lucid-commands/commands/list/list_databases
- @jrmc/adonis-lucid-commands/commands/list/list_tables
- @jrmc/adonis-lucid-commands/commands/main
Readme
@jrmc/adonis-lucid-commands
Additional commands for AdonisJS 6 Lucid ORM to help with database management and exploration.
Features
This package provides additional Ace commands for AdonisJS applications to manage and explore databases:
Database Management Commands
db:create
- Create a new databasedb:drop
- Drop an existing database (with production safety)
Database Exploration Commands
list:databases
- List all configured database connectionslist:tables
- List all tables in a specific database
Installation
npm install @jrmc/adonis-lucid-commands
Configuration
After installation, configure the package in your AdonisJS application:
node ace configure @jrmc/adonis-lucid-commands
This will automatically register the commands in your adonisrc.ts
file.
Usage
Database Management
Create a Database
# Create database using default connection
node ace db:create
# Create database using specific connection
node ace db:create --name=mysql
Drop a Database
# Drop database using default connection
node ace db:drop
# Drop database using specific connection
node ace db:drop --name=mysql
⚠️ Safety Note: The db:drop
command is disabled in production environments to prevent accidental data loss.
Database Exploration
List Database Connections
node ace list:databases
This command displays all configured database connections with their client type and database name.
List Tables
# List tables in default connection
node ace list:tables
# List tables in specific connection
node ace list:tables --name=mysql
This command shows all tables in the specified database connection. It supports multiple database clients:
- PostgreSQL - Uses
information_schema.tables
- MySQL - Uses
information_schema.tables
- SQLite - Uses
sqlite_master
- MSSQL - Uses
sys.tables
Supported Database Clients
The package supports the following database clients:
- PostgreSQL (
pg
,postgres
,postgresql
) - MySQL (
mysql
,mysql2
) - SQLite (
sqlite
,sqlite3
,better-sqlite3
) - Microsoft SQL Server (
mssql
)
Requirements
- AdonisJS Core:
^6.12.1
- AdonisJS Lucid:
^20.6.0 || ^21.0.0
License
MIT License - see LICENSE file for details.
Author
Jeremy Chaufourier - jeremy@chaufourier.fr