sysarg 1.1.13

CLI Argument Parser

SysArg

CLI Argument Parser Functions

Contents

1. Install
2. Initialize
3. Functions
   1. defind : Setup option/command/group/help....
   2. Cmd : Get Inputed Special Command (it need cmd_id=1 parameter at initialize)
   3. Get : Get parameter's input values
   4. Version : show version
   5. Check : Check option
   6. Help : Dispaly Help

• Install

pip install SysArg

• Initialize
  • program : Program Name
  • cmd_id : command ID
  • desc : Program Description
  • epilog : Program Epilog (tail string of the help)
  • version : define Program version
  • help_desc: Customize description of Help

import SysArg
arg=SysArg.SysArg(program='ArgTest',desc='ARG. Testing',version='1.0')

if you want make a special command in this application case: (ArgTest command ...)

import SysArg
arg=SysArg.SysArg(program='ArgTest',desc='ARG. Testing',version='1.0',cmd_id=1)

• defind
  • name: (required) parameter name
  • short: short parameter(-XX)
  • long: long parameter(--XX)
  • params:
    • default:0(found parameter then True),
    • 0<n: how many required parameter input data(number)
    • - : until next parameter or until finished inputs
  • params_name: --abc=<PARAMS_NAME(Explain String)> (this format)
  • required: required parameter (default False, need then True)
  • default: default value when no input
  • type: default str, wrong type then not taken (support: str,int,list,tuple,dict)
    • spliter: if you set list or tuple at type. but input is single string then using spliter (example: , : )
  • group: make a special group's prameters
  • group_desc: group desciption
  • command: If Command Group then True

example format: -n, --numbre=INT

arg.define('number',short='-n',long='--number',params_name='INT',type=int,desc='Number Input')

it this option required value

arg.define('number',short='-n',long='--number',params_name='INT',type=int,desc='Number Input',required=True)

Add some of GROUP(ex: INPUT)

arg.define('number',short='-n',long='--number',params_name='INT',type=int,desc='Number Input',group='INPUT')

example format: -n, --numbre INT

arg.define('number',short='-n',long='--number',params=1,type=int,desc='Number Input')

example format: -l, --list ['A','B']

arg.define('List',short='-l',long='--list',params=1,type=list,desc='List Input')

example format: -l, --list 'A,B,C'

arg.define('List',short='-l',long='--list',params=1,type=list,spliter=',',desc='List Input')

example format: -l, --list A B C

arg.define('List',short='-l',long='--list',params=3,type=list,desc='List Input')

example default : if not input then default get 7

arg.define('N',short='-n',long='--number',params=1,type=int,desc='Number Input',default=7)

example check parameter: if -n or --number parameter then True

arg.define('N',short='-n',long='--number')

example command group:

arg.define(group_desc='File list',group='ls',command=True)
arg.define('show_detail',short='-l',desc='show detail',group='ls')
arg.define('show_time',short='-t',desc='show time',group='ls')

• Cmd Get Input Command name

cmd=arg.Cmd()

• Get parameter's value
  • All data

param=arg.Get()

• Get group INPUT's All data

param=arg.Get(group='INPUT')

• Get Parameter number's data

param=arg.Get('number')

• Get Parameter List's data in the INPUT group

param=arg.Get('List',group='INPUT')

Simple Example)

import SysArg
arg=SysArg.SysArg(program='ArgTest',desc='ARG. Testing',version='1.0',cmd_id=1)
arg.define('a',short='-a',long='--abc',desc='test input',params=1)
arg.Version()
arg.Help()

cmd=arg.Cmd()
a=arg.Get('a')