App::Pinto::Command::props

NAME

App::Pinto::Command::props - show or set stack properties

VERSION

version 0.14

SYNOPSIS

  pinto --root=REPOSITORY_ROOT props [OPTIONS] [STACK]

DESCRIPTION

This command shows or sets stack configuration properties. If the "--properties" option is given, then the properties will be set. If the "--properties" option is not given, then properties will just be shown.

COMMAND ARGUMENTS

If the "STACK" argument is given, then the properties for that stack will be set/shown. If the "STACK" argument is not given, then properties for the default stack will be set/shown.

COMMAND OPTIONS

--format=FORMAT_SPECIFICATION

Format the output using "printf"-style placeholders. This only matters when showing properties. Valid placeholders are:

  Placeholder    Meaning
  -----------------------------------------------------------------------------
  %p             Property name
  %v             Package value
    

--properties name=value

--prop name=value

-P name=value

Specifies property names and values. You can repeat this option to set multiple properties. If the property with that name does not already exist, it will be created. Property names must be alphanumeric plus hyphens and underscores, and will be forced to lower case. Setting a property to an empty string will cause it to be deleted. Properties starting with the prefix "pinto-" are reserved for internal use, SO DO NOT CREATE OR CHANGE THEM.

SUPPORTED PROPERTIES

The following properties are supported for each stack:

description

A description of the stack, usually to inform users of the application and/or environment that the stack is intended for. For a new stack, defaults to "The STACK_NAME stack". For a copied stack, defaults to "Copy of stack STACK_NAME".

target_perl_version

The version of perl that this stack is targeted at. This is used to determine whether a particular package is satisfied by the perl core and therefore does not need to be added to the stack. It must be a version string or number for an existing perl release, and cannot be later than the latest version specified in your Module::CoreList. To target even newer perls, just install the latest version of Module::CoreList. Remember that Pinto is often installed as a stand-alone application, so you will need to update Pinto's copy of Module::CoreList - for example:

 cpanm -L /opt/local/pinto/ Module::CoreList
    

AUTHOR

Jeffrey Ryan Thalhammer <[email protected]>

COPYRIGHT AND LICENSE

This software is copyright (c) 2015 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.