tools/buildman/cmdline.py

   1 #
   2 # Copyright (c) 2014 Google, Inc
   3 #
   4 # SPDX-License-Identifier:      GPL-2.0+
   5 #
   6
   7 from optparse import OptionParser
   8
   9 def ParseArgs():
  10     """Parse command line arguments from sys.argv[]
  11
  12     Returns:
  13         tuple containing:
  14             options: command line options
  15             args: command lin arguments
  16     """
  17     parser = OptionParser()
  18     parser.add_option('-b', '--branch', type='string',
  19           help='Branch name to build')
  20     parser.add_option('-B', '--bloat', dest='show_bloat',
  21           action='store_true', default=False,
  22           help='Show changes in function code size for each board')
  23     parser.add_option('-c', '--count', dest='count', type='int',
  24           default=-1, help='Run build on the top n commits')
  25     parser.add_option('-C', '--force-reconfig', dest='force_reconfig',
  26           action='store_true', default=False,
  27           help='Reconfigure for every commit (disable incremental build)')
  28     parser.add_option('-d', '--detail', dest='show_detail',
  29           action='store_true', default=False,
  30           help='Show detailed information for each board in summary')
  31     parser.add_option('-e', '--show_errors', action='store_true',
  32           default=False, help='Show errors and warnings')
  33     parser.add_option('-f', '--force-build', dest='force_build',
  34           action='store_true', default=False,
  35           help='Force build of boards even if already built')
  36     parser.add_option('-F', '--force-build-failures', dest='force_build_failures',
  37           action='store_true', default=False,
  38           help='Force build of previously-failed build')
  39     parser.add_option('-g', '--git', type='string',
  40           help='Git repo containing branch to build', default='.')
  41     parser.add_option('-G', '--config-file', type='string',
  42           help='Path to buildman config file', default='')
  43     parser.add_option('-H', '--full-help', action='store_true', dest='full_help',
  44           default=False, help='Display the README file')
  45     parser.add_option('-i', '--in-tree', dest='in_tree',
  46           action='store_true', default=False,
  47           help='Build in the source tree instead of a separate directory')
  48     parser.add_option('-j', '--jobs', dest='jobs', type='int',
  49           default=None, help='Number of jobs to run at once (passed to make)')
  50     parser.add_option('-k', '--keep-outputs', action='store_true',
  51           default=False, help='Keep all build output files (e.g. binaries)')
  52     parser.add_option('-l', '--list-error-boards', action='store_true',
  53           default=False, help='Show a list of boards next to each error/warning')
  54     parser.add_option('--list-tool-chains', action='store_true', default=False,
  55           help='List available tool chains')
  56     parser.add_option('-n', '--dry-run', action='store_true', dest='dry_run',
  57           default=False, help="Do a try run (describe actions, but no nothing)")
  58     parser.add_option('-o', '--output-dir', type='string',
  59           dest='output_dir', default='..',
  60           help='Directory where all builds happen and buildman has its workspace (default is ../)')
  61     parser.add_option('-Q', '--quick', action='store_true',
  62           default=False, help='Do a rough build, with limited warning resolution')
  63     parser.add_option('-s', '--summary', action='store_true',
  64           default=False, help='Show a build summary')
  65     parser.add_option('-S', '--show-sizes', action='store_true',
  66           default=False, help='Show image size variation in summary')
  67     parser.add_option('--step', type='int',
  68           default=1, help='Only build every n commits (0=just first and last)')
  69     parser.add_option('-t', '--test', action='store_true', dest='test',
  70                       default=False, help='run tests')
  71     parser.add_option('-T', '--threads', type='int',
  72           default=None, help='Number of builder threads to use')
  73     parser.add_option('-u', '--show_unknown', action='store_true',
  74           default=False, help='Show boards with unknown build result')
  75     parser.add_option('-v', '--verbose', action='store_true',
  76           default=False, help='Show build results while the build progresses')
  77     parser.add_option('-x', '--exclude', dest='exclude',
  78           type='string', action='append',
  79           help='Specify a list of boards to exclude, separated by comma')
  80
  81     parser.usage += """
  82
  83     Build U-Boot for all commits in a branch. Use -n to do a dry run"""
  84
  85     return parser.parse_args()