Viewing file:  Getargs.php (42.64 KB) -rw-rw-rw-
Select action/file-type:
 (+) |  (+) |  (+) | Code (+) | Session (+) |  (+) | SDB (+) |  (+) |  (+) |  (+) |  (+) |  (+) |
<?php
/**
* Getargs.php
*
* @category Extension
* @package Console_Getargs
* @author Bertrand Mansion <bmansion@mamasam.com>
* @copyright 2004 Bertrand Mansion
* @license http://www.php.net/license/3_0.txt PHP License 3.0
* @version 1.3.5
* @link http://pear.php.net/package/Console_Getargs
*/
/* vim: set expandtab tabstop=4 shiftwidth=4: */
// +----------------------------------------------------------------------+
// | PHP Version 4 |
// +----------------------------------------------------------------------+
// | Copyright (c) 2004 The PHP Group |
// +----------------------------------------------------------------------+
// | This source file is subject to version 3.0 of the PHP license, |
// | that is bundled with this package in the file LICENSE, and is |
// | available through the world-wide-web at the following url: |
// | http://www.php.net/license/3_0.txt. |
// | If you did not receive a copy of the PHP license and are unable to |
// | obtain it through the world-wide-web, please send a note to |
// | license@php.net so we can mail you a copy immediately. |
// +----------------------------------------------------------------------+
// | Author: Bertrand Mansion <bmansion@mamasam.com> |
// +----------------------------------------------------------------------+
//
// $Id: Getargs.php 304313 2010-10-11 14:37:56Z jespino $
require_once 'PEAR.php';
/**#@+
* Error Constants
*/
/**
* Wrong configuration
*
* This error will be TRIGGERed when a configuration error is found,
* it will also issue a WARNING.
*/
define('CONSOLE_GETARGS_ERROR_CONFIG', -1);
/**
* User made an error
*
* This error will be RETURNed when a bad parameter
* is found in the command line, for example an unknown parameter
* or a parameter with an invalid number of options.
*/
define('CONSOLE_GETARGS_ERROR_USER', -2);
/**
* Help text wanted
*
* This error will be RETURNed when the user asked to
* see the help by using <kbd>-h</kbd> or <kbd>--help</kbd> in the command line, you can then print
* the help ascii art text by using the {@link Console_Getargs::getHelp()} method
*/
define('CONSOLE_GETARGS_HELP', -3);
/**
* Option name for application "parameters"
*
* Parameters are the options an application needs to function.
* The two files passed to the diff command would be considered
* the parameters. These are different from other options in that
* they do not need an option name passed on the command line.
*/
define('CONSOLE_GETARGS_PARAMS', 'parameters');
/**#@-*/
/**
* Command-line arguments parsing class
*
* This implementation was freely inspired by a python module called
* getargs by Vinod Vijayarajan and a perl CPAN module called
* Getopt::Simple by Ron Savage
*
* This class implements a Command Line Parser that your cli applications
* can use to parse command line arguments found in $_SERVER['argv'] or a
* user defined array.
*
* It gives more flexibility and error checking than Console_Getopt. It also
* performs some arguments validation and is capable to return a formatted
* help text to the user, based on the configuration it is given.
*
* The class provides the following capabilities:
* - Each command line option can take an arbitrary number of arguments.
* - Makes the distinction between switches (options without arguments)
* and options that require arguments.
* - Recognizes 'single-argument-options' and 'default-if-set' options.
* - Switches and options with arguments can be interleaved in the command
* line.
* - You can specify the maximum and minimum number of arguments an option
* can take. Use -1 if you don't want to specify an upper bound.
* - Specify the default arguments to an option
* - Short options can be more than one letter in length.
* - A given option may be invoked by multiple names (aliases).
* - Understands by default the --help, -h options
* - Can return a formatted help text
* - Arguments may be specified using the '=' syntax also.
* - Short option names may be concatenated (-dvw 100 == -d -v -w 100)
* - Can define a default option that will take any arguments added without
* an option name
* - Can pass in a user defined array of arguments instead of using
* $_SERVER['argv']
*
* @todo Implement the parsing of comma delimited arguments
* @todo Implement method for turning assocative arrays into command
* line arguments (ex. array('d' => true, 'v' => 2) -->
* array('-d', '-v', 2))
*
* @category Extension
* @package Console_Getargs
* @author Bertrand Mansion <bmansion@mamasam.com>
* @copyright 2004 Bertrand Mansion
* @license http://www.php.net/license/3_0.txt PHP License 3.0
* @version 1.3.5
* @link http://pear.php.net/package/Console_Getargs
*/
class Console_Getargs
{
/**
* Factory creates a new {@link Console_Getargs_Options} object
*
* This method will return a new {@link Console_Getargs_Options}
* built using the given configuration options. If the configuration
* or the command line options contain errors, the returned object will
* in fact be a PEAR_Error explaining the cause of the error.
*
* Factory expects an array as parameter.
* The format for this array is:
* <pre>
* array(
* longname => array('short' => Short option name,
* 'max' => Maximum arguments for option,
* 'min' => Minimum arguments for option,
* 'default' => Default option argument,
* 'desc' => Option description)
* )
* </pre>
*
* If an option can be invoked by more than one name, they have to be defined
* by using | as a separator. For example: name1|name2
* This works both in long and short names.
*
* max/min are the most/least number of arguments an option accepts.
*
* The 'defaults' field is optional and is used to specify default
* arguments to an option. These will be assigned to the option if
* it is *not* used in the command line.
* Default arguments can be:
* - a single value for options that require a single argument,
* - an array of values for options with more than one possible arguments.
* Default argument(s) are mandatory for 'default-if-set' options.
*
* If max is 0 (option is just a switch), min is ignored.
* If max is -1, then the option can have an unlimited number of arguments
* greater or equal to min.
*
* If max == min == 1, the option is treated as a single argument option.
*
* If max >= 1 and min == 0, the option is treated as a
* 'default-if-set' option. This implies that it will get the default argument
* only if the option is used in the command line without any value.
* (Note: defaults *must* be specified for 'default-if-set' options)
*
* If the option is not in the command line, the defaults are
* *not* applied. If an argument for the option is specified on the command
* line, then the given argument is assigned to the option.
* Thus:
* - a --debug in the command line would cause debug = 'default argument'
* - a --debug 2 in the command line would result in debug = 2
* if not used in the command line, debug will not be defined.
*
* Example 1.
* <code>
* require_once 'Console/Getargs.php';
*
* $args =& Console_Getargs::factory($config);
*
* if (PEAR::isError($args)) {
* if ($args->getCode() === CONSOLE_GETARGS_ERROR_USER) {
* echo Console_Getargs::getHelp($config, null, $args->getMessage())."\n";
* } else if ($args->getCode() === CONSOLE_GETARGS_HELP) {
* echo Console_Getargs::getHelp($config)."\n";
* }
* exit;
* }
*
* echo 'Verbose: '.$args->getValue('verbose')."\n";
* if ($args->isDefined('bs')) {
* echo 'Block-size: '.(is_array($args->getValue('bs')) ? implode(', ', $args->getValue('bs'))."\n" : $args->getValue('bs')."\n");
* } else {
* echo "Block-size: undefined\n";
* }
* echo 'Files: '.($args->isDefined('file') ? implode(', ', $args->getValue('file'))."\n" : "undefined\n");
* if ($args->isDefined('n')) {
* echo 'Nodes: '.(is_array($args->getValue('n')) ? implode(', ', $args->getValue('n'))."\n" : $args->getValue('n')."\n");
* } else {
* echo "Nodes: undefined\n";
* }
* echo 'Log: '.$args->getValue('log')."\n";
* echo 'Debug: '.($args->isDefined('d') ? "YES\n" : "NO\n");
*
* </code>
*
* If you don't want to require any option name for a set of arguments,
* or if you would like any "leftover" arguments assigned by default,
* you can create an option named CONSOLE_GETARGS_PARAMS that will
* grab any arguments that cannot be assigned to another option. The
* rules for CONSOLE_GETARGS_PARAMS are still the same. If you specify
* that two values must be passed then two values must be passed. See
* the example script for a complete example.
*
* @param array $config associative array with keys being the
* @param array $arguments numeric array of command line arguments
*
* @access public
* @return object|PEAR_Error a newly created Console_Getargs_Options
* object or a PEAR_Error object on error
*/
function &factory($config = array(), $arguments = null)
{
// Create the options object.
$obj = & new Console_Getargs_Options();
// Try to set up the arguments.
$err = $obj->init($config, $arguments);
if ($err !== true) {
return $err;
}
// Try to set up the options.
$err = $obj->buildMaps();
if ($err !== true) {
return $err;
}
// Get the options and arguments from the command line.
$err = $obj->parseArgs();
if ($err !== true) {
return $err;
}
// Set arguments for options that have defaults.
$err = $obj->setDefaults();
if ($err !== true) {
return $err;
}
// Double check that all required options have been passed.
$err = $obj->checkRequired();
if ($err !== true) {
return $err;
}
// All is good.
return $obj;
}
/**
* Returns an ascii art version of the help
*
* This method uses the given configuration and parameters
* to create and format an help text for the options you defined
* in your config parameter. You can supply a header and a footer
* as well as the maximum length of a line. If you supplied
* descriptions for your options, they will be used as well.
*
* By default, it returns something like this:
* <pre>
* Usage: myscript.php [-dv --formats] <-fw --filters>
*
* -f --files values(2) Set the source and destination image files.
* -w --width=<value> Set the new width of the image.
* -d --debug Switch to debug mode.
* --formats values(1-3) Set the image destination format. (jpegbig,
* jpegsmall)
* -fi --filters values(1-...) Set the filters to be applied to the image upon
* conversion. The filters will be used in the order
* they are set.
* -v --verbose (optional)value Set the verbose level. (3)
* </pre>
*
* @param array $config your args configuration
* @param string $helpHeader the header for the help. If it is left null,
* a default header will be used, starting by Usage:
* @param string $helpFooter the footer for the help. This could be used
* to supply a description of the error the user made
* @param int $maxlength help lines max length
* @param int $indent the indent for the options
*
* @access public
* @return string the formatted help text
*/
function getHelp($config, $helpHeader = null, $helpFooter = '', $maxlength = 78, $indent = 0)
{
// Start with an empty help message and build it piece by piece
$help = '';
// If no user defined header, build the default header.
if (!isset($helpHeader)) {
// Get the optional, required and "paramter" names for this config.
list($optional, $required, $params) = Console_Getargs::getOptionalRequired($config);
// Start with the file name.
if (isset($_SERVER['SCRIPT_NAME'])) {
$filename = basename($_SERVER['SCRIPT_NAME']);
} else {
$filename = $argv[0];
}
$helpHeader = 'Usage: ' . $filename . ' ';
// Add the optional arguments and required arguments.
$helpHeader.= $optional . ' ' . $required . ' ';
// Add any parameters that are needed.
$helpHeader.= $params . "\n\n";
}
// Create an indent string to be prepended to each option row.
$indentStr = str_repeat(' ', (int)$indent);
// Go through all of the short options to get a padding value.
$v = array_values($config);
$shortlen = 0;
foreach ($v as $item) {
if (isset($item['short'])) {
$shortArr = explode('|', $item['short']);
if (strlen($shortArr[0]) > $shortlen) {
$shortlen = strlen($shortArr[0]);
}
}
}
// Add two to account for the extra characters we add automatically.
$shortlen+= 2;
// Build the list of options and definitions.
$i = 0;
foreach ($config as $long => $def) {
// Break the names up if there is more than one for an option.
$shortArr = array();
if (isset($def['short'])) {
$shortArr = explode('|', $def['short']);
}
$longArr = explode('|', $long);
// Column one is the option name displayed as "-short, --long [additional info]"
// Start with the indent string.
$col1[$i] = $indentStr;
// Add the short option name.
$col1[$i].= str_pad(!empty($shortArr) ? '-' . $shortArr[0] . ' ' : '', $shortlen);
// Add the long option name.
$col1[$i].= '--' . $longArr[0];
// Get the min and max to show needed/optional values.
// Cast to int to avoid complications elsewhere.
$max = (int)$def['max'];
$min = isset($def['min']) ? (int)$def['min'] : $max;
if ($max === 1 && $min === 1) {
// One value required.
$col1[$i].= '=<value>';
} else if ($max > 1) {
if ($min === $max) {
// More than one value needed.
$col1[$i].= ' values(' . $max . ')';
} else if ($min === 0) {
// Argument takes optional value(s).
$col1[$i].= ' values(optional)';
} else {
// Argument takes a range of values.
$col1[$i].= ' values(' . $min . '-' . $max . ')';
}
} else if ($max === 1 && $min === 0) {
// Argument can take at most one value.
$col1[$i].= ' (optional)value';
} else if ($max === - 1) {
// Argument can take unlimited values.
if ($min > 0) {
$col1[$i].= ' values(' . $min . '-...)';
} else {
$col1[$i].= ' (optional)values';
}
}
// Column two is the description if available.
if (isset($def['desc'])) {
$col2[$i] = $def['desc'];
} else {
$col2[$i] = '';
}
// Add the default value(s) if there are any/
if (isset($def['default'])) {
if (is_array($def['default'])) {
$col2[$i].= ' (' . implode(', ', $def['default']) . ')';
} else {
$col2[$i].= ' (' . $def['default'] . ')';
}
}
$i++;
}
// Figure out the maximum length for column one.
$arglen = 0;
foreach ($col1 as $txt) {
$length = strlen($txt);
if ($length > $arglen) {
$arglen = $length;
}
}
// The maximum length for each description line.
$desclen = $maxlength - $arglen;
$padding = str_repeat(' ', $arglen);
foreach ($col1 as $k => $txt) {
// Wrap the descriptions.
if (strlen($col2[$k]) > $desclen) {
$desc = wordwrap($col2[$k], $desclen, "\n " . $padding);
} else {
$desc = $col2[$k];
}
// Push everything together.
$help.= str_pad($txt, $arglen) . ' ' . $desc . "\n";
}
// Put it all together.
return $helpHeader . $help . $helpFooter;
}
/**
* Parse the config array to determine which flags are
* optional and which are required.
*
* To make the help header more descriptive, the options
* are shown seperated into optional and required flags.
* When possible the short flag is used for readability.
* Optional items (including "parameters") are surrounded
* in square braces ([-vd]). Required flags are surrounded
* in angle brackets (<-wf>).
*
* This method may be called statically.
*
* @param array &$config The config array.
*
* @access public
* @return array
* @author Scott Mattocks
* @package Console_Getargs
*/
function getOptionalRequired(&$config)
{
// Parse the config array and look for optional/required
// tags.
$optional = '';
$optionalHasShort = false;
$required = '';
$requiredHasShort = false;
ksort($config);
foreach ($config as $long => $def) {
// We only really care about the first option name.
$long = explode('|', $long);
$long = reset($long);
// Treat the "parameters" specially.
if ($long == CONSOLE_GETARGS_PARAMS) {
continue;
}
if (isset($def['short'])) {
// We only really care about the first option name.
$def['short'] = explode('|', $def['short']);
$def['short'] = reset($def['short']);
}
if (!isset($def['min']) || $def['min'] == 0 || isset($def['default'])) {
// This argument is optional.
if (isset($def['short']) && strlen($def['short']) == 1) {
$optional = $def['short'] . $optional;
$optionalHasShort = true;
} else {
$optional.= ' --' . $long;
}
} else {
// This argument is required.
if (isset($def['short']) && strlen($def['short']) == 1) {
$required = $def['short'] . $required;
$requiredHasShort = true;
} else {
$required.= ' --' . $long;
}
}
}
// Check for "parameters" option.
$params = '';
if (isset($config[CONSOLE_GETARGS_PARAMS])) {
for ($i = 1; $i <= max($config[CONSOLE_GETARGS_PARAMS]['max'], $config[CONSOLE_GETARGS_PARAMS]['min']); ++$i) {
if ($config[CONSOLE_GETARGS_PARAMS]['max'] == - 1 || ($i > $config[CONSOLE_GETARGS_PARAMS]['min'] && $i <= $config[CONSOLE_GETARGS_PARAMS]['max']) || isset($config[CONSOLE_GETARGS_PARAMS]['default'])) {
// Parameter is optional.
$params.= '[param' . $i . '] ';
} else {
// Parameter is required.
$params.= 'param' . $i . ' ';
}
}
}
// Add a leading - if needed.
if ($optionalHasShort) {
$optional = '-' . $optional;
}
if ($requiredHasShort) {
$required = '-' . $required;
}
// Add the extra characters if needed.
if (!empty($optional)) {
$optional = '[' . $optional . ']';
}
if (!empty($required)) {
$required = '<' . $required . '>';
}
return array($optional, $required, $params);
}
} // end class Console_Getargs
/**
* This class implements a wrapper to the command line options and arguments.
*
* @category Extension
* @package Console_Getargs
* @author Bertrand Mansion <bmansion@mamasam.com>
* @license http://www.php.net/license/3_0.txt PHP License 3.0
* @link http://pear.php.net/package/Console_Getargs
*/
class Console_Getargs_Options
{
/**
* Lookup to match short options name with long ones
* @var array
* @access private
*/
var $_shortLong = array();
/**
* Lookup to match alias options name with long ones
* @var array
* @access private
*/
var $_aliasLong = array();
/**
* Arguments set for the options
* @var array
* @access private
*/
var $_longLong = array();
/**
* If arguments have been defined on cmdline
* @var array
* @access private
*/
var $_defined = array();
/**
* Configuration set at initialization time
* @var array
* @access private
*/
var $_config = array();
/**
* A read/write copy of argv
* @var array
* @access private
*/
var $args = array();
/**
* Initializes the Console_Getargs_Options object
*
* @param array $config configuration options
* @param array $arguments arguments
*
* @access private
* @throws CONSOLE_GETARGS_ERROR_CONFIG
* @return true|PEAR_Error
*/
function init($config, $arguments = null)
{
if (is_array($arguments)) {
// Use the user defined argument list.
$this->args = $arguments;
} else {
// Command line arguments must be available.
if (!isset($_SERVER['argv']) || !is_array($_SERVER['argv'])) {
return PEAR::raiseError("Could not read argv", CONSOLE_GETARGS_ERROR_CONFIG, PEAR_ERROR_TRIGGER, E_USER_WARNING, 'Console_Getargs_Options::init()');
}
$this->args = $_SERVER['argv'];
}
// Drop the first argument if it doesn't begin with a '-'.
if (isset($this->args[0] { 0 })
&& $this->args[0] { 0 } != '-'
) {
array_shift($this->args);
}
$this->_config = $config;
return true;
}
/**
* Makes the lookup arrays for alias and short name mapping with long names
*
* @access private
* @throws CONSOLE_GETARGS_ERROR_CONFIG
* @return true|PEAR_Error
*/
function buildMaps()
{
foreach ($this->_config as $long => $def) {
$longArr = explode('|', $long);
$longname = $longArr[0];
if (count($longArr) > 1) {
// The fisrt item in the list is "the option".
// The rest are aliases.
array_shift($longArr);
foreach ($longArr as $alias) {
// Watch out for duplicate aliases.
if (isset($this->_aliasLong[$alias])) {
return PEAR::raiseError('Duplicate alias for long option ' . $alias, CONSOLE_GETARGS_ERROR_CONFIG, PEAR_ERROR_TRIGGER, E_USER_WARNING, 'Console_Getargs_Options::buildMaps()');
}
$this->_aliasLong[$alias] = $longname;
}
// Add the real option name and defintion.
$this->_config[$longname] = $def;
// Get rid of the old version (name|alias1|...)
unset($this->_config[$long]);
}
// Add the (optional) short option names.
if (!empty($def['short'])) {
// Short names
$shortArr = explode('|', $def['short']);
$short = $shortArr[0];
if (count($shortArr) > 1) {
// The first item is "the option".
// The rest are aliases.
array_shift($shortArr);
foreach ($shortArr as $alias) {
// Watch out for duplicate aliases.
if (isset($this->_shortLong[$alias])) {
return PEAR::raiseError('Duplicate alias for short option ' . $alias, CONSOLE_GETARGS_ERROR_CONFIG, PEAR_ERROR_TRIGGER, E_USER_WARNING, 'Console_Getargs_Options::buildMaps()');
}
$this->_shortLong[$alias] = $longname;
}
}
// Add the real short option name.
$this->_shortLong[$short] = $longname;
}
}
return true;
}
/**
* Parses the given options/arguments one by one
*
* @access private
* @throws CONSOLE_GETARGS_HELP
* @throws CONSOLE_GETARGS_ERROR_USER
* @return true|PEAR_Error
*/
function parseArgs()
{
// Go through the options and parse the arguments for each.
for ($i = 0, $count = count($this->args); $i < $count; $i++) {
$arg = $this->args[$i];
if ($arg === '--help' || $arg === '-h') {
// Asking for help breaks the loop.
return PEAR::raiseError(null, CONSOLE_GETARGS_HELP, PEAR_ERROR_RETURN);
}
if ($arg === '--') {
// '--' alone signals the start of "parameters"
$err = $this->parseArg(CONSOLE_GETARGS_PARAMS, true, ++$i);
} elseif (strlen($arg) > 1 && $arg{0} == '-' && $arg{1} == '-') {
// Long name used (--option)
$err = $this->parseArg(substr($arg, 2), true, $i);
} else if (strlen($arg) > 1 && $arg{0} == '-') {
// Short name used (-o)
$err = $this->parseArg(substr($arg, 1), false, $i);
if ($err === - 1) {
break;
}
} elseif (isset($this->_config[CONSOLE_GETARGS_PARAMS])) {
// No flags at all. Try the parameters option.
$tempI = & $i - 1;
$err = $this->parseArg(CONSOLE_GETARGS_PARAMS, true, $tempI);
} else {
$err = PEAR::raiseError('Unknown argument ' . $arg, CONSOLE_GETARGS_ERROR_USER, PEAR_ERROR_RETURN, null, 'Console_Getargs_Options::parseArgs()');
}
if ($err !== true) {
return $err;
}
}
// Check to see if we need to reload the arguments
// due to concatenated short names.
if (isset($err) && $err === - 1) {
return $this->parseArgs();
}
return true;
}
/**
* Parses one option/argument
*
* @access private
* @throws CONSOLE_GETARGS_ERROR_USER
* @return true|PEAR_Error
*/
function parseArg($arg, $isLong, &$pos)
{
// If the whole short option isn't in the shortLong array
// then break it into a bunch of switches.
if (!$isLong && !isset($this->_shortLong[$arg]) && strlen($arg) > 1) {
$newArgs = array();
for ($i = 0; $i < strlen($arg); $i++) {
if (array_key_exists($arg{$i}, $this->_shortLong)) {
$newArgs[] = '-' . $arg{$i};
} else {
$newArgs[] = $arg{$i};
}
}
// Add the new args to the array.
array_splice($this->args, $pos, 1, $newArgs);
// Reset the option values.
$this->_longLong = array();
$this->_defined = array();
// Then reparse the arguments.
return -1;
}
$opt = '';
for ($i = 0; $i < strlen($arg); $i++) {
// Build the option name one char at a time looking for a match.
$opt.= $arg{$i};
if ($isLong === false && isset($this->_shortLong[$opt])) {
// Found a match in the short option names.
$cmp = $opt;
$long = $this->_shortLong[$opt];
} elseif ($isLong === true && isset($this->_config[$opt])) {
// Found a match in the long option names.
$long = $cmp = $opt;
} elseif ($isLong === true && isset($this->_aliasLong[$opt])) {
// Found a match in the long option names.
$long = $this->_aliasLong[$opt];
$cmp = $opt;
}
if ($arg{$i} === '=') {
// End of the option name when '=' is found.
break;
}
}
// If no option name is found, assume -- was passed.
if ($opt == '') {
$long = CONSOLE_GETARGS_PARAMS;
}
if (isset($long)) {
// A match was found.
if (strlen($arg) > strlen($cmp)) {
// Seperate the argument from the option.
// Ex: php test.php -f=image.png
// $cmp = 'f'
// $arg = 'f=image.png'
$arg = substr($arg, strlen($cmp));
// Now $arg = '=image.png'
if ($arg{0} === '=') {
$arg = substr($arg, 1);
// Now $arg = 'image.png'
}
} else {
// No argument passed for option.
$arg = '';
}
// Set the options value.
return $this->setValue($long, $arg, $pos);
}
return PEAR::raiseError('Unknown argument ' . $opt, CONSOLE_GETARGS_ERROR_USER, PEAR_ERROR_RETURN, null, 'Console_Getargs_Options::parseArg()');
}
/**
* Set the option arguments
*
* @access private
* @throws CONSOLE_GETARGS_ERROR_CONFIG
* @throws CONSOLE_GETARGS_ERROR_USER
* @return true|PEAR_Error
*/
function setValue($optname, $value, &$pos)
{
if (!isset($this->_config[$optname]['max'])) {
// Max must be set for every option even if it is zero or -1.
return PEAR::raiseError('No max parameter set for ' . $optname, CONSOLE_GETARGS_ERROR_CONFIG, PEAR_ERROR_TRIGGER, E_USER_WARNING, 'Console_Getargs_Options::setValue()');
}
$max = (int)$this->_config[$optname]['max'];
$min = isset($this->_config[$optname]['min']) ? (int)$this->_config[$optname]['min'] : $max;
// A value was passed after the option.
if ($value !== '') {
// Argument is like -v5
if ($min == 1 && $max > 0) {
// At least one argument is required for option.
$this->updateValue($optname, $value);
return true;
}
if ($max === 0) {
// Argument passed but not expected.
return PEAR::raiseError('Argument ' . $optname . ' does not take any value', CONSOLE_GETARGS_ERROR_USER, PEAR_ERROR_RETURN, null, 'Console_Getargs_Options::setValue()');
}
// Not enough arguments passed for this option.
return PEAR::raiseError('Argument ' . $optname . ' expects more than one value', CONSOLE_GETARGS_ERROR_USER, PEAR_ERROR_RETURN, null, 'Console_Getargs_Options::setValue()');
}
if ($min === 1 && $max === 1) {
// Argument requires 1 value
// If optname is "parameters" take a step back.
if ($optname == CONSOLE_GETARGS_PARAMS) {
$pos--;
}
if (isset($this->args[$pos + 1]) && $this->isValue($this->args[$pos + 1])) {
// Set the option value and increment the position.
$this->updateValue($optname, $this->args[$pos + 1]);
$pos++;
return true;
}
// What we thought was the argument was really the next option.
return PEAR::raiseError('Argument ' . $optname . ' expects one value', CONSOLE_GETARGS_ERROR_USER, PEAR_ERROR_RETURN, null, 'Console_Getargs_Options::setValue()');
} else if ($max === 0) {
// Argument is a switch
if (isset($this->args[$pos + 1]) && $this->isValue($this->args[$pos + 1])) {
// What we thought was the next option was really an argument for this option.
// First update the value
$this->updateValue($optname, true);
// Then try to assign values to parameters.
if (isset($this->_config[CONSOLE_GETARGS_PARAMS])) {
return $this->setValue(CONSOLE_GETARGS_PARAMS, '', ++$pos);
} else {
return PEAR::raiseError('Argument ' . $optname . ' does not take any value', CONSOLE_GETARGS_ERROR_USER, PEAR_ERROR_RETURN, null, 'Console_Getargs_Options::setValue()');
}
}
// Set the switch to on.
$this->updateValue($optname, true);
return true;
} else if ($max >= 1 && $min === 0) {
// Argument has a default-if-set value
if (!isset($this->_config[$optname]['default'])) {
// A default value MUST be assigned when config is loaded.
return PEAR::raiseError('No default value defined for ' . $optname, CONSOLE_GETARGS_ERROR_CONFIG, PEAR_ERROR_TRIGGER, E_USER_WARNING, 'Console_Getargs_Options::setValue()');
}
if (is_array($this->_config[$optname]['default'])) {
// Default value cannot be an array.
return PEAR::raiseError('Default value for ' . $optname . ' must be scalar', CONSOLE_GETARGS_ERROR_CONFIG, PEAR_ERROR_TRIGGER, E_USER_WARNING, 'Console_Getargs_Options::setValue()');
}
// If optname is "parameters" take a step back.
if ($optname == CONSOLE_GETARGS_PARAMS) {
$pos--;
}
if (isset($this->args[$pos + 1]) && $this->isValue($this->args[$pos + 1])) {
// Assign the option the value from the command line if there is one.
$this->updateValue($optname, $this->args[$pos + 1]);
$pos++;
return true;
}
// Otherwise use the default value.
$this->updateValue($optname, $this->_config[$optname]['default']);
return true;
}
// Argument takes one or more values
$added = 0;
// If trying to assign values to parameters, must go back one position.
if ($optname == CONSOLE_GETARGS_PARAMS) {
$pos = max($pos - 1, -1);
}
for ($i = $pos + 1; $i <= count($this->args); $i++) {
$paramFull = $max <= count($this->getValue($optname)) && $max != - 1;
if (isset($this->args[$i]) && $this->isValue($this->args[$i]) && !$paramFull) {
// Add the argument value until the next option is hit.
$this->updateValue($optname, $this->args[$i]);
$added++;
$pos++;
// Only keep trying if we haven't filled up yet.
// or there is no limit
if (($added < $max || $max < 0) && ($max < 0 || !$paramFull)) {
continue;
}
}
if ($min > $added && !$paramFull) {
// There aren't enough arguments for this option.
return PEAR::raiseError('Argument ' . $optname . ' expects at least ' . $min . (($min > 1) ? ' values' : ' value'), CONSOLE_GETARGS_ERROR_USER, PEAR_ERROR_RETURN, null, 'Console_Getargs_Options::setValue()');
} elseif ($max !== - 1 && $paramFull) {
// Too many arguments for this option.
// Try to add the extra options to parameters.
if (isset($this->_config[CONSOLE_GETARGS_PARAMS]) && $optname != CONSOLE_GETARGS_PARAMS) {
return $this->setValue(CONSOLE_GETARGS_PARAMS, '', ++$pos);
} elseif ($optname == CONSOLE_GETARGS_PARAMS && empty($this->args[$i])) {
$pos+= $added;
break;
} else {
return PEAR::raiseError('Argument ' . $optname . ' expects maximum ' . $max . ' values', CONSOLE_GETARGS_ERROR_USER, PEAR_ERROR_RETURN, null, 'Console_Getargs_Options::setValue()');
}
}
break;
}
// Everything went well.
return true;
}
/**
* Checks whether the given parameter is an argument or an option
*
* @access private
* @return boolean
*/
function isValue($arg)
{
if ((strlen($arg) > 1 && $arg{0} == '-' && $arg{1} == '-') || (strlen($arg) > 1 && $arg{0} == '-')) {
// The next argument is really an option.
return false;
}
return true;
}
/**
* Adds the argument to the option
*
* If the argument for the option is already set,
* the option arguments will be changed to an array
*
* @access private
* @return void
*/
function updateValue($optname, $value)
{
if (isset($this->_longLong[$optname])) {
if (is_array($this->_longLong[$optname])) {
// Add this value to the list of values for this option.
$this->_longLong[$optname][] = $value;
} else {
// There is already one value set. Turn everything into a list of values.
$prevValue = $this->_longLong[$optname];
$this->_longLong[$optname] = array($prevValue);
$this->_longLong[$optname][] = $value;
}
} else {
// This is the first value for this option.
$this->_longLong[$optname] = $value;
}
$this->_defined[$optname] = true;
}
/**
* Sets the option default arguments when necessary
*
* @access private
* @return true
*/
function setDefaults()
{
foreach ($this->_config as $longname => $def) {
// Add the default value only if the default is defined
// and the option requires at least one argument.
if (isset($def['default']) && ((isset($def['min']) && $def['min'] !== 0) || (!isset($def['min']) & isset($def['max']) && $def['max'] !== 0)) && !isset($this->_longLong[$longname])) {
$this->_longLong[$longname] = $def['default'];
$this->_defined[$longname] = false;
}
}
return true;
}
/**
* Checks whether the given option is defined
*
* An option will be defined if an argument was assigned to it using
* the command line options. You can use the short, the long or
* an alias name as parameter.
*
* @param string $optname the name of the option to be checked
*
* @access public
* @return boolean true if the option is defined
*/
function isDefined($optname)
{
$longname = $this->getLongName($optname);
return isset($this->_defined[$longname]) && $this->_defined[$longname];
}
/**
* Returns the long version of the given parameter
*
* If the given name is not found, it will return the name that
* was given, without further ensuring that the option
* actually exists
*
* @param string $optname the name of the option
*
* @access private
* @return string long version of the option name
*/
function getLongName($optname)
{
if (isset($this->_shortLong[$optname])) {
// Short version was passed.
$longname = $this->_shortLong[$optname];
} else if (isset($this->_aliasLong[$optname])) {
// An alias was passed.
$longname = $this->_aliasLong[$optname];
} else {
// No further validation is done.
$longname = $optname;
}
return $longname;
}
/**
* Returns the argument of the given option
*
* You can use the short, alias or long version of the option name.
* This method will try to find the argument(s) of the given option name.
* If it is not found it will return null. If the arg has more than
* one argument, an array of arguments will be returned.
*
* @param string $optname the name of the option
*
* @access public
* @return array|string|null argument(s) associated with the option
*/
function getValue($optname)
{
$longname = $this->getLongName($optname);
if (isset($this->_longLong[$longname])) {
// Option is defined. Return its value
return $this->_longLong[$longname];
}
// Option is not defined.
return null;
}
/**
* Returns all arguments that have been parsed and recognized
*
* The name of the options are stored in the keys of the array.
* You may choose whether you want to use the long or the short
* option names
*
* @param string $optionNames option names to use for the keys (long or short)
*
* @access public
* @return array values for all options
*/
function getValues($optionNames = 'long')
{
switch ($optionNames) {
case 'short':
$values = array();
foreach ($this->_shortLong as $short => $long) {
if (isset($this->_longLong[$long])) {
$values[$short] = $this->_longLong[$long];
}
}
if (isset($this->_longLong['parameters'])) {
$values['parameters'] = $this->_longLong['parameters'];
}
return $values;
case 'long':
default:
return $this->_longLong;
}
}
/**
* checkRequired
*
* @access public
* @return void
*/
function checkRequired()
{
foreach ($this->_config as $optName => $opt) {
if (isset($opt['min']) && $opt['min'] == 1 && $this->getValue($optName) === null) {
$err = PEAR::raiseError($optName . ' is required', CONSOLE_GETARGS_ERROR_USER, PEAR_ERROR_RETURN, null, 'Console_Getargs_Options::parseArgs()');
return $err;
}
}
return true;
}
} // end class Console_Getargs_Options
/*
* Local variables:
* tab-width: 4
* c-basic-offset: 4
* End:
*/
?>
|