11.6. tempfile
— Génération de fichiers et répertoires temporaires¶
Code source : Lib/tempfile.py
Ce module crée des fichiers et répertoires temporaires. Il fonctionne sur toutes les plateformes supportées. TemporaryFile
, NamedTemporaryFile
, TemporaryDirectory
, et SpooledTemporaryFile
sont des interfaces haut-niveau qui fournissent un nettoyage automatique et peuvent être utilisées comme gestionnaire de contexte. mkstemp()
et mkdtemp()
sont des fonctions bas-niveau qui nécessitent un nettoyage manuel.
Toutes les fonctions et constructeurs appelables par l’utilisateur ont des arguments additionnels qui permettent de contrôler directement le chemin et le nom des répertoires et fichiers. Les noms de fichiers utilisés par ce module incluent une chaîne de caractères aléatoires qui leur permet d’être créés de manière sécurisée dans des répertoires temporaires partagés. Afin de maintenir la compatibilité descendante, l’ordre des arguments est quelque peu étrange ; pour des questions de clarté, il est recommandé d’utiliser les arguments nommés.
Le module définit les éléments suivants pouvant être appelés par l’utilisateur :
-
tempfile.
TemporaryFile
(mode='w+b', buffering=None, encoding=None, newline=None, suffix=None, prefix=None, dir=None)¶ Renvoie un objet fichier qui peut être utilisé comme une zone de stockage temporaire. Le fichier est créé de manière sécurisé, utilisant les mêmes règles que
mkstemp()
. Il sera détruit dès qu’il sera fermé (y compris lorsque le fichier est implicitement fermé quand il est collecté par le ramasse-miette). Sous Unix, l’entrée du répertoire n’est soit pas du tout créée, ou est supprimée immédiatement après sa création. Les autres plateformes ne gèrent pas cela, votre code ne doit pas compter sur un fichier temporaire créé en utilisant cette fonction ayant ou non un nom visible sur le système de fichier.L’objet résultat peut être utilisé comme un gestionnaire de contexte (voir Exemples). Une fois le contexte ou la destruction de l’objet fichier terminé, le fichier temporaire sera supprimé du système de fichiers.
Le paramètre mode vaut par défaut
'w+b'
afin que le fichier créé puisse être lu et écrit sans être fermé. Le mode binaire est utilisé afin que le comportement soit le même sur toutes les plateformes quelque soit la donnée qui est stockée. buffering, encoding et newline sont interprétés de la même façon que pouropen()
.Les paramètres dir, prefix et suffix ont la même signification et même valeur par défaut que
mkstemp()
.L’objet renvoyé est un véritable fichier sur les plateformes POSIX. Sur les autres plateformes, un objet fichier-compatible est retourné où l’attribut
file
est le véritable fichier.L’option
os.O_TMPFILE
est utilisé s’il est disponible et fonctionne (Linux exclusivement, nécessite un noyau Linux 3.11 ou plus).Modifié dans la version 3.5: L’option
os.O_TMPFILE
est maintenant utilisé si disponible.
-
tempfile.
NamedTemporaryFile
(mode='w+b', buffering=None, encoding=None, newline=None, suffix=None, prefix=None, dir=None, delete=True)¶ Cette fonction fonctionne exactement comme
TemporaryFile()
, à la différence qu’il est garanti que le fichier soit visible dans le système de fichier (sur Unix, l’entrée du répertoire est supprimée). Le nom peut être récupéré depuis l’attributname
de l’objet fichier-compatible retourné. Le fait que le nom puisse être utilisé pour ouvrir le fichier une seconde fois, tant que le fichier temporaire nommé est toujours ouvert, varie entre les plateformes (cela peut l’être sur Unix, mais c’est impossible sur Windows NT et plus). Si delete est vrai (valeur par défaut), le fichier est supprimé dès qu’il est fermé. L’objet retourné est toujours un objet fichier-compatible où l’attributfile
est le véritable fichier. L’objet fichier-compatible peut être utilisé dans un gestionnaire de contexte (instructionwith
), juste comme un fichier normal.
-
tempfile.
SpooledTemporaryFile
(max_size=0, mode='w+b', buffering=None, encoding=None, newline=None, suffix=None, prefix=None, dir=None)¶ Cette fonction se comporte exactement comme
TemporaryFile()
, à l’exception que les données sont stockées en mémoire jusqu’à ce que leur taille dépasse max_size, ou que la méthodefileno()
soit appelée. À ce moment, le contenu est écrit sur disque et le fonctionnement redevient similaire à celui deTemporaryFile()
.Le fichier renvoyé a une méthode supplémentaire,
rollover()
, qui provoque la mise en écriture sur disque quelque soit la taille du fichier.L’objet renvoyé est un objet fichier-compatible où l’attribut
_file
est soit un objetio.BytesIO
soit un objetio.StringIO
(en fonction du mode) soit un véritable fichier, si la fonctionrollover()
a été appelée. Cet objet fichier-compatible peut être utilisé dans un gestionnaire de contexte (instructionwith
), comme un fichier normal.Modifié dans la version 3.3: la méthode de troncature accepte maintenant un argument
size
.
-
tempfile.
TemporaryDirectory
(suffix=None, prefix=None, dir=None)¶ Cette fonction crée un répertoire temporaire de manière sécurisée utilisant les mêmes règles que
mkdtemp()
. L’objet renvoyé peut être utilisé comme un gestionnaire de contexte (voir Exemples). À la sortie du contexte d’exécution ou à la destruction de l’objet, le répertoire temporaire et tout son contenu sont supprimés du système de fichiers.The directory name can be retrieved from the
name
attribute of the returned object. When the returned object is used as a context manager, thename
will be assigned to the target of theas
clause in thewith
statement, if there is one.Le répertoire peut être explicitement nettoyé en appelant la méthode
cleanup()
.Nouveau dans la version 3.2.
-
tempfile.
mkstemp
(suffix=None, prefix=None, dir=None, text=False)¶ Crée un fichier temporaire de la manière la plus sécurisée qui soit. Il n’y a pas d’accès concurrent (
race condition
) au moment de la création du fichier, en supposant que la plateforme implémente correctement l’optionos.O_EXCL
pouros.open()
. Le fichier est seulement accessible en lecture et écriture par l’ID de l’utilisateur créateur. Si la plateforme utilise des bits de permissions pour indiquer si le fichier est exécutable, alors le fichier n’est exécutable par personne. Le descripteur de fichier n’est pas hérité par les processus fils.À la différence de
TemporaryFile()
, l’utilisateur demkstemp()
est responsable de la suppression du fichier temporaire quand il n’en a plus besoin.Si suffix ne vaut pas
None
, le nom de fichier se terminera avec ce suffixe, sinon il n’y aura pas de suffixe.mkstemp()
ne met pas de point entre le nom du fichier et le suffixe. Si vous en avez besoin, mettez le point au début de suffix.Si prefix ne vaut pas
None
, le nom de fichier commencera avec ce préfixe, sinon un préfixe par défaut est utilisé. La valeur par défaut est la valeur retournée pargettempprefix()
ougettempprefixb()
.Si dir ne vaut pas
None
, le fichier sera créé dans ce répertoire, autrement, un répertoire par défaut sera utilisé. Le répertoire par défaut est choisi depuis une liste dépendante de la plateforme, mais l’utilisateur de l’application peut contrôler l’emplacement du répertoire en spécifiant les variables d’environnement TMPDIR, TEMP ou TMP. Il n’y a pas de garantie que le nom de fichier généré aura de bonnes propriétés telles que ne pas avoir besoin de le mettre entre guillemets lorsque celui-ci est passé à des commandes externes viaos.popen()
.Si l’un des paramètres suffix, prefix et dir n’est pas
None
, ils doivent être du même type. S’ils sont de typebytes
, le nom renvoyée sera de typebytes
plutôt que de typestr
. Si vous voulez forcer la valeur renvoyée enbytes
, passezsuffix=b''
.Si text est spécifié, cela indique si le fichier doit être ouvert en mode binaire (par défaut) ou en mode texte. Sur certaines plateformes, cela ne fait aucune différence.
mkstemp()
renvoie un n-uplet contenant un descripteur (handle en anglais) au niveau du système d’exploitation vers un fichier ouvert (le même que renvoieos.open()
) et le chemin d’accès absolu de ce fichier, dans cet ordre.Modifié dans la version 3.5: suffix, prefix, et dir peuvent maintenant être spécifiés en
bytes
pour obtenir un résultat enbytes
. Avant cela, le typestr
était le seul autorisé. suffix et prefix acceptent maintenant la valeur par défautNone
pour que la valeur par défaut appropriée soit utilisée.
-
tempfile.
mkdtemp
(suffix=None, prefix=None, dir=None)¶ Crée un répertoire temporaire de la manière la plus sécurisée qu’il soit. Il n’y a pas d’accès concurrent (
race condition
) au moment de la création du répertoire. Le répertoire est accessible en lecture, en écriture, et son contenu lisible uniquement pour l’ID de l’utilisateur créateur.L’utilisateur de
mkdtemp()
est responsable de la suppression du répertoire temporaire et de son contenu lorsqu’il n’en a plus besoin.Les arguments prefix, suffix, et dir sont les mêmes que pour
mkstemp()
.mkdtemp()
renvoie le chemin absolu du nouveau répertoire.Modifié dans la version 3.5: suffix, prefix, et dir peuvent maintenant être spécifiés en
bytes
pour obtenir un résultat enbytes
. Avant cela, le typestr
était le seul autorisé. suffix et prefix acceptent maintenant la valeur par défautNone
pour que la valeur par défaut appropriée soit utilisée.
-
tempfile.
gettempdir
()¶ Renvoie le nom du répertoire utilisé pour les fichiers temporaires. C’est la valeur par défaut pour l’argument dir de toutes les fonctions de ce module.
Python cherche un répertoire parmi une liste standard de répertoires dans lequel l’utilisateur final peut créer des fichiers. La liste est :
- Le répertoire correspondant à la variable d’environnement
TMPDIR
. - Le répertoire correspondant à la variable d’environnement
TEMP
. - Le répertoire correspondant à la variable d’environnement
TMP
. - Un emplacement dépendant à la plateforme :
- Sur Windows, les répertoires
C:\TEMP
,C:\TMP
,\TEMP
, et\TMP
, dans cet ordre. - Sur toutes les autres plate-formes, les répertoires
/tmp
,/var/tmp
, et/usr/tmp
, dans cet ordre.
- Sur Windows, les répertoires
- En dernier ressort, le répertoire de travail courant.
Le résultat de cette recherche est mis en cache, voir la description de
tempdir
dessous.- Le répertoire correspondant à la variable d’environnement
-
tempfile.
gettempdirb
()¶ Similaire à
gettempdir()
mais la valeur retournée est en bytes.Nouveau dans la version 3.5.
-
tempfile.
gettempprefix
()¶ Renvoie le préfixe de nom de fichier utilisé pour créer les fichiers temporaires. Cela ne contient pas le nom du répertoire.
-
tempfile.
gettempprefixb
()¶ Similaire à
gettempprefix()
mais la valeur retournée est en bytes.Nouveau dans la version 3.5.
The module uses a global variable to store the name of the directory
used for temporary files returned by gettempdir()
. It can be
set directly to override the selection process, but this is discouraged.
All functions in this module take a dir argument which can be used
to specify the directory and this is the recommended approach.
-
tempfile.
tempdir
¶ When set to a value other than
None
, this variable defines the default value for the dir argument to the functions defined in this module.If
tempdir
is unset orNone
at any call to any of the above functions exceptgettempprefix()
it is initialized following the algorithm described ingettempdir()
.
11.6.1. Exemples¶
Voici quelques exemples classiques d’utilisation du module tempfile
:
>>> import tempfile
# create a temporary file and write some data to it
>>> fp = tempfile.TemporaryFile()
>>> fp.write(b'Hello world!')
# read data from file
>>> fp.seek(0)
>>> fp.read()
b'Hello world!'
# close the file, it will be removed
>>> fp.close()
# create a temporary file using a context manager
>>> with tempfile.TemporaryFile() as fp:
... fp.write(b'Hello world!')
... fp.seek(0)
... fp.read()
b'Hello world!'
>>>
# file is now closed and removed
# create a temporary directory using the context manager
>>> with tempfile.TemporaryDirectory() as tmpdirname:
... print('created temporary directory', tmpdirname)
>>>
# directory and contents have been removed
11.6.2. Fonctions et variables obsolètes¶
Historiquement, la méthode pour créer des fichiers temporaires consistait à générer un nom de fichier avec la fonction mktemp()
puis créer un fichier en utilisant ce nom. Malheureusement, cette méthode n’est pas fiable car un autre processus peut créer un fichier avec ce nom entre l’appel à la fonction mktemp()
et la tentative de création de fichier par le premier processus en cours. La solution est de combiner les deux étapes et de créer le fichier immédiatement. Cette approche est utilisée par mkstemp()
et les autres fonctions décrites plus haut.
-
tempfile.
mktemp
(suffix='', prefix='tmp', dir=None)¶ Obsolète depuis la version 2.3: Utilisez
mkstemp()
à la place.Renvoie le chemin absolu d’un fichier qui n’existe pas lorsque l’appel est fait. Les arguments prefix, suffix, et dir sont similaires à ceux de
mkstemp()
mais les noms de fichiers en _bytes_,sufix=None
etprefix=None
ne sont pas implémentées.Avertissement
Utiliser cette fonction peut introduire une faille de sécurité dans votre programme. Avant que vous n’ayez le temps de faire quoi que ce soit avec le nom de fichier renvoyé, quelqu’un peut l’utiliser. L’utilisation de
mktemp()
peut être remplacée facilement avecNamedTemporaryFile()
en y passant le paramètredelete=False
:>>> f = NamedTemporaryFile(delete=False) >>> f.name '/tmp/tmptjujjt' >>> f.write(b"Hello World!\n") 13 >>> f.close() >>> os.unlink(f.name) >>> os.path.exists(f.name) False