Python Academy · 강의

하위 명령과 옵션

복잡한 CLI 만들기

하위 명령과 옵션은(는) CoddyKit의 무료 Python Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Python Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Python Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

하위 명령이 필요한 이유

git 같은 도구에는 하위 명령이 있습니다. 예를 들어 git add와 git commit이 있습니다. argparse에서는 하위 파서를 통해 이를 지원하며, 각 하위 명령이 자체 인수를 가질 수 있습니다.

import argparse

parser = argparse.ArgumentParser(prog='tool')
sub = parser.add_subparsers(dest='command')
print('subparsers ready')

하위 파서 추가하기

add_subparsers는 객체를 반환하며, 그 객체의 add_parser 메서드로 각 하위 명령을 만듭니다. dest에는 사용자가 선택한 하위 명령이 저장됩니다.

import argparse

parser = argparse.ArgumentParser()
sub = parser.add_subparsers(dest='command')
sub.add_parser('start')
sub.add_parser('stop')
args = parser.parse_args(['start'])
print('command:', args.command)

하위 명령별 인수

각 하위 파서는 자체 인수를 정의할 수 있습니다. 여기서 add 하위 명령은 이름을 받고, list는 인수를 받지 않습니다.

import argparse

parser = argparse.ArgumentParser()
sub = parser.add_subparsers(dest='command')
p_add = sub.add_parser('add')
p_add.add_argument('name')
sub.add_parser('list')
args = parser.parse_args(['add', 'milk'])
print(args.command, args.name)

명령에 따라 분기하기

파싱한 후 args.command를 기준으로 분기하여 올바른 로직을 실행합니다.

import argparse

parser = argparse.ArgumentParser()
sub = parser.add_subparsers(dest='command')
p_add = sub.add_parser('add')
p_add.add_argument('item')
sub.add_parser('clear')

args = parser.parse_args(['add', 'eggs'])
if args.command == 'add':
    print('adding', args.item)
elif args.command == 'clear':
    print('clearing all')

처리 함수에 set_defaults 사용하기

깔끔한 패턴은 set_defaults(func=...)를 사용해 각 하위 파서에 함수를 연결한 다음 args.func(args)를 호출하는 것입니다.

import argparse

def do_hi(args):
    print('hi', args.who)

parser = argparse.ArgumentParser()
sub = parser.add_subparsers()
p = sub.add_parser('hi')
p.add_argument('who')
p.set_defaults(func=do_hi)

args = parser.parse_args(['hi', 'Ana'])
args.func(args)

부모 파서로 공통 옵션 공유하기

부모 파서에는 여러 하위 명령에 공통으로 필요한 옵션을 담아 중복을 피할 수 있습니다. parents=[base]와 add_help=False를 전달하세요.

import argparse

base = argparse.ArgumentParser(add_help=False)
base.add_argument('--verbose', action='store_true')

parser = argparse.ArgumentParser()
sub = parser.add_subparsers(dest='cmd')
sub.add_parser('run', parents=[base])
args = parser.parse_args(['run', '--verbose'])
print(args.cmd, args.verbose)

옵션별 기본값

하위 명령의 옵션도 최상위 인수와 마찬가지로 자체 기본값과 형식을 가질 수 있습니다.

import argparse

parser = argparse.ArgumentParser()
sub = parser.add_subparsers(dest='cmd')
p = sub.add_parser('scale')
p.add_argument('--factor', type=float, default=1.0)
args = parser.parse_args(['scale'])
print('factor:', args.factor)

반복 옵션 추가하기

action='append'를 사용하면 플래그를 여러 번 지정할 수 있으며, 각 값이 목록에 모입니다.

import argparse

parser = argparse.ArgumentParser()
parser.add_argument('--tag', action='append', default=[])
args = parser.parse_args(['--tag', 'a', '--tag', 'b'])
print(args.tag)

플래그 개수 세기

action='count'는 플래그가 나타난 횟수를 셉니다. 대표적인 상세 출력 수준 조절 패턴이 -vvv입니다.

import argparse

parser = argparse.ArgumentParser()
parser.add_argument('-v', action='count', default=0)
args = parser.parse_args(['-v', '-v', '-v'])
print('verbosity level:', args.v)

두 가지 명령을 사용하는 도구

하위 명령, 처리 함수, 공통 옵션을 조합하면 구조화된 다중 명령 CLI를 만들 수 있습니다.

import argparse

def add(args):
    print('add', args.item, 'qty', args.qty)

def remove(args):
    print('remove', args.item)

parser = argparse.ArgumentParser()
sub = parser.add_subparsers()
pa = sub.add_parser('add')
pa.add_argument('item')
pa.add_argument('--qty', type=int, default=1)
pa.set_defaults(func=add)
pr = sub.add_parser('remove')
pr.add_argument('item')
pr.set_defaults(func=remove)

args = parser.parse_args(['add', 'pen', '--qty', '3'])
args.func(args)

필수 하위 명령

하위 파서에 required=True를 설정하면 사용자가 반드시 명령을 선택해야 하며, 그렇지 않으면 argparse에서 오류가 발생합니다.

import argparse

parser = argparse.ArgumentParser()
sub = parser.add_subparsers(dest='cmd', required=True)
sub.add_parser('go')
args = parser.parse_args(['go'])
print('chosen:', args.cmd)

빠른 확인

하위 명령과 옵션에 대한 이해도를 확인해 보세요.

복습

하위 명령과 옵션을 배웠습니다:

add_subparsers와 add_parser로 다중 명령 도구를 만듭니다.
set_defaults(func=...)로 처리 함수에 작업을 전달합니다.
부모 파서로 공통 옵션을 공유합니다.
append와 count 동작으로 반복 플래그를 처리합니다.

다음에는 데코레이터 기반 CLI를 위한 Click 라이브러리를 살펴봅니다.

자주 묻는 질문

“하위 명령과 옵션” 강의는 무료인가요?

네 — “하위 명령과 옵션” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Python Academy 강의 전체를 잠금 해제할 수 있습니다. Python Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“하위 명령과 옵션”에서 뭘 배우나요?

복잡한 CLI 만들기 브라우저에서 직접 실행하는 실습 코드로 Python Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Python Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Python Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.

“하위 명령과 옵션” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Python Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Python Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Python Academy(으)로 돌아가기