Python에서 CLI 도구 만들기 (argparse vs click)

파이썬으로 명령줄 도구 만드는 중이신가요? 저도 얼마 전에 비슷한 작업을 했었는데, argparse랑 click이라는 두 라이브러리 때문에 꽤 고민했거든요. 둘 다 훌륭하지만, 어떤 걸 써야 할지 정말 헷갈리더라고요. 그래서 제가 직접 써보고 느낀 점들을 바탕으로 얘기해 드릴게요!

먼저, argparse는 파이썬에 기본적으로 포함된 라이브러리예요. 기능은 정말 막강하죠. 마치 스위스 아미 나이프처럼, 세세하게 옵션을 조절할 수 있어요. 복잡한 도구를 만들 때는 정말 유용해요. 하지만, 간단한 걸 만들 때는 쓸데없이 코드가 길어지는 느낌이 들더라고요. 마치 거대한 대포로 모기를 잡는 것 같은 느낌이랄까요? 저는 처음에 argparse로 시작했는데, 코드가 너무 길어지니까 나중에 수정하기가 힘들더라구요. 괜히 힘들게 했나 싶었어요.

반면에 click은 외부 라이브러리인데, 사용하기가 훨씬 쉽고 간결해요. 마치 레고 블록처럼, 몇 개의 코드만으로도 멋진 명령줄 도구를 만들 수 있죠. 특히 데코레이터라는 기능을 사용하는데, 처음엔 좀 어렵게 느껴질 수도 있지만, 익숙해지면 코드가 정말 깔끔해져요. 저는 간단한 도구를 만들 때 click을 사용했는데, 정말 속도가 빨랐어요. 코드도 짧고 이해하기도 쉬워서 좋았습니다. 마치 마법처럼 뚝딱 만들어지는 느낌이었어요!

실제로 제가 만들었던 간단한 파일 처리 도구 예시를 보여드릴게요. argparse로 만든 코드는 이렇게 길어졌지만, click으로 만든 코드는 훨씬 짧고 보기 편하더라고요.

1. argparse 예제

import argparse

def main():
    parser = argparse.ArgumentParser(description="파일 내용을 출력하거나 줄 수를 세는 도구")

    parser.add_argument("filename", help="읽을 파일 이름")
    parser.add_argument(
        "-c", "--count",
        action="store_true",
        help="파일의 줄 수를 출력"
    )

    args = parser.parse_args()

    with open(args.filename, "r", encoding="utf-8") as f:
        lines = f.readlines()

    if args.count:
        print(f"줄 수: {len(lines)}")
    else:
        print("".join(lines))

if __name__ == "__main__":
    main()

실행 예시

$ python tool.py example.txt
(파일 내용이 출력됨)

$ python tool.py example.txt --count
줄 수: 42

🔎 특징

표준 라이브러리 → 별도 설치 필요 없음.
옵션 정의가 조금 장황하고, 복잡한 도구에서 강력함.
함수형이 아니라 parser.add_argument로 계속 추가하는 방식.

2. click 예제

import click

@click.command()
@click.argument("filename")
@click.option(
    "--count", "-c",
    is_flag=True,
    help="파일의 줄 수를 출력"
)
def main(filename, count):
    """파일 내용을 출력하거나 줄 수를 세는 도구"""
    with open(filename, "r", encoding="utf-8") as f:
        lines = f.readlines()

    if count:
        click.echo(f"줄 수: {len(lines)}")
    else:
        click.echo("".join(lines))

if __name__ == "__main__":
    main()

실행 예시

$ python tool.py example.txt
(파일 내용이 출력됨)

$ python tool.py example.txt -c
줄 수: 42

🔎 특징

외부 라이브러리 (pip install click) 필요.
데코레이터(@click.command, @click.option)로 선언적이고 코드가 깔끔해짐.
click.echo는 자동으로 인코딩 처리를 해줘서 안전함.
복잡한 하위 명령어(git commit 같은 구조)도 쉽게 확장 가능.

정리 비교

항목	argparse	click
포함 여부	표준 라이브러리 (추가 설치 X)	외부 라이브러리 (pip 설치 필요)
코드 스타일	절차적, `parser.add_argument` 방식	선언적, 데코레이터 방식
학습 난이도	쉽지만 장황함	초반엔 낯설 수 있음, 익숙해지면 간결
장점	강력하고 유연함, 추가 의존성 없음	코드가 간결, 사용자 친화적 메시지, 확장 쉬움
권장 상황	대규모 복잡한 CLI, 기본만 쓰고 싶을 때	간단/중간 규모 CLI, 팀 협업 시 가독성 중요할 때

보시다시피 click이 훨씬 간결하죠? 물론 argparse가 더 강력한 기능을 제공하는 건 맞지만, 제가 만든 간단한 도구에는 오히려 click이 더 적합했어요. 프로젝트 규모가 크고 복잡한 옵션을 많이 다뤄야 한다면 argparse가 좋겠지만, 간단한 도구를 빠르게 만들고 싶다면 click을 추천드려요.

그리고 팀에서 이미 특정 라이브러리를 쓰고 있다면, 그냥 그걸 쓰는 게 좋을 거예요. 일관성을 유지하는 게 중요하니까요. 그리고 click의 데코레이터는 처음엔 어색할 수 있지만, 익숙해지면 정말 편리하다는 걸 알게 될 거예요.

결론적으로, 어떤 라이브러리를 선택할지는 여러분의 프로젝트 규모와 복잡성, 그리고 팀의 규약에 따라 달라요. 하지만 제 경험으로는, 간단한 도구라면 click으로 시작해보는 걸 추천합니다. 그리고 두 라이브러리를 모두 익혀두면 다양한 상황에 유연하게 대처할 수 있겠죠! 어떤 라이브러리를 선택하든, 멋진 CLI 도구를 만드시길 바랍니다!

If Dev Then ?

이 블로그 검색