=head1 Name

sqitch-show - Show object information or script contents

=head1 Synopsis

  sqitch show [options] <type> <object>

=head1 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
L<sqitchchanges>. The supported types include:

=over

=item C<change>

A change object. Outputs the text used to generate the change SHA1 ID.

=item C<tag>

A tag. Outputs the text used to generate the tag SHA1 ID.

=item C<deploy>

A change deploy script.

=item C<revert>

A change revert script.

=item C<verify>

A change verify script.

=back

=head1 Options

=over

=item C<-t>

=item C<--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.

=item C<-e>

=item C<--exists>

Suppress all output; instead exit with zero status if C<< <object> >> exists
and is a valid object.

=item C<--plan-file>

=item C<-f>

Path to the deployment plan file. Overrides target, engine, and core
configuration values. Defaults to F<$top_dir/sqitch.plan>.

=back

=head2 Examples

=over

=item * Show information about a specific change:

  sqitch show change add_users_table

=item * Show information about a change by ID:

  sqitch show change be7cd00571d7151eacb0691e825dfc8980cc14ff

=item * Show the most recent change info:

  sqitch show change @HEAD

=item * Show information about a tag:

  sqitch show tag @beta1

=item * Show the contents of a deploy file:

  sqitch show deploy add_users_table@HEAD

=back

=head1 Sqitch

Part of the L<sqitch> suite.
