Guide complet sur le téléchargement de fichiers avec la bibliothèque requests en Python

La bibliothèque requests est l’outil le plus couramment utilisé pour télécharger des fichiers en Python. Dans ce guide, nous allons expliquer en détail les techniques de base pour télécharger des fichiers en utilisant requests, ainsi que des exemples avancés et la gestion des erreurs. Ce guide est conçu pour être accessible aux débutants, avec des instructions pas à pas. Profitez de ce guide pour acquérir des compétences en téléchargement de fichiers avec Python.

Sommaire

Installation de la bibliothèque requests

Pour utiliser la bibliothèque requests en Python, vous devez d’abord l’installer. Voici les étapes à suivre pour l’installation.

Procédure d’installation

L’installation de la bibliothèque requests est simple avec pip. Exécutez la commande suivante :

pip install requests

Vérification de l’installation

Une fois l’installation terminée, exécutez le code suivant dans l’interpréteur pour vérifier que la bibliothèque requests a été correctement installée.

import requests

print(requests.__version__)

Si la version de requests s’affiche, l’installation a réussi.

Méthode de téléchargement de fichiers de base

Nous allons expliquer la méthode de base pour télécharger un fichier avec la bibliothèque requests. Cette section présente un exemple de code simple pour le téléchargement de fichiers, avec une explication de son fonctionnement.

Exemple de code de base

Voici un exemple de code de base pour télécharger un fichier en utilisant la bibliothèque requests.

import requests

# URL de destination du téléchargement
url = 'https://example.com/upload'

# Fichier à télécharger
files = {'file': open('testfile.txt', 'rb')}

# Envoyer une requête POST
response = requests.post(url, files=files)

# Vérifier le code de statut de la réponse
print(response.status_code)

Explication du code

import requests : importe la bibliothèque requests.
url : spécifie l’URL de destination pour le téléchargement.
files : spécifie le fichier à télécharger. Le fichier est passé sous forme de dictionnaire avec la clé ‘file’ et la valeur étant l’objet fichier.
requests.post() : envoie une requête POST. Le fichier est transmis via le paramètre files.
response.status_code : affiche le code de statut de la réponse. Si le code 200 est renvoyé, le téléchargement a réussi.

Avec cette méthode de base, vous pouvez facilement télécharger des fichiers en Python. Passons maintenant à l’utilisation de données de formulaire multipart pour le téléchargement de fichiers.

Téléchargement de données de formulaire multipart

Nous allons expliquer comment télécharger des données de formulaire multipart avec la bibliothèque requests. Cette méthode est utile lorsque vous souhaitez envoyer d’autres données en plus des fichiers.

Exemple de code de base pour les données de formulaire multipart

Voici un exemple de code pour télécharger un fichier avec d’autres données de formulaire.

import requests

# URL de destination du téléchargement
url = 'https://example.com/upload'

# Fichier et autres données à télécharger
files = {'file': open('testfile.txt', 'rb')}
data = {'name': 'testfile', 'description': 'This is a test file'}

# Envoyer une requête POST
response = requests.post(url, files=files, data=data)

# Vérifier le code de statut de la réponse
print(response.status_code)

Explication du code

files : spécifie le fichier à télécharger sous forme de dictionnaire. La clé est ‘file’ et la valeur est l’objet fichier.
data : spécifie les données de formulaire supplémentaires sous forme de dictionnaire. Ici, nous envoyons deux champs : ‘name’ et ‘description’.
requests.post() : envoie une requête POST contenant le fichier et les données via les paramètres files et data.

Avantages du téléchargement multipart

Le téléchargement de données de formulaire multipart présente les avantages suivants :

Permet d’envoyer simultanément des fichiers et des données textuelles.
Facilite la gestion de structures de données plus complexes en envoyant des fichiers en tant que partie des données de formulaire.

En utilisant cette méthode, vous pouvez non seulement télécharger des fichiers, mais aussi envoyer d’autres données associées, permettant ainsi un transfert de données plus flexible. Passons maintenant à la gestion des erreurs qui peuvent survenir pendant le téléchargement.

Gestion des erreurs

Nous allons expliquer les erreurs potentielles qui peuvent survenir pendant le téléchargement de fichiers et comment les gérer. Une bonne gestion des erreurs améliore la fiabilité et l’expérience utilisateur de votre programme.

Méthode de base pour la gestion des erreurs

Voici un exemple de code de gestion des erreurs pour le téléchargement de fichiers avec la bibliothèque requests.

import requests

# URL de destination du téléchargement
url = 'https://example.com/upload'

# Fichier à télécharger
files = {'file': open('testfile.txt', 'rb')}

try:
    # Envoyer une requête POST
    response = requests.post(url, files=files)
    response.raise_for_status()  # Lève une HTTPError si le code de statut n'est pas dans les 200
except requests.exceptions.RequestException as e:
    print(f'Une erreur s'est produite pendant le téléchargement : {e}')
else:
    print('Le fichier a été téléchargé avec succès')

Explication du code

Bloc try : exécute la requête de téléchargement du fichier.
response.raise_for_status() : lève une exception requests.exceptions.HTTPError si le code de statut de la réponse n’est pas dans les 200.
except requests.exceptions.RequestException as e : capture toutes les exceptions liées à requests et affiche un message d’erreur.
Bloc else : s’exécute si aucune erreur n’est survenue.

Exemples d’erreurs spécifiques et solutions

Erreur HTTP : survient lorsque le serveur refuse la requête. Peut être détectée avec response.raise_for_status().
Erreur de connexion : survient lorsqu’il est impossible de se connecter au serveur, par exemple en cas de panne réseau. Peut être capturée avec requests.exceptions.ConnectionError.
Erreur de délai d’attente : survient lorsque la requête dépasse le temps imparti. Peut être capturée avec requests.exceptions.Timeout.

import requests

# URL de destination du téléchargement
url = 'https://example.com/upload'

# Fichier à télécharger
files = {'file': open('testfile.txt', 'rb')}

try:
    # Envoyer une requête POST (avec délai d'attente défini)
    response = requests.post(url, files=files, timeout=10)
    response.raise_for_status()
except requests.exceptions.Timeout:
    print('La requête a expiré')
except requests.exceptions.ConnectionError:
    print('Une erreur de connexion s'est produite')
except requests.exceptions.HTTPError as http_err:
    print(f'Une erreur HTTP s'est produite : {http_err}')
except requests.exceptions.RequestException as e:
    print(f'Une autre erreur s'est produite : {e}')
else:
    print('Le fichier a été téléchargé avec succès')

En gérant correctement les erreurs, vous pouvez améliorer la stabilité et la fiabilité de votre programme. Passons maintenant au téléchargement de plusieurs fichiers simultanément.

Exemple avancé : téléchargement de plusieurs fichiers

Nous allons montrer comment télécharger plusieurs fichiers à la fois avec la bibliothèque requests. Cette section fournit un exemple de code pour télécharger plusieurs fichiers efficacement.

Exemple de code pour le téléchargement de plusieurs fichiers

Voici un exemple de code pour télécharger plusieurs fichiers.

import requests

# URL de destination du téléchargement
url = 'https://example.com/upload'

# Plusieurs fichiers à télécharger
files = {
    'file1': open('testfile1.txt', 'rb'),
    'file2': open('testfile2.txt', 'rb')
}

# Envoyer une requête POST
response = requests.post(url, files=files)

# Vérifier le code de statut de la réponse
print(response.status_code)

Explication du code

files : spécifie plusieurs fichiers sous forme de dictionnaire, avec la clé correspondant au nom du fichier et la valeur étant l’objet fichier.
requests.post() : envoie une requête POST contenant plusieurs fichiers via le paramètre files.

Combiner avec des données de formulaire supplémentaires

Lors du téléchargement de plusieurs fichiers, il est également possible d’inclure des données de formulaire supplémentaires. Voici un exemple de code pour cela.

import requests

# URL de destination du téléchargement
url = 'https://example.com/upload'

# Plusieurs fichiers à télécharger
files = {
    'file1': open('testfile1.txt', 'rb'),
    'file2': open('testfile2.txt', 'rb')
}

# Données de formulaire supplémentaires
data = {
    'username': 'testuser',
    'description': 'Uploading multiple files'
}

# Envoyer une requête POST
response = requests.post(url, files=files, data=data)

# Vérifier le code de statut de la réponse
print(response.status_code)

Explication du code

files : spécifie les fichiers à télécharger sous forme de dictionnaire.
data : spécifie les données de formulaire supplémentaires sous forme de dictionnaire. Ici, nous envoyons un nom d’utilisateur et une description.
requests.post() : envoie une requête POST contenant les fichiers et les données supplémentaires.

En utilisant cette méthode, vous pouvez télécharger efficacement plusieurs fichiers et, si nécessaire, envoyer également des données supplémentaires. Passons maintenant à l’explication du téléchargement de fichiers nécessitant une authentification.

Téléchargement de fichiers avec authentification

Nous allons expliquer comment télécharger des fichiers sur un site web nécessitant une authentification. Avec la bibliothèque requests, il est facile d’envoyer des requêtes contenant des informations d’authentification.

Exemple de base avec authentification

Voici un exemple de code de base pour télécharger un fichier sur un site nécessitant une authentification HTTP basique.

import requests

# URL de destination du téléchargement
url = 'https://example.com/upload'

# Informations d'authentification
auth = ('username', 'password')

# Fichier à télécharger
files = {'file': open('testfile.txt', 'rb')}

# Envoyer une requête POST
response = requests.post(url, files=files, auth=auth)

# Vérifier le code de statut de la réponse
print(response.status_code)

Explication du code

auth : spécifie les informations d’authentification sous forme de tuple, avec le nom d’utilisateur et le mot de passe.
requests.post() : utilise le paramètre auth pour envoyer une requête avec les informations d’authentification.

Exemple d’authentification par jeton

Voici un exemple de code pour utiliser l’authentification par jeton. Cet exemple utilise un jeton Bearer.

import requests

# URL de destination du téléchargement
url = 'https://example.com/upload'

# En-tête d'authentification par jeton
headers = {'Authorization': 'Bearer your_token_here'}

# Fichier à télécharger
files = {'file': open('testfile.txt', 'rb')}

# Envoyer une requête POST
response = requests.post(url, files=files, headers=headers)

# Vérifier le code de statut de la réponse
print(response.status_code)

Explication du code

headers : spécifie l’en-tête d’authentification sous forme de dictionnaire. Ici, nous utilisons un jeton Bearer.
requests.post() : utilise le paramètre headers pour envoyer une requête avec l’en-tête d’authentification.

Exemple d’authentification OAuth

Voici un exemple de code pour utiliser l’authentification OAuth. Cet exemple utilise OAuth2.0 pour obtenir un jeton d’accès, puis télécharge un fichier avec ce jeton.

import requests
from requests_oauthlib import OAuth2Session

# Configuration OAuth2
client_id = 'your_client_id'
client_secret = 'your_client_secret'
authorization_base_url = 'https://example.com/oauth/authorize'
token_url = 'https://example.com/oauth/token'

# Créer une session OAuth2
oauth = OAuth2Session(client_id)
authorization_url, state = oauth.authorization_url(authorization_base_url)

# Afficher l'URL d'autorisation à l'utilisateur et obtenir l'URL de redirection
print('Veuillez aller à {} et autoriser l'accès.'.format(authorization_url))
redirect_response = input('Collez l'URL de redirection complète ici : ')

# Obtenir le jeton
oauth.fetch_token(token_url, authorization_response=redirect_response, client_secret=client_secret)

# URL de destination du téléchargement
url = 'https://example.com/upload'

# Fichier à télécharger
files = {'file': open('testfile.txt', 'rb')}

# Envoyer une requête POST
response = oauth.post(url, files=files)

# Vérifier le code de statut de la réponse
print(response.status_code)

Explication du code

OAuth2Session : crée une session OAuth2.
authorization_url : génère une URL pour l’autorisation de l’utilisateur.
fetch_token() : obtient le jeton d’accès en utilisant l’URL de redirection fournie après l’autorisation de l’utilisateur.
oauth.post() : utilise la session OAuth pour télécharger le fichier.

C’est ainsi que l’on procède pour télécharger des fichiers nécessitant une authentification. Passons maintenant à quelques exercices pratiques pour mettre en pratique les compétences acquises.

Exercices

Dans cette section, nous proposons des exercices pratiques pour vous aider à acquérir des compétences en téléchargement de fichiers avec la bibliothèque requests. Essayez chaque exercice pour approfondir votre compréhension.

Exercice 1 : Téléchargement de fichier de base

Suivez les instructions suivantes pour écrire un code de téléchargement de fichier de base.

Installez la bibliothèque requests.
Choisissez un fichier et envoyez une requête POST à l’URL de destination.
Affichez le code de statut pour vérifier le succès du téléchargement.

Exemple

import requests

url = 'https://example.com/upload'
files = {'file': open('example.txt', 'rb')}
response = requests.post(url, files=files)
print(response.status_code)

Exercice 2 : Téléchargement de données de formulaire multipart

Suivez les instructions suivantes pour écrire un code de téléchargement de données de formulaire multipart.

Envoyez un fichier avec un nom d’utilisateur et une description en tant que données de formulaire.
Envoyez une requête POST à l’URL de destination.
Affichez le code de statut pour vérifier le succès du téléchargement.

Exemple

import requests

url = 'https://example.com/upload'
files = {'file': open('example.txt', 'rb')}
data = {'username': 'testuser', 'description': 'Test file upload'}
response = requests.post(url, files=files, data=data)
print(response.status_code)

Exercice 3 : Ajout de la gestion des erreurs au téléchargement de fichiers

Suivez les instructions suivantes pour écrire un code de téléchargement de fichiers avec gestion des erreurs.

Ajoutez un bloc try-except au code de téléchargement de fichier de base.
Gérez les erreurs de connexion, de délai d’attente et HTTP de manière appropriée.

Exemple

import requests

url = 'https://example.com/upload'
files = {'file': open('example.txt', 'rb')}

try:
    response = requests.post(url, files=files, timeout=10)
    response.raise_for_status()
except requests.exceptions.Timeout:
    print('La requête a expiré')
except requests.exceptions.ConnectionError:
    print('Une erreur de connexion s'est produite')
except requests.exceptions.HTTPError as http_err:
    print(f'Une erreur HTTP s'est produite : {http_err}')
except requests.exceptions.RequestException as e:
    print(f'Une autre erreur s'est produite : {e}')
else:
    print('Le fichier a été téléchargé avec succès')

Exercice 4 : Téléchargement de plusieurs fichiers

Suivez les instructions suivantes pour écrire un code permettant de télécharger plusieurs fichiers en une seule fois.

Sélectionnez au moins deux fichiers et envoyez une requête POST à l’URL de destination.
Affichez le code de statut pour vérifier le succès du téléchargement.

Exemple

import requests

url = 'https://example.com/upload'
files = {
    'file1': open('example1.txt', 'rb'),
    'file2': open('example2.txt', 'rb')
}
response = requests.post(url, files=files)
print(response.status_code)

Exercice 5 : Téléchargement de fichiers avec authentification

Suivez les instructions suivantes pour écrire un code permettant de télécharger des fichiers avec authentification.

Utilisez une authentification HTTP basique ou par jeton pour télécharger le fichier.
Envoyez une requête POST à l’URL de destination.
Affichez le code de statut pour vérifier le succès du téléchargement.

Exemple (authentification HTTP basique)

import requests

url = 'https://example.com/upload'
auth = ('username', 'password')
files = {'file': open('example.txt', 'rb')}
response = requests.post(url, files=files, auth=auth)
print(response.status_code)

En réalisant ces exercices, vous apprendrez à appliquer diverses techniques de téléchargement de fichiers avec la bibliothèque requests. Passons maintenant à un résumé de cet article.

Conclusion

Dans cet article, nous avons expliqué comment télécharger des fichiers en Python avec la bibliothèque requests, des bases aux techniques avancées. Voici les points principaux :

Installation de la bibliothèque requests : facile à installer avec la commande pip install requests.
Téléchargement de fichiers de base : nous avons appris comment télécharger un seul fichier.
Téléchargement de données de formulaire multipart : comment envoyer des fichiers avec d’autres données de formulaire.
Gestion des erreurs : nous avons vu comment gérer les erreurs pendant le téléchargement de fichiers.
Téléchargement de plusieurs fichiers : comment télécharger plusieurs fichiers à la fois.
Téléchargement de fichiers avec authentification : comment inclure les informations d’authentification dans le téléchargement.

En utilisant ces connaissances, vous pouvez développer vos compétences pour télécharger des fichiers dans divers scénarios. N’hésitez pas à vous entraîner avec les exercices pour renforcer votre compréhension.