# ABSTRACT: mark the default stack
package App::Pinto::Command::default;
use strict;
use warnings;
#-----------------------------------------------------------------------------
use base 'App::Pinto::Command';
#------------------------------------------------------------------------------
our $VERSION = '0.09992'; # VERSION
#------------------------------------------------------------------------------
sub opt_spec {
my ( $self, $app ) = @_;
return ( [ 'none' => 'Unmark the default stack' ] );
}
#-----------------------------------------------------------------------------
sub validate_args {
my ( $self, $opts, $args ) = @_;
$self->usage_error('Cannot specify multiple stacks')
if @{$args} > 1;
$self->usage_error('Must specify a STACK or --none')
if !( @{$args} xor $opts->{none} );
return 1;
}
#------------------------------------------------------------------------------
sub execute {
my ( $self, $opts, $args ) = @_;
$opts->{stack} = $args->[0] if $args->[0];
my $result = $self->pinto->run( $self->action_name, %{$opts} );
return $result->exit_status;
}
#------------------------------------------------------------------------------
1;
__END__
=pod
=encoding UTF-8
=for :stopwords Jeffrey Ryan Thalhammer unmark unmarks
=head1 NAME
App::Pinto::Command::default - mark the default stack
=head1 VERSION
version 0.09992
=head1 SYNOPSIS
pinto --root=REPOSITORY_ROOT default [OPTIONS] [STACK]
=head1 DESCRIPTION
This command marks the given C<STACK> as the default stack for the
repository. The existing default stack (if one exists) is thereby
unmarked. The default stack is used by most L<pinto> commands where a
stack is not explicitly specified either by option or argument.
If the C<--none> option is given instead of a C<STACK> argument, then
the default stack is unmarked (if one exists). When a repository has
no default stack, you will have to explicitly specify the stack
as option or argument for most L<pinto> commands.
Use the L<stacks|App::Pinto::Command::stacks> command to list the
stacks that currently exist in the repository and show which one is
the default.
=head1 BEWARE
Think carefully before changing the default stack. This will
dramatically affect all users of the repository, so it is wise to
notify them well in advance.
=head1 COMMAND ARGUMENTS
The argument is the name of the stack you wish to mark as the default.
The stack must already exist. A stack argument cannot be used when the
C<--none> option is specified.
=head1 COMMAND OPTIONS
=over 4
=item --none
Unmarks the default stack (if one exists). This option cannot be used
when the C<STACK> argument is specified.
=back
=head1 AUTHOR
Jeffrey Ryan Thalhammer <jeff@stratopan.com>
=head1 COPYRIGHT AND LICENSE
This software is copyright (c) 2014 by Jeffrey Ryan Thalhammer.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
=cut