# `pipes` — Interface au pipelines shell

Code source : Lib/pipes.py

Obsolète depuis la version 3.11: The `pipes` module is deprecated (see PEP 594 for details). Please use the `subprocess` module instead.

Le module `pipes` définit une classe permettant d'abstraire le concept de pipeline --- une séquence de convertisseurs d'un fichier vers un autre.

Du fait que le module utilise les lignes de commandes /bin/sh, un shell POSIX ou compatible est requis pour `os.system()` et `os.popen()`.

Le module `pipes` définit la classe suivante :

class `pipes.``Template`

  Une abstraction d'un pipeline.

Exemple :

    >>> import pipes
    >>> t = pipes.Template()
    >>> t.append('tr a-z A-Z', '--')
    >>> f = t.open('pipefile', 'w')
    >>> f.write('hello world')
    >>> f.close()
    >>> open('pipefile').read()
    'HELLO WORLD'

## L'Objet Template

Les méthodes de l'objet Template :

`Template.``reset`()

  Réinitialise un modèle de pipeline à son état initial.

`Template.``clone`()

  Renvoie un nouveau modèle de pipeline, équivalent.

`Template.``debug`(flag)

  Si flag est vrai, active le débogage. Sinon, le désactive. Quand le débogage est actif, les commandes à exécuter seront affichée et le shell est pourvu de la commande `set -x` afin d'être plus verbeux.

`Template.``append`(cmd, kind)

  Ajoute une nouvelle action à la fin. La variable cmd doit être une commande bourne shell valide. La variable kind est composée de deux lettres.

  La première lettre peut soit être `'-'` (qui signifie que la commande lit sa sortie standard), soit `'f'` (qui signifie que la commande lit un fichier donné par la ligne de commande), soit `'.'` (qui signifie que la commande ne lit pas d'entrée, et donc doit être la première.)

  De même, la seconde lettre peut soit être `'-'` (qui signifie que la commande écrit sur la sortie standard), soit `'f'` (qui signifie que la commande écrit sur un fichier donné par la ligne de commande), soit `'.'` (qui signifie que la commande n'écrit rien, et donc doit être la dernière.)

`Template.``prepend`(cmd, kind)

  Ajoute une nouvelle action au début. Voir `append()` pour plus d'explications sur les arguments.

`Template.``open`(file, mode)

  Renvoie un objet file-like, ouvert à file, mais permettant d'écrire vers le pipeline ou de lire depuis celui-ci. À noter que seulement un des deux ('r' ou 'w') peut être donné.

`Template.``copy`(infile, outfile)

  Copie infile vers outfile au travers du pipe.