Home | History | Annotate | Download | only in buildman
      1 # SPDX-License-Identifier: GPL-2.0+
      2 # Copyright (c) 2014 Google, Inc
      3 #
      4 
      5 from optparse import OptionParser
      6 
      7 def ParseArgs():
      8     """Parse command line arguments from sys.argv[]
      9 
     10     Returns:
     11         tuple containing:
     12             options: command line options
     13             args: command lin arguments
     14     """
     15     parser = OptionParser()
     16     parser.add_option('-b', '--branch', type='string',
     17           help='Branch name to build, or range of commits to build')
     18     parser.add_option('-B', '--bloat', dest='show_bloat',
     19           action='store_true', default=False,
     20           help='Show changes in function code size for each board')
     21     parser.add_option('-c', '--count', dest='count', type='int',
     22           default=-1, help='Run build on the top n commits')
     23     parser.add_option('-C', '--force-reconfig', dest='force_reconfig',
     24           action='store_true', default=False,
     25           help='Reconfigure for every commit (disable incremental build)')
     26     parser.add_option('-d', '--detail', dest='show_detail',
     27           action='store_true', default=False,
     28           help='Show detailed information for each board in summary')
     29     parser.add_option('-D', '--config-only', action='store_true', default=False,
     30           help="Don't build, just configure each commit")
     31     parser.add_option('-e', '--show_errors', action='store_true',
     32           default=False, help='Show errors and warnings')
     33     parser.add_option('-E', '--warnings-as-errors', action='store_true',
     34           default=False, help='Treat all compiler warnings as errors')
     35     parser.add_option('-f', '--force-build', dest='force_build',
     36           action='store_true', default=False,
     37           help='Force build of boards even if already built')
     38     parser.add_option('-F', '--force-build-failures', dest='force_build_failures',
     39           action='store_true', default=False,
     40           help='Force build of previously-failed build')
     41     parser.add_option('--fetch-arch', type='string',
     42           help="Fetch a toolchain for architecture FETCH_ARCH ('list' to list)."
     43               ' You can also fetch several toolchains separate by comma, or'
     44               " 'all' to download all")
     45     parser.add_option('-g', '--git', type='string',
     46           help='Git repo containing branch to build', default='.')
     47     parser.add_option('-G', '--config-file', type='string',
     48           help='Path to buildman config file', default='')
     49     parser.add_option('-H', '--full-help', action='store_true', dest='full_help',
     50           default=False, help='Display the README file')
     51     parser.add_option('-i', '--in-tree', dest='in_tree',
     52           action='store_true', default=False,
     53           help='Build in the source tree instead of a separate directory')
     54     parser.add_option('-I', '--incremental', action='store_true',
     55           default=False, help='Do not run make mrproper (when reconfiguring)')
     56     parser.add_option('-j', '--jobs', dest='jobs', type='int',
     57           default=None, help='Number of jobs to run at once (passed to make)')
     58     parser.add_option('-k', '--keep-outputs', action='store_true',
     59           default=False, help='Keep all build output files (e.g. binaries)')
     60     parser.add_option('-K', '--show-config', action='store_true',
     61           default=False, help='Show configuration changes in summary (both board config files and Kconfig)')
     62     parser.add_option('--preserve-config-y', action='store_true',
     63           default=False, help="Don't convert y to 1 in configs")
     64     parser.add_option('-l', '--list-error-boards', action='store_true',
     65           default=False, help='Show a list of boards next to each error/warning')
     66     parser.add_option('--list-tool-chains', action='store_true', default=False,
     67           help='List available tool chains')
     68     parser.add_option('-n', '--dry-run', action='store_true', dest='dry_run',
     69           default=False, help="Do a dry run (describe actions, but do nothing)")
     70     parser.add_option('-N', '--no-subdirs', action='store_true', dest='no_subdirs',
     71           default=False, help="Don't create subdirectories when building current source for a single board")
     72     parser.add_option('-o', '--output-dir', type='string',
     73           dest='output_dir', default='..',
     74           help='Directory where all builds happen and buildman has its workspace (default is ../)')
     75     parser.add_option('-Q', '--quick', action='store_true',
     76           default=False, help='Do a rough build, with limited warning resolution')
     77     parser.add_option('-p', '--full-path', action='store_true',
     78           default=False, help="Use full toolchain path in CROSS_COMPILE")
     79     parser.add_option('-P', '--per-board-out-dir', action='store_true',
     80           default=False, help="Use an O= (output) directory per board rather than per thread")
     81     parser.add_option('-s', '--summary', action='store_true',
     82           default=False, help='Show a build summary')
     83     parser.add_option('-S', '--show-sizes', action='store_true',
     84           default=False, help='Show image size variation in summary')
     85     parser.add_option('--skip-net-tests', action='store_true', default=False,
     86                       help='Skip tests which need the network')
     87     parser.add_option('--step', type='int',
     88           default=1, help='Only build every n commits (0=just first and last)')
     89     parser.add_option('-t', '--test', action='store_true', dest='test',
     90                       default=False, help='run tests')
     91     parser.add_option('-T', '--threads', type='int',
     92           default=None, help='Number of builder threads to use')
     93     parser.add_option('-u', '--show_unknown', action='store_true',
     94           default=False, help='Show boards with unknown build result')
     95     parser.add_option('-U', '--show-environment', action='store_true',
     96           default=False, help='Show environment changes in summary')
     97     parser.add_option('-v', '--verbose', action='store_true',
     98           default=False, help='Show build results while the build progresses')
     99     parser.add_option('-V', '--verbose-build', action='store_true',
    100           default=False, help='Run make with V=1, logging all output')
    101     parser.add_option('-x', '--exclude', dest='exclude',
    102           type='string', action='append',
    103           help='Specify a list of boards to exclude, separated by comma')
    104 
    105     parser.usage += """
    106 
    107     Build U-Boot for all commits in a branch. Use -n to do a dry run"""
    108 
    109     return parser.parse_args()
    110