Création de programmes Python en ligne de commande

Introduction

L'interface de ligne de commande Python, également connue sous le nom de ligne de commande ou interface en ligne de commande (CLI), est un moyen d'interagir avec un programme informatique en tapant des commandes dans un terminal ou une invite de commande. Elle permet aux utilisateurs d'exécuter un programme et de lui transmettre des arguments, ainsi que de recevoir la sortie du programme sous forme de texte. L'interface de ligne de commande est particulièrement utile pour automatiser des tâches, exécuter des scripts et effectuer des opérations avancées ou complexes qui seraient difficiles, voire impossibles, à réaliser via une interface graphique (GUI).

Dans ce laboratoire, nous apprendrons à utiliser le module argparse pour créer des interfaces de ligne de commande pour nos programmes Python. Nous commencerons par des exemples simples et passerons progressivement à des exemples plus complexes. À la fin de ce laboratoire, vous devriez avoir une bonne compréhension de la façon d'utiliser le module argparse pour créer des interfaces de ligne de commande puissantes pour vos programmes Python.

Réalisations

• Module argparse
• Scripts Python

Importation du module Argparse

La première étape pour utiliser le module argparse consiste à l'importer.

Vous devez créer un fichier Python qui contiendra votre code.

touch my_program.py

Nous pouvons le faire en ajoutant la ligne de code suivante au début de notre script Python :

import argparse

Création d'un objet analyseur (parser)

Une fois que nous avons importé le module argparse, nous pouvons créer un objet analyseur en appelant la fonction ArgumentParser(). Cette fonction prend plusieurs arguments optionnels, mais pour l'instant, nous fournirons simplement une description simple de notre programme.

parser = argparse.ArgumentParser(description="Une interface de ligne de commande simple.")

Ajout d'arguments

Maintenant que nous avons un objet analyseur, nous pouvons commencer à y ajouter des arguments. Il existe plusieurs types d'arguments que nous pouvons ajouter, tels que les arguments positionnels et les arguments optionnels. Par exemple, nous pouvons ajouter un argument positionnel comme ceci :

parser.add_argument("name", help="Votre nom")

Et un argument optionnel comme ceci :

parser.add_argument("-n", "--number", help="Nombre de fois pour répéter le message", type=int, default=1)

Analyse des arguments

Une fois que nous avons ajouté tous nos arguments, nous pouvons les analyser en appelant la fonction parse_args() de notre objet analyseur. Cette fonction ne prend aucun argument et renvoie un objet contenant les valeurs de tous nos arguments.

args = parser.parse_args()

Utilisation des arguments

Maintenant que nous avons analysé nos arguments, nous pouvons les utiliser dans notre programme. Par exemple, nous pouvons utiliser l'argument name comme ceci :

print("Bonjour, " + args.name)

Et l'argument optionnel comme ceci :

print("Bonjour, " + args.name * args.number)

Code complet

Voici le code complet pour le laboratoire qui inclut toutes les étapes décrites ci-dessus :

import argparse

## Création d'un objet analyseur
parser = argparse.ArgumentParser(description="Une interface de ligne de commande simple.")

## Ajout d'arguments
parser.add_argument("name", help="Votre nom")
parser.add_argument("-n", "--number", help="Nombre de fois pour répéter le message", type=int, default=1)

## Analyse des arguments
args = parser.parse_args()

## Utilisation des arguments
print("Bonjour, " + args.name * args.number)

Vous pouvez exécuter le script en naviguant vers le répertoire où se trouve le fichier dans la ligne de commande et en tapant python my_program.py suivi des arguments que vous souhaitez transmettre au script :

python my_program.py "John" --number 3

Cela affichera "Bonjour, JohnJohnJohn" dans la console.

Résumé

Dans ce laboratoire, nous avons appris à utiliser le module argparse pour créer une interface de ligne de commande pour un programme Python. Nous avons vu comment importer le module argparse, créer un objet analyseur, ajouter des arguments à l'analyseur, analyser les arguments et les utiliser dans notre programme. Avec ces connaissances, vous devriez être capable de créer des interfaces de ligne de commande puissantes pour vos programmes Python.