[파이썬] argparse에서의 대화형 도움말
개요
Python은 표준 라이브러리에서 argparse라는 모듈을 제공하여 명령행 인터페이스를 구성하는 데 도움을 줍니다. argparse는 대화형 도움말을 추가하는 기능을 제공하여 사용자가 프로그램의 사용 방법과 옵션을 이해하기 쉽게 도와줍니다. 이 기능은 사용자가 명령어를 실행하고 “-h” 또는 “–help” 옵션을 사용하여 도움말을 요청할 때 활성화됩니다.
예제
다음은 argparse의 대화형 도움말을 구현하는 예제입니다.
import argparse
def main():
parser = argparse.ArgumentParser(description='이 프로그램은 사용자의 입력을 처리합니다.')
parser.add_argument('input', help='입력 파일의 경로를 지정합니다.')
parser.add_argument('--output', help='출력 파일의 경로를 지정합니다. 기본값은 결과.txt 입니다.')
args = parser.parse_args()
# 프로그램의 로직을 추가합니다.
process_input(args.input, args.output)
def process_input(input_path, output_path='결과.txt'):
# 입력 파일을 처리하는 로직을 추가합니다.
print(f'입력 파일: {input_path}')
print(f'출력 파일: {output_path}')
if __name__ == '__main__':
main()
위의 예제에서는 argparse를 사용하여 “input”이라는 위치 인수와 “–output”이라는 선택적 인수를 정의합니다. “input”은 입력 파일의 경로를 지정하는 데 사용되며, “–output”은 출력 파일의 경로를 지정하는 데 사용됩니다. “–output” 옵션이 생략될 경우 기본적으로 “결과.txt”로 설정됩니다.
사용자는 다음 명령어를 실행하여 대화형 도움말을 볼 수 있습니다:
python script.py --help
이 명령을 실행하면 다음과 같은 도움말이 표시됩니다:
usage: script.py [-h] [--output OUTPUT] input
이 프로그램은 사용자의 입력을 처리합니다.
positional arguments:
input 입력 파일의 경로를 지정합니다.
optional arguments:
-h, --help show this help message and exit
--output OUTPUT 출력 파일의 경로를 지정합니다. 기본값은 결과.txt 입니다.
이 도움말에서는 “input” 위치 인수와 “–output” 선택적 인수에 대한 설명과 사용 방법이 제공됩니다. 사용자는 이 정보를 사용하여 프로그램을 올바르게 사용할 수 있습니다.
결론
argparse의 대화형 도움말 기능은 프로그램의 사용 방법에 대한 이해를 돕고 사용자에게 명확한 인터페이스를 제공합니다. 이 기능을 사용하여 사용자가 프로그램을 쉽게 이해하고 효과적으로 사용할 수 있도록 도움을 줄 수 있습니다.