Argeye - a small improved version of Argparse

argeye retains all the original usage of argparse,but adding a yml file so user can modify arguments by editing yml file.

argparse supports command lines to set arguments,whose disadvantages is that the user have to type the arg strings and values.

the typing is a redundant operation,which may cause mistakes and counterintuitive understanding of the args.

yml file provides intuitive understanding and a more convenient way to set args.

only one line change,better experience of argparse

usage

(original)

retained all the original usage of argparse,detailed info refer to official document

(new)two-mode

two-mode meaning argeye contains two using methods.

the first just same as argparse--using command line.in this way,the arguments set by yml file will be invalid

the second is using yml file to set arguments.but notice that,if choosing yml method,the command line cannot have input for arguments

FIRST RUN (same as running argparse)

# examples/main.py
from argeye import ArgumentParser

parser = ArgumentParser()
parser.add_argument("equip_name", type=str, default="wired")
parser.add_argument("--model_name", default="pd", type=str)
parser.add_argument("--finetune", default=False, type=bool)

args = parser.parse_args()
print(args)

# decide whether to input arguments at the terminal based on actual needs
$ python examples/main.py wired --model_name=pd
Namespace(equip_name='wired',model_name='pd',finetune=True)

USING YML

after executing the above command line operations,the yml file will be created in the work directory.

the content of the yml file is as follows:

equip_name: wired
--model_name: pd
--finetune: false

now having the yml file,the user can change arguments values by editing yml file instead of typing strings into command lines.

when the change operation is completed(completed in the yml file),simply run the python file without the need of typing arguments on the command line.

example:

# change arguments in the yml file
equip_name: wireless
--model_name: resnet
--finetune: True

# run python file directly
$ python examples/main.py
Namespace(equip_name='wireless', model_name='resnet', finetune=True)

installation

pip install argeye