Python Academy · 강의

Click 라이브러리

데코레이터로 CLI 만들기

레슨 3/413개 단계

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

Click이란 무엇인가요?

Click은 데코레이터를 사용해 명령줄 인터페이스를 만드는 인기 있는 서드파티 라이브러리입니다. 아주 적은 코드로 파싱, 도움말 텍스트, 프롬프트, 색상을 처리합니다. pip install click로 설치하세요.

import click

@click.command()
def hello():
    click.echo('Hello from Click')

# hello() would run when called as a script

click.echo

print 대신 click.echo()를 사용하세요. 인코딩 문제를 처리하며 Click의 색상 및 리디렉션 기능과도 원활하게 작동합니다.

import click

@click.command()
def greet():
    click.echo('Welcome!')

인수

@click.argument 데코레이터는 필수 위치 인수를 선언하며, Click은 이 인수를 매개변수로 함수에 전달합니다.

import click

@click.command()
@click.argument('name')
def hello(name):
    click.echo('Hello ' + name)

옵션

@click.option은 선택적 플래그를 정의합니다. 기본값을 지정하면 Click이 도움말 텍스트와 형식 처리를 자동으로 구성합니다.

import click

@click.command()
@click.option('--count', default=1, help='Number of greetings')
def hello(count):
    for _ in range(count):
        click.echo('Hi')

형식이 지정된 옵션

Click은 기본값에서 형식을 추론하거나, type=int로 형식을 명시적으로 지정할 수 있습니다. 잘못된 입력이 들어오면 이해하기 쉬운 오류가 발생합니다.

import click

@click.command()
@click.option('--age', type=int, default=0)
def show(age):
    click.echo('Age is ' + str(age))

부울 플래그

is_flag=True인 옵션은 플래그가 있을 때 True가 되는 전환 옵션이 됩니다. --verbose와 같은 방식입니다.

import click

@click.command()
@click.option('--shout', is_flag=True)
@click.argument('text')
def say(shout, text):
    click.echo(text.upper() if shout else text)

프롬프트

prompt=True로 설정하면 명령줄에서 옵션을 제공하지 않았을 때 Click이 대화형으로 사용자에게 묻습니다.

import click

@click.command()
@click.option('--name', prompt='Your name')
def hello(name):
    click.echo('Hello ' + name)

명령 그룹

@click.group은 하위 명령을 담는 부모 명령을 만듭니다. argparse의 하위 파서에 해당하는 Click의 기능입니다. 하위 명령은 @cli.command()로 연결합니다.

import click

@click.group()
def cli():
    pass

@cli.command()
def start():
    click.echo('starting')

@cli.command()
def stop():
    click.echo('stopping')

색상이 있는 출력

click.style은 텍스트를 색상과 스타일로 감싸고, click.secho는 한 번의 호출로 출력과 스타일 지정을 함께 처리합니다.

import click

@click.command()
def status():
    click.secho('OK', fg='green', bold=True)
    click.secho('Error', fg='red')

확인 및 종료

click.confirm은 예/아니요 질문을 표시하며, click.Abort를 발생시키거나 반환하면 명령이 깔끔하게 종료됩니다.

import click

@click.command()
def delete():
    if click.confirm('Are you sure?'):
        click.echo('deleted')
    else:
        click.echo('cancelled')

argparse와 Click 비교

argparse는 내장되어 있어 간단한 도구에 적합합니다. Click은 외부 의존성이지만, 규모가 큰 CLI에 필요한 더 깔끔한 데코레이터 방식, 중첩된 그룹, 프롬프트, 색상 기능을 기본으로 제공합니다.

import click

@click.command()
@click.argument('items', nargs=-1)
def show(items):
    for item in items:
        click.echo(item)

빠른 확인

Click에 대한 이해도를 확인해 보세요.

복습

Click 라이브러리를 배웠습니다:

  • @click.command, @click.argument, @click.option 데코레이터로 CLI를 정의합니다.
  • click.echo와 click.secho는 필요에 따라 색상을 적용해 출력합니다.
  • @click.group은 중첩된 하위 명령을 만들며, 프롬프트와 확인 기능이 기본 제공됩니다.
  • pip로 설치하는 외부 의존성입니다.

다음에는 rich로 터미널 출력을 꾸며 봅니다.

무료로 시작

AI 튜터와 함께 Python을(를) 배우세요 — 무료

브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.

코스
76
레슨
320

자주 묻는 질문

“Click 라이브러리” 강의는 무료인가요?

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

“Click 라이브러리”에서 뭘 배우나요?

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

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

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

“Click 라이브러리” 강의는 얼마나 걸리나요?

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

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

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

이 강의의 모든 강의

  1. argparse 기초
  2. 하위 명령과 옵션
  3. Click 라이브러리
  4. 풍부한 터미널 출력
← Python Academy(으)로 돌아가기