distutils.fancy_getopt
index
/usr/lib/python1.6/distutils/fancy_getopt.py

distutils.fancy_getopt
 
Wrapper around the standard getopt module that provides the following
additional features:
  * short and long options are tied together
  * options have help strings, so fancy_getopt could potentially
    create a complete usage summary
  * options set attributes of a passed-in object

 
Modules
            
getopt
re
string
sys

 
Classes
            
FancyGetopt
OptionDummy

 
class FancyGetopt
      Wrapper around the standard 'getopt()' module that provides some
handy extra functionality:
  * short and long options are tied together
  * options have help strings, and help text can be assembled
    from them
  * options set attributes of a passed-in object
  * boolean options can have "negative aliases" -- eg. if
    --quiet is the "negative alias" of --verbose, then "--quiet"
    on the command line sets 'verbose' to false
 
  
__init__(self, option_table=None)
_build_index(self)
_check_alias_dict(self, aliases, what)
_grok_option_table(self)
Populate the various data structures that keep tabs on
the option table.  Called by 'getopt()' before it can do
anything worthwhile.
add_option(self, long_option, short_option=None, help_string=None)
generate_help(self, header=None)
Generate help text (a list of strings, one per suggested line of
output) from the option table for this FancyGetopt object.
get_attr_name(self, long_option)
Translate long option name 'long_option' to the form it 
has as an attribute of some object: ie., translate hyphens
to underscores.
get_option_order(self)
Returns the list of (option, value) tuples processed by the
previous run of 'getopt()'.  Raises RuntimeError if
'getopt()' hasn't been called yet.
getopt(self, args=None, object=None)
Parse the command-line options in 'args' and store the results
as attributes of 'object'.  If 'args' is None or not supplied, uses
'sys.argv[1:]'.  If 'object' is None or not supplied, creates a new
OptionDummy object, stores option values there, and returns a tuple
(args, object).  If 'object' is supplied, it is modified in place
and 'getopt()' just returns 'args'; in both cases, the returned
'args' is a modified copy of the passed-in 'args' list, which is
left untouched.
has_option(self, long_option)
Return true if the option table for this parser has an
option with long name 'long_option'.
print_help(self, header=None, file=None)
set_aliases(self, alias)
Set the aliases for this option parser.
set_negative_aliases(self, negative_alias)
Set the negative aliases for this option parser.
'negative_alias' should be a dictionary mapping option names to
option names, both the key and value must already be defined
in the option table.
set_option_table(self, option_table)

 
class OptionDummy
      Dummy class just used as a place to hold command-line option
values as instance attributes.
 
  
__init__(self, options=[])
Create a new OptionDummy instance.  The attributes listed in
'options' will be initialized to None.

 
Functions
            
fancy_getopt(options, negative_opt, object, args)
wrap_text(text, width)

 
Data
             BufferType = <type 'buffer'>
BuiltinFunctionType = <type 'builtin_function_or_method'>
BuiltinMethodType = <type 'builtin_function_or_method'>
ClassType = <type 'class'>
CodeType = <type 'code'>
ComplexType = <type 'complex'>
DictType = <type 'dictionary'>
DictionaryType = <type 'dictionary'>
EllipsisType = <type 'ellipsis'>
FileType = <type 'file'>
FloatType = <type 'float'>
FrameType = <type 'frame'>
FunctionType = <type 'function'>
InstanceType = <type 'instance'>
IntType = <type 'int'>
LambdaType = <type 'function'>
ListType = <type 'list'>
LongType = <type 'long int'>
MethodType = <type 'instance method'>
ModuleType = <type 'module'>
NoneType = <type 'None'>
SliceType = <type 'slice'>
StringType = <type 'string'>
TracebackType = <type 'traceback'>
TupleType = <type 'tuple'>
TypeType = <type 'type'>
UnboundMethodType = <type 'instance method'>
UnicodeType = <type 'unicode'>
WS_TRANS = '\000\001\002\003\004\005\006\007\010 \016\017\020\021\022\023\024\025\026\027\030\031\032\033\034\035\036\037 !"#$%&\'()*+,-./...\317\320\321\322\323\324\325\326\327\330\331\332\333\334\335\336\337\340\341\342\343\344\345\346\347\350\351\352\353\354\355\356\357\360\361\362\363\364\365\366\367\370\371\372\373\374\375\376\377'
XRangeType = <type 'xrange'>
__file__ = '/usr/lib/python1.6/distutils/fancy_getopt.pyc'
__name__ = 'distutils.fancy_getopt'
__revision__ = '$Id: fancy_getopt.py,v 1.15 2000/08/07 00:45:51 gward Exp $'
_option_order = None
longopt_pat = '[a-zA-Z](?:[a-zA-Z0-9-]*)'
longopt_re = <SRE_Pattern object at 8313a48>
longopt_xlate = '\000\001\002\003\004\005\006\007\010\011\012\013\014\015\016\017\020\021\022\023\024\025\026\027\030\031\032\033\034\035\036\037 !"#$%&\'()*+,_./...\317\320\321\322\323\324\325\326\327\330\331\332\333\334\335\336\337\340\341\342\343\344\345\346\347\350\351\352\353\354\355\356\357\360\361\362\363\364\365\366\367\370\371\372\373\374\375\376\377'
neg_alias_re = <SRE_Pattern object at 8315f10>