table of contents
sqitch-show(3pm) | User Contributed Perl Documentation | sqitch-show(3pm) |
Name¶
sqitch-show - Show object information or script contents
Synopsis¶
sqitch show [options] <type> <object>
Description¶
Shows information about Sqitch objects. The first argument must be the type of object to show, and the second must be a key identifier for the object in the plan. The second argument must be a a change name or tag as specified in sqitchchanges. The supported types include:
- "change"
- A change object. Outputs the text used to generate the change SHA1 ID.
- "tag"
- A tag. Outputs the text used to generate the tag SHA1 ID.
- "deploy"
- A change deploy script.
- "revert"
- A change revert script.
- "verify"
- A change verify script.
Options¶
- "-t"
- "--target"
- The target database, the plan for which should be read before deciding what object to show. This option should be the name of a target in the configuration.
- "-e"
- "--exists"
- Suppress all output; instead exit with zero status if "<object>" exists and is a valid object.
- "--plan-file"
- "-f"
- Path to the deployment plan file. Overrides target, engine, and core configuration values. Defaults to $top_dir/sqitch.plan.
Examples¶
- Show information about a specific change:
sqitch show change add_users_table
- Show information about a change by ID:
sqitch show change be7cd00571d7151eacb0691e825dfc8980cc14ff
- Show the most recent change info:
sqitch show change @HEAD
- Show information about a tag:
sqitch show tag @beta1
- Show the contents of a deploy file:
sqitch show deploy add_users_table@HEAD
Sqitch¶
Part of the sqitch suite.
2024-10-19 | perl v5.40.0 |