=head1 Name

sqitch-status - Show the current deployment status of a database

=head1 Synopsis

  sqitch [options] status [<options>] [<database>]

=head1 Description

Displays information about the current deployment status of a database. The
most recently deployed change information is displayed, as well as any related
tags. If there are undeployed changes in the plan, they will be listed.
Otherwise, a message will indicate that the database is up-to-date.

The C<< <database> >> parameter specifies the database to which to connect, and
may also be specified as the C<--target> option. It can be either a URI or the
name of a target in the configuration.

=head1 Options

=over

=item C<-t>

=item C<--target>

The target database to which to connect. This option can be either a URI or
the name of a target in the configuration.

=item C<--project>

Project for which to retrieve the status. Defaults to the status of the
current project, if a plan can be found.

=item C<--show-changes>

Also display a list of deployed changes.

=item C<--show-tags>

Also display a list of applied tags.

=item C<--date-format>

=item C<--date>

Format to use for timestamps. Defaults to C<iso>. Allowed values:

=over

=item C<iso>

=item C<iso8601>

Shows timestamps in ISO-8601 format.

=item C<rfc>

=item C<rfc2822>

Show timestamps in RFC-2822 format.

=item C<full>

=item C<long>

=item C<medium>

=item C<short>

Show timestamps in the specified format length, using the system locale's
C<LC_TIME> category.

=item C<raw>

Show timestamps in raw format, which is strict ISO-8601 in the UTC time zone.

=item C<strftime:$string>

Show timestamps using an arbitrary C<strftime> pattern. See
L<DateTime/strftime Paterns> for comprehensive documentation of supported
patterns.

=item C<cldr:$string>

Show timestamps using an arbitrary C<cldr> pattern. See L<DateTime/CLDR
Paterns> for comprehensive documentation of supported patterns.

=back

=back

=head1 Configuration Variables

=over

=item C<status.show_changes>

Boolean value indicates whether or not to display changes in the output.
Defaults to false.

=item C<status.show_tags>

Boolean value indicates whether or not to display tags in the output. Defaults
to false.

=item C<status.date_format>

Format to use for timestamps. Supports the same values as the C<--date-format>
option.

=back

=head1 Sqitch

Part of the L<sqitch> suite.
