parameters: (self)
return_statement: return 1
docstring: Parse the setup script's command line, taken from the
          'script_args' instance attribute (which defaults to 'sys.argv[1:]'
          -- see 'setup()' in core.py).  This list is first processed for
          "global options" -- options that set attributes of the Distribution
          instance.  Then, it is alternately scanned for Distutils commands
          and options for that command.  Each new command terminates the
          options for the previous command.  The allowed options for a
          command are determined by the 'user_options' attribute of the
          command class -- thus, we have to be able to load command classes
          in order to parse the command line.  Any error in that 'options'
          attribute raises DistutilsGetoptError; any error on the
          command-line raises DistutilsArgError.  If no Distutils commands
          were found on the command line, raises DistutilsArgError.  Return
          true if command-line was successfully parsed and we should carry
          on with executing commands; false if no errors but we shouldn't
          execute commands (currently, this only happens if user asks for
          help).
docstring_summary: Parse the setup script's command line, taken from the
          'script_args' instance attribute (which defaults to 'sys.argv[1:]'
          -- see 'setup()' in core.py).  This list is first processed for
          "global options" -- options that set attributes of the Distribution
          instance.  Then, it is alternately scanned for Distutils commands
          and options for that command.  Each new command terminates the
          options for the previous command.  The allowed options for a
          command are determined by the 'user_options' attribute of the
          command class -- thus, we have to be able to load command classes
          in order to parse the command line.  Any error in that 'options'
          attribute raises DistutilsGetoptError; any error on the
          command-line raises DistutilsArgError.  If no Distutils commands
          were found on the command line, raises DistutilsArgError.  Return
          true if command-line was successfully parsed and we should carry
          on with executing commands; false if no errors but we shouldn't
          execute commands (currently, this only happens if user asks for
          help).
docstring_tokens: Parse the setup script s command line taken from the script_args instance attribute ( which defaults to sys . argv [ 1 : ] -- see setup () in core . py ) . This list is first processed for global options -- options that set attributes of the Distribution instance . Then it is alternately scanned for Distutils commands and options for that command . Each new command terminates the options for the previous command . The allowed options for a command are determined by the user_options attribute of the command class -- thus we have to be able to load command classes in order to parse the command line . Any error in that options attribute raises DistutilsGetoptError ; any error on the command - line raises DistutilsArgError . If no Distutils commands were found on the command line raises DistutilsArgError . Return true if command - line was successfully parsed and we should carry on with executing commands ; false if no errors but we shouldn t execute commands ( currently this only happens if user asks for help ) .
function: def parse_command_line(self):
          """Parse the setup script's command line, taken from the
          'script_args' instance attribute (which defaults to 'sys.argv[1:]'
          -- see 'setup()' in core.py).  This list is first processed for
          "global options" -- options that set attributes of the Distribution
          instance.  Then, it is alternately scanned for Distutils commands
          and options for that command.  Each new command terminates the
          options for the previous command.  The allowed options for a
          command are determined by the 'user_options' attribute of the
          command class -- thus, we have to be able to load command classes
          in order to parse the command line.  Any error in that 'options'
          attribute raises DistutilsGetoptError; any error on the
          command-line raises DistutilsArgError.  If no Distutils commands
          were found on the command line, raises DistutilsArgError.  Return
          true if command-line was successfully parsed and we should carry
          on with executing commands; false if no errors but we shouldn't
          execute commands (currently, this only happens if user asks for
          help).
          """
          #
          # We now have enough information to show the Macintosh dialog
          # that allows the user to interactively specify the "command line".
          #
          toplevel_options = self._get_toplevel_options()
  
          # We have to parse the command line a bit at a time -- global
          # options, then the first command, then its options, and so on --
          # because each command will be handled by a different class, and
          # the options that are valid for a particular class aren't known
          # until we have loaded the command class, which doesn't happen
          # until we know what the command is.
  
          self.commands = []
          parser = FancyGetopt(toplevel_options + self.display_options)
          parser.set_negative_aliases(self.negative_opt)
          parser.set_aliases({'licence': 'license'})
          args = parser.getopt(args=self.script_args, object=self)
          option_order = parser.get_option_order()
          log.set_verbosity(self.verbose)
  
          # for display options we return immediately
          if self.handle_display_options(option_order):
              return
          while args:
              args = self._parse_command_opts(parser, args)
              if args is None:            # user asked for help (and got it)
                  return
  
          # Handle the cases of --help as a "global" option, ie.
          # "setup.py --help" and "setup.py --help command ...".  For the
          # former, we show global options (--verbose, --dry-run, etc.)
          # and display-only options (--name, --version, etc.); for the
          # latter, we omit the display-only options and show help for
          # each command listed on the command line.
          if self.help:
              self._show_help(parser,
                              display_options=len(self.commands) == 0,
                              commands=self.commands)
              return
  
          # Oops, no commands found -- an end-user error
          if not self.commands:
              raise DistutilsArgError, "no commands supplied"
  
          # All is well: return true
          return 1
function_tokens: def parse_command_line ( self ) : # # We now have enough information to show the Macintosh dialog # that allows the user to interactively specify the "command line". # toplevel_options = self . _get_toplevel_options ( ) # We have to parse the command line a bit at a time -- global # options, then the first command, then its options, and so on -- # because each command will be handled by a different class, and # the options that are valid for a particular class aren't known # until we have loaded the command class, which doesn't happen # until we know what the command is. self . commands = [ ] parser = FancyGetopt ( toplevel_options + self . display_options ) parser . set_negative_aliases ( self . negative_opt ) parser . set_aliases ( { 'licence' : 'license' } ) args = parser . getopt ( args = self . script_args , object = self ) option_order = parser . get_option_order ( ) log . set_verbosity ( self . verbose ) # for display options we return immediately if self . handle_display_options ( option_order ) : return while args : args = self . _parse_command_opts ( parser , args ) if args is None : # user asked for help (and got it) return # Handle the cases of --help as a "global" option, ie. # "setup.py --help" and "setup.py --help command ...".  For the # former, we show global options (--verbose, --dry-run, etc.) # and display-only options (--name, --version, etc.); for the # latter, we omit the display-only options and show help for # each command listed on the command line. if self . help : self . _show_help ( parser , display_options = len ( self . commands ) == 0 , commands = self . commands ) return # Oops, no commands found -- an end-user error if not self . commands : raise DistutilsArgError , "no commands supplied" # All is well: return true return 1