Python Academy · Lezione

La libreria Click

Creare CLI con i decoratori

La libreria Click è una lezione Python Academy gratuita su CoddyKit. Questa è la lezione 3 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Python Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Python Academy include 4 lezioni in totale.

Che cos'è Click?

Click è una popolare libreria di terze parti per creare interfacce a riga di comando tramite decoratori. Gestisce l'analisi degli argomenti, il testo della guida, le richieste interattive e i colori con pochissimo codice. La installi con pip install click.

import click

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

# hello() would run when called as a script

click.echo

Utilizzi click.echo() invece di print. Gestisce i problemi di codifica e funziona perfettamente con le funzionalità di Click per colori e reindirizzamento.

import click

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

Argomenti

Il decoratore @click.argument dichiara un argomento posizionale obbligatorio che Click passa alla funzione come parametro.

import click

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

Opzioni

@click.option definisce i flag opzionali. Fornisca un valore predefinito e Click creerà automaticamente il testo della guida e la gestione dei tipi.

import click

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

Opzioni tipizzate

Click deduce il tipo dal valore predefinito, oppure può impostarlo esplicitamente con type=int. Un input non valido produce un errore comprensibile.

import click

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

Flag booleani

Un'opzione con is_flag=True diventa un interruttore che vale True quando è presente, come --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)

Richieste interattive

Imposti prompt=True e Click chiederà interattivamente il valore all'utente se l'opzione non è stata fornita nella riga di comando.

import click

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

Gruppi di comandi

@click.group crea un comando genitore che contiene i sottocomandi, l'equivalente in Click dei subparser di argparse. I sottocomandi vengono associati con @cli.command().

import click

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

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

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

Output a colori

click.style applica colori e stili al testo, mentre click.secho combina l'output e lo stile in un'unica chiamata.

import click

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

Conferma e uscita

click.confirm pone una domanda con risposta sì/no, mentre sollevare click.Abort o restituire il controllo termina il comando correttamente.

import click

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

argparse e Click

argparse è integrato in Python ed è ottimo per gli strumenti semplici. Click è una dipendenza esterna, ma per le CLI più grandi offre uno stile basato sui decoratori più pulito, gruppi annidati, richieste interattive e colori pronti all'uso.

import click

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

Verifica rapida

Verifichi la Sua comprensione di Click.

Riepilogo

Ha imparato a usare la libreria Click:

I decoratori @click.command, @click.argument, @click.option definiscono una CLI.
click.echo e click.secho stampano il testo, anche a colori se desiderato.
@click.group costruisce sottocomandi annidati; richieste interattive e conferme sono integrate.
È una dipendenza esterna che si installa tramite pip.

Prossimo argomento: dare stile all'output del terminale con rich.

Domande Frequenti

La lezione «La libreria Click» è gratuita?

Sì — il testo completo di «La libreria Click» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Python Academy, passa a CoddyKit PRO. Il corso Python Academy include 4 lezioni in totale.

Cosa imparerò in «La libreria Click»?

Creare CLI con i decoratori Eserciti Python Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Python Academy?

Non è richiesta alcuna esperienza precedente. Python Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 3 di 4.

Quanto tempo richiede la lezione «La libreria Click»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Python Academy?

Sì. Ogni lezione Python Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

← Torna a Python Academy