Command reference

Run unitautogen --help to list the five commands and unitautogen <command> --help for one command's full option list. Each command has its own page.

CommandPurposeEditionGenerates testsMain report and folder
unitautogenUnit tests and coverage for functions and triggersCommunityYesHTML and JSON. Tests in <out>/unit/<schema>/, CI bundle in <out>/unit/
unitautogen integrationTests across the real call mapTeamYesHTML and JSON. Tests in <out>/integration/<schema>/
unitautogen seccoverFull security-coverage reviewEnterpriseYesData security coverage, RLS policy and column-level reports and tests in <out>/security/<schema>/
unitautogen piiPII in error and RAISE messagesEnterpriseYesThe seccover output, plus <out>/pii_tests/
unitautogen hipaaHIPAA evidence, seccover plus the audit-log checkEnterpriseThrough seccover and the trigger tests<out>/hipaa/<schema>/hipaa_report.html and JSON, stamped

Common options

  • --schema a,b the schemas to cover
  • --like pat a name filter
  • --out DIR where tests and reports go
  • --html PATH the HTML report
  • --json PATH a machine-readable summary
  • --no-report skip the CI report bundle
  • --no-coverage generate and run only, faster
  • --include-extension also test extension-owned routines
  • --supabase run inside a Supabase project, see Supabase mode
  • --config FILE the config file, ./unitautogen.toml by default
  • --debug [LOGFILE] write a log file to send to support
  • --license PATH the licence file, if it is not found automatically

Paid commands find the licence file on their own, from unitautogen.lic in the folder you run from, or use --license PATH. See Prerequisites.