@christianhugo/cli
Saltcorn command line interface
Usage
$ npm install -g @christianhugo/cli
$ saltcorn COMMAND
running command...
$ saltcorn (-v|--version|version)
@christianhugo/cli/0.7.3-beta.15 linux-x64 node-v16.14.0
$ saltcorn --help [COMMAND]
USAGE
$ saltcorn COMMAND
...
Commands
saltcorn add-schema
saltcorn backup
saltcorn build-app
saltcorn configuration-check
saltcorn create-tenant TENANT
saltcorn create-user
saltcorn delete-tenants
saltcorn delete-user USER_EMAIL
saltcorn fixtures
saltcorn get-cfg KEY
saltcorn help [COMMAND]
saltcorn info
saltcorn inspect TYPE [NAME]
saltcorn install-pack
saltcorn install-plugin
saltcorn list-tenants
saltcorn localize-plugin PLUGIN PATH
saltcorn make-migration
saltcorn saltcorn migrate
saltcorn modify-user USER_EMAIL
saltcorn plugins
saltcorn release VERSION
saltcorn reset-schema
saltcorn restore FILE
saltcorn rm-tenant
saltcorn run-benchmark [BASEURL]
saltcorn run-tests [PACKAGE]
saltcorn scheduler
saltcorn serve
saltcorn set-cfg KEY [VALUE]
saltcorn setup
saltcorn setup-benchmark
saltcorn test-plugin PATH
saltcorn transform-field EXPRESSION FIELD TABLE [TENANT]
saltcorn add-schema
Add Saltcorn schema to existing database
USAGE
$ saltcorn add-schema
OPTIONS
-f, --force force command execution
See code: src/commands/add-schema.js
saltcorn backup
Backup the PostgreSQL database to a file with pg_dump or zip
USAGE
$ saltcorn backup
OPTIONS
-o, --output=output output filename
-t, --tenant=tenant tenant
-z, --zip zip format
See code: src/commands/backup.js
saltcorn build-app
build mobile app
USAGE
$ saltcorn build-app
OPTIONS
-a, --appFileName=appFileName If set, the copied app will get this name
-b, --buildDirectory=buildDirectory A directory where the app should be build
-c, --copyAppDirectory=copyAppDirectory If set, the app file will be copied here
-d, --useDocker Use a docker container to build the app.
-l, --localUserTables=localUserTables user defined tables that should be replicated into the app
-p, --platforms=platforms Platforms to build for space separated list
-s, --serverURL=serverURL URL to a saltcorn server
-v, --entryPoint=entryPoint Entry Point
See code: src/commands/build-app.js
saltcorn configuration-check
Check configuration
USAGE
$ saltcorn configuration-check
OPTIONS
-t, --tenant=tenant tenant
See code: src/commands/configuration-check.js
saltcorn create-tenant TENANT
Create a tenant
USAGE
$ saltcorn create-tenant TENANT
ARGUMENTS
TENANT Tenant subdomain to create
OPTIONS
-d, --description=description Description of tenant
-e, --email=email Email of owner of tenant
See code: src/commands/create-tenant.js
saltcorn create-user
Create a new user
USAGE
$ saltcorn create-user
OPTIONS
-a, --admin Admin user
-e, --email=email email
-p, --password=password password
-r, --role=role role
-t, --tenant=tenant tenant
See code: src/commands/create-user.js
saltcorn delete-tenants
Delete inactive tenants
USAGE
$ saltcorn delete-tenants
See code: src/commands/delete-tenants.js
saltcorn delete-user USER_EMAIL
Delete user.
USAGE
$ saltcorn delete-user USER_EMAIL
ARGUMENTS
USER_EMAIL User to delete
OPTIONS
-f, --force force command execution
-t, --tenant=tenant tenant
DESCRIPTION
Command deletes the user specified by USER_EMAIL.
See code: src/commands/delete-user.js
saltcorn fixtures
Load fixtures for testing
USAGE
$ saltcorn fixtures
OPTIONS
-r, --reset Also reset schema
-t, --tenant=tenant tenant
DESCRIPTION
...
This manual step it is never required for users and rarely required for developers
See code: src/commands/fixtures.js
saltcorn get-cfg KEY
Get a configuration value. The value is printed to stdout as a JSON value
USAGE
$ saltcorn get-cfg KEY
ARGUMENTS
KEY Configuration key
OPTIONS
-p, --plugin=plugin plugin
-t, --tenant=tenant tenant
See code: src/commands/get-cfg.js
saltcorn help [COMMAND]
display help for saltcorn
USAGE
$ saltcorn help [COMMAND]
ARGUMENTS
COMMAND command to show help for
OPTIONS
--all see all commands in CLI
See code: @oclif/plugin-help
saltcorn info
Show paths
USAGE
$ saltcorn info
OPTIONS
-j, --json json format
DESCRIPTION
...
Show configuration and file store paths
ALIASES
$ saltcorn paths
See code: src/commands/info.js
saltcorn inspect TYPE [NAME]
Inspect an entity's JSON representation, or list entities
USAGE
$ saltcorn inspect TYPE [NAME]
ARGUMENTS
TYPE (view|page|trigger|table) Entity type
NAME Entity name. If not supplied, list all names
OPTIONS
-t, --tenant=tenant tenant
See code: src/commands/inspect.js
saltcorn install-pack
Install a pack
USAGE
$ saltcorn install-pack
OPTIONS
-f, --file=file File with pack JSON
-n, --name=name Pack name in store
-t, --tenant=tenant tenant
See code: src/commands/install-pack.js
saltcorn install-plugin
Install a plugin
USAGE
$ saltcorn install-plugin
OPTIONS
-d, --directory=directory Directory with local plugin
-n, --name=name Plugin name in store
-t, --tenant=tenant tenant
See code: src/commands/install-plugin.js
saltcorn list-tenants
List tenants in CSV format
USAGE
$ saltcorn list-tenants
See code: src/commands/list-tenants.js
saltcorn localize-plugin PLUGIN PATH
Convert plugin to local plugin
USAGE
$ saltcorn localize-plugin PLUGIN PATH
ARGUMENTS
PLUGIN Current plugin name
PATH Absolute path to local plugin
OPTIONS
-t, --tenant=tenant tenant
See code: src/commands/localize-plugin.js
saltcorn make-migration
Create a new blank Database structure migration file.
USAGE
$ saltcorn make-migration
DESCRIPTION
These migrations update database structure.
You should not normally need to run this
unless you are a developer.
See code: src/commands/make-migration.js
saltcorn saltcorn migrate
Run Database structure migrations
USAGE
$ saltcorn saltcorn migrate
DESCRIPTION
...
NOTE!
- Please stop Saltcorn before run DB migrations.
- Please make db backup before migration.
- There are no way to rollback migration if you doesn't make backup.
This is not normally required as migrations will be run when the server starts.
However, this command may be useful if you are running multiple application
servers and need to control when the migrations are run.
See code: src/commands/migrate.js
saltcorn modify-user USER_EMAIL
Modify (update) user.
USAGE
$ saltcorn modify-user USER_EMAIL
ARGUMENTS
USER_EMAIL User to modify
OPTIONS
-a, --admin make user be Admin
-e, --email=email new email
-i, --imode interactive mode
-p, --password=password new password
-r, --role=role new role (can conflict with -a option)
-t, --tenant=tenant tenant
DESCRIPTION
Command changes the user specified by USER_EMAIL.
You can change the user group, password and email.
NOTE that -a and -r role (--role=role) can give conflict.
See code: src/commands/modify-user.js
saltcorn plugins
List and upgrade plugins for tenants
USAGE
$ saltcorn plugins
OPTIONS
-d, --dryRun Upgrade dry-run
-f, --force Force update
-n, --name=name Plugin name
-u, --upgrade Upgrade
-v, --verbose Verbose output
DESCRIPTION
...
Extra documentation goes here
EXAMPLES
plugins -v - verbose output of commands
plugins -u -d - dry-run for plugin update
plugins -u -f - force plugin update
See code: src/commands/plugins.js
saltcorn release VERSION
Release a new saltcorn version
USAGE
$ saltcorn release VERSION
ARGUMENTS
VERSION New version number
See code: src/commands/release.js
saltcorn reset-schema
Reset the database
USAGE
$ saltcorn reset-schema
OPTIONS
-f, --force force command execution
-t, --tenant=tenant tenant
DESCRIPTION
...
This will delete all existing information
See code: src/commands/reset-schema.js
saltcorn restore FILE
Restore a previously backed up database (zip or sqlc format)
USAGE
$ saltcorn restore FILE
ARGUMENTS
FILE backup file to restore
OPTIONS
-t, --tenant=tenant tenant
See code: src/commands/restore.js
saltcorn rm-tenant
Remove a tenant.
USAGE
$ saltcorn rm-tenant
OPTIONS
-f, --force force command execution
-t, --tenant=tenant (required) tenant
DESCRIPTION
Attention! All tenant data will be lost!
It recommended to make backup of tenant before perform this command.
See code: src/commands/rm-tenant.js
saltcorn run-benchmark [BASEURL]
Run benchmark
USAGE
$ saltcorn run-benchmark [BASEURL]
ARGUMENTS
BASEURL Base URL
OPTIONS
-b, --benchmark=benchmark Which benchmark to run
-d, --delay=delay [default: 30] delay between runs (s)
-t, --token=token API Token for reporting results
See code: src/commands/run-benchmark.js
saltcorn run-tests [PACKAGE]
Run test suites
USAGE
$ saltcorn run-tests [PACKAGE]
ARGUMENTS
PACKAGE which package to run tests for
OPTIONS
-c, --coverage Coverage
-t, --testFilter=testFilter Filter tests by suite or test name
--watch Watch files for changes and rerun tests related to changed files.
--watchAll Watch files for changes and rerun all tests.
See code: src/commands/run-tests.js
saltcorn scheduler
Run the Saltcorn scheduler
USAGE
$ saltcorn scheduler
OPTIONS
-v, --verbose Verbose
See code: src/commands/scheduler.js
saltcorn serve
Start the Saltcorn server
USAGE
$ saltcorn serve
OPTIONS
-a, --addschema Add schema if missing
-d, --dev Run in dev mode and re-start on file changes
-n, --nomigrate No migrations
-p, --port=port [default: 3000] port
-r, --watchReaper Watch reaper
-s, --noscheduler No scheduler
-v, --verbose Verbose
See code: src/commands/serve.js
saltcorn set-cfg KEY [VALUE]
Set a configuration value. The supplied value (argument, or file stdin) will be parsed as JSON. If this fails, it is stored as a string.
USAGE
$ saltcorn set-cfg KEY [VALUE]
ARGUMENTS
KEY Configuration key
VALUE Configuration value (JSON or string)
OPTIONS
-f, --file=file file
-i, --stdin read value from stdin
-p, --plugin=plugin plugin
-t, --tenant=tenant tenant
See code: src/commands/set-cfg.js
saltcorn setup
Set up a new system
USAGE
$ saltcorn setup
OPTIONS
-c, --coverage Coverage
DESCRIPTION
...
This will attempt to install or connect a database, and set up a
configuration file
See code: src/commands/setup.js
saltcorn setup-benchmark
Setup an instance for benchmarking
USAGE
$ saltcorn setup-benchmark
OPTIONS
-t, --tenant=tenant tenant
See code: src/commands/setup-benchmark.js
saltcorn test-plugin PATH
Test a plugin
USAGE
$ saltcorn test-plugin PATH
ARGUMENTS
PATH path to plugin package
DESCRIPTION
...
Extra documentation goes here
See code: src/commands/test-plugin.js
saltcorn transform-field EXPRESSION FIELD TABLE [TENANT]
transform an existing field by applying a calculated expression
USAGE
$ saltcorn transform-field EXPRESSION FIELD TABLE [TENANT]
ARGUMENTS
EXPRESSION expression to calculate field
FIELD field name
TABLE table name
TENANT tenant name
See code: src/commands/transform-field.js