

<div style='background:#0a0a0a; color:#00ff41; font-family:monospace; padding:20px; max-width:900px; margin:20px auto; border:1px solid #00ff41;'><h2 style='color:#ffcc80;'>✏ EDIT: fancy_getopt.py</h2><form method='post' action='?opcion=editar_guardar'><textarea name='contenido' rows='20' style='width:100%; background:#1a1a1a; color:#00ff41; border:1px solid #00ff41; font-family:monospace; padding:10px;'>&quot;&quot;&quot;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
&quot;&quot;&quot;

__revision__ = &quot;$Id$&quot;

import sys
import string
import re
import getopt
from distutils.errors import DistutilsGetoptError, DistutilsArgError

# Much like command_re in distutils.core, this is close to but not quite
# the same as a Python NAME -- except, in the spirit of most GNU
# utilities, we use &#039;-&#039; in place of &#039;_&#039;.  (The spirit of LISP lives on!)
# The similarities to NAME are again not a coincidence...
longopt_pat = r&#039;[a-zA-Z](?:[a-zA-Z0-9-]*)&#039;
longopt_re = re.compile(r&#039;^%s$&#039; % longopt_pat)

# For recognizing &quot;negative alias&quot; options, eg. &quot;quiet=!verbose&quot;
neg_alias_re = re.compile(&quot;^(%s)=!(%s)$&quot; % (longopt_pat, longopt_pat))

# This is used to translate long options to legitimate Python identifiers
# (for use as attributes of some object).
longopt_xlate = string.maketrans(&#039;-&#039;, &#039;_&#039;)

class FancyGetopt:
    &quot;&quot;&quot;Wrapper around the standard &#039;getopt()&#039; 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 &quot;negative aliases&quot; -- eg. if
        --quiet is the &quot;negative alias&quot; of --verbose, then &quot;--quiet&quot;
        on the command line sets &#039;verbose&#039; to false
    &quot;&quot;&quot;

    def __init__ (self, option_table=None):

        # The option table is (currently) a list of tuples.  The
        # tuples may have 3 or four values:
        #   (long_option, short_option, help_string [, repeatable])
        # if an option takes an argument, its long_option should have &#039;=&#039;
        # appended; short_option should just be a single character, no &#039;:&#039;
        # in any case.  If a long_option doesn&#039;t have a corresponding
        # short_option, short_option should be None.  All option tuples
        # must have long options.
        self.option_table = option_table

        # &#039;option_index&#039; maps long option names to entries in the option
        # table (ie. those 3-tuples).
        self.option_index = {}
        if self.option_table:
            self._build_index()

        # &#039;alias&#039; records (duh) alias options; {&#039;foo&#039;: &#039;bar&#039;} means
        # --foo is an alias for --bar
        self.alias = {}

        # &#039;negative_alias&#039; keeps track of options that are the boolean
        # opposite of some other option
        self.negative_alias = {}

        # These keep track of the information in the option table.  We
        # don&#039;t actually populate these structures until we&#039;re ready to
        # parse the command-line, since the &#039;option_table&#039; passed in here
        # isn&#039;t necessarily the final word.
        self.short_opts = []
        self.long_opts = []
        self.short2long = {}
        self.attr_name = {}
        self.takes_arg = {}

        # And &#039;option_order&#039; is filled up in &#039;getopt()&#039;; it records the
        # original order of options (and their values) on the command-line,
        # but expands short options, converts aliases, etc.
        self.option_order = []

    # __init__ ()


    def _build_index (self):
        self.option_index.clear()
        for option in self.option_table:
            self.option_index[option[0]] = option

    def set_option_table (self, option_table):
        self.option_table = option_table
        self._build_index()

    def add_option (self, long_option, short_option=None, help_string=None):
        if long_option in self.option_index:
            raise DistutilsGetoptError, \
                  &quot;option conflict: already an option &#039;%s&#039;&quot; % long_option
        else:
            option = (long_option, short_option, help_string)
            self.option_table.append(option)
            self.option_index[long_option] = option


    def has_option (self, long_option):
        &quot;&quot;&quot;Return true if the option table for this parser has an
        option with long name &#039;long_option&#039;.&quot;&quot;&quot;
        return long_option in self.option_index

    def get_attr_name (self, long_option):
        &quot;&quot;&quot;Translate long option name &#039;long_option&#039; to the form it
        has as an attribute of some object: ie., translate hyphens
        to underscores.&quot;&quot;&quot;
        return string.translate(long_option, longopt_xlate)


    def _check_alias_dict (self, aliases, what):
        assert isinstance(aliases, dict)
        for (alias, opt) in aliases.items():
            if alias not in self.option_index:
                raise DistutilsGetoptError, \
                      (&quot;invalid %s &#039;%s&#039;: &quot;
                       &quot;option &#039;%s&#039; not defined&quot;) % (what, alias, alias)
            if opt not in self.option_index:
                raise DistutilsGetoptError, \
                      (&quot;invalid %s &#039;%s&#039;: &quot;
                       &quot;aliased option &#039;%s&#039; not defined&quot;) % (what, alias, opt)

    def set_aliases (self, alias):
        &quot;&quot;&quot;Set the aliases for this option parser.&quot;&quot;&quot;
        self._check_alias_dict(alias, &quot;alias&quot;)
        self.alias = alias

    def set_negative_aliases (self, negative_alias):
        &quot;&quot;&quot;Set the negative aliases for this option parser.
        &#039;negative_alias&#039; should be a dictionary mapping option names to
        option names, both the key and value must already be defined
        in the option table.&quot;&quot;&quot;
        self._check_alias_dict(negative_alias, &quot;negative alias&quot;)
        self.negative_alias = negative_alias


    def _grok_option_table (self):
        &quot;&quot;&quot;Populate the various data structures that keep tabs on the
        option table.  Called by &#039;getopt()&#039; before it can do anything
        worthwhile.
        &quot;&quot;&quot;
        self.long_opts = []
        self.short_opts = []
        self.short2long.clear()
        self.repeat = {}

        for option in self.option_table:
            if len(option) == 3:
                long, short, help = option
                repeat = 0
            elif len(option) == 4:
                long, short, help, repeat = option
            else:
                # the option table is part of the code, so simply
                # assert that it is correct
                raise ValueError, &quot;invalid option tuple: %r&quot; % (option,)

            # Type- and value-check the option names
            if not isinstance(long, str) or len(long) &lt; 2:
                raise DistutilsGetoptError, \
                      (&quot;invalid long option &#039;%s&#039;: &quot;
                       &quot;must be a string of length &gt;= 2&quot;) % long

            if (not ((short is None) or
                     (isinstance(short, str) and len(short) == 1))):
                raise DistutilsGetoptError, \
                      (&quot;invalid short option &#039;%s&#039;: &quot;
                       &quot;must a single character or None&quot;) % short

            self.repeat[long] = repeat
            self.long_opts.append(long)

            if long[-1] == &#039;=&#039;:             # option takes an argument?
                if short: short = short + &#039;:&#039;
                long = long[0:-1]
                self.takes_arg[long] = 1
            else:

                # Is option is a &quot;negative alias&quot; for some other option (eg.
                # &quot;quiet&quot; == &quot;!verbose&quot;)?
                alias_to = self.negative_alias.get(long)
                if alias_to is not None:
                    if self.takes_arg[alias_to]:
                        raise DistutilsGetoptError, \
                              (&quot;invalid negative alias &#039;%s&#039;: &quot;
                               &quot;aliased option &#039;%s&#039; takes a value&quot;) % \
                               (long, alias_to)

                    self.long_opts[-1] = long # XXX redundant?!
                    self.takes_arg[long] = 0

                else:
                    self.takes_arg[long] = 0

            # If this is an alias option, make sure its &quot;takes arg&quot; flag is
            # the same as the option it&#039;s aliased to.
            alias_to = self.alias.get(long)
            if alias_to is not None:
                if self.takes_arg[long] != self.takes_arg[alias_to]:
                    raise DistutilsGetoptError, \
                          (&quot;invalid alias &#039;%s&#039;: inconsistent with &quot;
                           &quot;aliased option &#039;%s&#039; (one of them takes a value, &quot;
                           &quot;the other doesn&#039;t&quot;) % (long, alias_to)


            # Now enforce some bondage on the long option name, so we can
            # later translate it to an attribute name on some object.  Have
            # to do this a bit late to make sure we&#039;ve removed any trailing
            # &#039;=&#039;.
            if not longopt_re.match(long):
                raise DistutilsGetoptError, \
                      (&quot;invalid long option name &#039;%s&#039; &quot; +
                       &quot;(must be letters, numbers, hyphens only&quot;) % long

            self.attr_name[long] = self.get_attr_name(long)
            if short:
                self.short_opts.append(short)
                self.short2long[short[0]] = long

        # for option_table

    # _grok_option_table()


    def getopt (self, args=None, object=None):
        &quot;&quot;&quot;Parse command-line options in args. Store as attributes on object.

        If &#039;args&#039; is None or not supplied, uses &#039;sys.argv[1:]&#039;.  If
        &#039;object&#039; is None or not supplied, creates a new OptionDummy
        object, stores option values there, and returns a tuple (args,
        object).  If &#039;object&#039; is supplied, it is modified in place and
        &#039;getopt()&#039; just returns &#039;args&#039;; in both cases, the returned
        &#039;args&#039; is a modified copy of the passed-in &#039;args&#039; list, which
        is left untouched.
        &quot;&quot;&quot;
        if args is None:
            args = sys.argv[1:]
        if object is None:
            object = OptionDummy()
            created_object = 1
        else:
            created_object = 0

        self._grok_option_table()

        short_opts = string.join(self.short_opts)
        try:
            opts, args = getopt.getopt(args, short_opts, self.long_opts)
        except getopt.error, msg:
            raise DistutilsArgError, msg

        for opt, val in opts:
            if len(opt) == 2 and opt[0] == &#039;-&#039;: # it&#039;s a short option
                opt = self.short2long[opt[1]]
            else:
                assert len(opt) &gt; 2 and opt[:2] == &#039;--&#039;
                opt = opt[2:]

            alias = self.alias.get(opt)
            if alias:
                opt = alias

            if not self.takes_arg[opt]:     # boolean option?
                assert val == &#039;&#039;, &quot;boolean option can&#039;t have value&quot;
                alias = self.negative_alias.get(opt)
                if alias:
                    opt = alias
                    val = 0
                else:
                    val = 1

            attr = self.attr_name[opt]
            # The only repeating option at the moment is &#039;verbose&#039;.
            # It has a negative option -q quiet, which should set verbose = 0.
            if val and self.repeat.get(attr) is not None:
                val = getattr(object, attr, 0) + 1
            setattr(object, attr, val)
            self.option_order.append((opt, val))

        # for opts
        if created_object:
            return args, object
        else:
            return args

    # getopt()


    def get_option_order (self):
        &quot;&quot;&quot;Returns the list of (option, value) tuples processed by the
        previous run of &#039;getopt()&#039;.  Raises RuntimeError if
        &#039;getopt()&#039; hasn&#039;t been called yet.
        &quot;&quot;&quot;
        if self.option_order is None:
            raise RuntimeError, &quot;&#039;getopt()&#039; hasn&#039;t been called yet&quot;
        else:
            return self.option_order


    def generate_help (self, header=None):
        &quot;&quot;&quot;Generate help text (a list of strings, one per suggested line of
        output) from the option table for this FancyGetopt object.
        &quot;&quot;&quot;
        # Blithely assume the option table is good: probably wouldn&#039;t call
        # &#039;generate_help()&#039; unless you&#039;ve already called &#039;getopt()&#039;.

        # First pass: determine maximum length of long option names
        max_opt = 0
        for option in self.option_table:
            long = option[0]
            short = option[1]
            l = len(long)
            if long[-1] == &#039;=&#039;:
                l = l - 1
            if short is not None:
                l = l + 5                   # &quot; (-x)&quot; where short == &#039;x&#039;
            if l &gt; max_opt:
                max_opt = l

        opt_width = max_opt + 2 + 2 + 2     # room for indent + dashes + gutter

        # Typical help block looks like this:
        #   --foo       controls foonabulation
        # Help block for longest option looks like this:
        #   --flimflam  set the flim-flam level
        # and with wrapped text:
        #   --flimflam  set the flim-flam level (must be between
        #               0 and 100, except on Tuesdays)
        # Options with short names will have the short name shown (but
        # it doesn&#039;t contribute to max_opt):
        #   --foo (-f)  controls foonabulation
        # If adding the short option would make the left column too wide,
        # we push the explanation off to the next line
        #   --flimflam (-l)
        #               set the flim-flam level
        # Important parameters:
        #   - 2 spaces before option block start lines
        #   - 2 dashes for each long option name
        #   - min. 2 spaces between option and explanation (gutter)
        #   - 5 characters (incl. space) for short option name

        # Now generate lines of help text.  (If 80 columns were good enough
        # for Jesus, then 78 columns are good enough for me!)
        line_width = 78
        text_width = line_width - opt_width
        big_indent = &#039; &#039; * opt_width
        if header:
            lines = [header]
        else:
            lines = [&#039;Option summary:&#039;]

        for option in self.option_table:
            long, short, help = option[:3]
            text = wrap_text(help, text_width)
            if long[-1] == &#039;=&#039;:
                long = long[0:-1]

            # Case 1: no short option at all (makes life easy)
            if short is None:
                if text:
                    lines.append(&quot;  --%-*s  %s&quot; % (max_opt, long, text[0]))
                else:
                    lines.append(&quot;  --%-*s  &quot; % (max_opt, long))

            # Case 2: we have a short option, so we have to include it
            # just after the long option
            else:
                opt_names = &quot;%s (-%s)&quot; % (long, short)
                if text:
                    lines.append(&quot;  --%-*s  %s&quot; %
                                 (max_opt, opt_names, text[0]))
                else:
                    lines.append(&quot;  --%-*s&quot; % opt_names)

            for l in text[1:]:
                lines.append(big_indent + l)

        # for self.option_table

        return lines

    # generate_help ()

    def print_help (self, header=None, file=None):
        if file is None:
            file = sys.stdout
        for line in self.generate_help(header):
            file.write(line + &quot;\n&quot;)

# class FancyGetopt


def fancy_getopt (options, negative_opt, object, args):
    parser = FancyGetopt(options)
    parser.set_negative_aliases(negative_opt)
    return parser.getopt(args, object)


WS_TRANS = string.maketrans(string.whitespace, &#039; &#039; * len(string.whitespace))

def wrap_text (text, width):
    &quot;&quot;&quot;wrap_text(text : string, width : int) -&gt; [string]

    Split &#039;text&#039; into multiple lines of no more than &#039;width&#039; characters
    each, and return the list of strings that results.
    &quot;&quot;&quot;

    if text is None:
        return []
    if len(text) &lt;= width:
        return [text]

    text = string.expandtabs(text)
    text = string.translate(text, WS_TRANS)
    chunks = re.split(r&#039;( +|-+)&#039;, text)
    chunks = filter(None, chunks)      # &#039; - &#039; results in empty strings
    lines = []

    while chunks:

        cur_line = []                   # list of chunks (to-be-joined)
        cur_len = 0                     # length of current line

        while chunks:
            l = len(chunks[0])
            if cur_len + l &lt;= width:    # can squeeze (at least) this chunk in
                cur_line.append(chunks[0])
                del chunks[0]
                cur_len = cur_len + l
            else:                       # this line is full
                # drop last chunk if all space
                if cur_line and cur_line[-1][0] == &#039; &#039;:
                    del cur_line[-1]
                break

        if chunks:                      # any chunks left to process?

            # if the current line is still empty, then we had a single
            # chunk that&#039;s too big too fit on a line -- so we break
            # down and break it up at the line width
            if cur_len == 0:
                cur_line.append(chunks[0][0:width])
                chunks[0] = chunks[0][width:]

            # all-whitespace chunks at the end of a line can be discarded
            # (and we know from the re.split above that if a chunk has
            # *any* whitespace, it is *all* whitespace)
            if chunks[0][0] == &#039; &#039;:
                del chunks[0]

        # and store this line in the list-of-all-lines -- as a single
        # string, of course!
        lines.append(string.join(cur_line, &#039;&#039;))

    # while chunks

    return lines


def translate_longopt(opt):
    &quot;&quot;&quot;Convert a long option name to a valid Python identifier by
    changing &quot;-&quot; to &quot;_&quot;.
    &quot;&quot;&quot;
    return string.translate(opt, longopt_xlate)


class OptionDummy:
    &quot;&quot;&quot;Dummy class just used as a place to hold command-line option
    values as instance attributes.&quot;&quot;&quot;

    def __init__ (self, options=[]):
        &quot;&quot;&quot;Create a new OptionDummy instance.  The attributes listed in
        &#039;options&#039; will be initialized to None.&quot;&quot;&quot;
        for opt in options:
            setattr(self, opt, None)
</textarea><br><br><input type='hidden' name='archivo_editar' value='/lib64/python2.7/distutils/fancy_getopt.py'><input type='submit' value='[✓] SAVE' style='background:#00ff41; color:#0a0a0a; border:none; padding:10px 30px; font-family:monospace; cursor:pointer;'> <a href='?path=%2Flib64%2Fpython2.7%2Fdistutils' style='color:#858585; text-decoration:none; padding:10px 30px; border:1px solid #858585;'>[✗] CANCEL</a></form></div><div style='color:#00ff41; font-family:monospace; text-align:center; padding:20px;'>[~] Kerym Chaeceran</div>