Lancement de process

status = subprocess.call(['ls', '-ls']) : appel système avec la liste des arguments, le stdout et le stderr du programme appelé sont redirigés vers celui du script python. Le statut de retour est fourni et l'appel est bloquant.

status = subprocess.call('ls -ls', shell = True) : exécute directement la ligne de commande (avec les risques de sécurité qui vont avec). L'appel est bloquant.

Redirection du stdout ou stderr du programme appelé :

• status = subprocess.call('ls -ls', stdout = myFh, shell = True) : on fournit un filehandle, myFh, dans lequel le stdout du programme fini (pareil avec stderr et stdin).
• subprocess.call(['ls', '-ls'], stdout = sys.stderr.fileno()) : pour rediriger le stdout d'un programme vers stderr.
• fh = open(os.devnull, 'w'); subprocess.call('ls -ls', stdout = fh, stderr = fh, shell = True) : pour supprimer toute sortie stdout ou stderr du programme appelé.

subprocess.check_call('ls -lsX', shell = True) : lève une exception subprocess.CalledProcessError si erreur (et l'erreur contient le code de retour, la commande appelé et l'output éventuel). L'appel est bloquant également.

try:
    subprocess.check_call('ls -lsz', shell = True)
except subprocess.CalledProcessError as e:
    print e.returncode
    print e.cmd
    print e.output
  

out = subprocess.check_output('ls -ls', shell = True) : lève aussi une exception subprocess.CalledProcessError, mais renvoie l'output de la commande dans la variable (ici out). L'appel est bloquant.

Si on veut lancer une commande dont on veut récupérer le stdout et le stderr même si l'exécution s'est mal passée : popen = subprocess.Popen(myCommand, shell = True, stdin = None, stdout = subprocess.PIPE, stderr = subprocess.PIPE); (out, err) = popen.communicate() on peut alors avoir le code de sortie avec popen.returncode pour vérifier s'il est à 0 ou non.

Appel système général avec Popen, bloquant ou non-bloquant :

• myPopen = subprocess.Popen(['cat', '-n']) : fait l'appel système non bloquant.
• si on veut pouvoir envoyer des données sur le stdin du process, il faut faire : myPopen = subprocess.Popen(['cat', '-n'], stdin = subprocess.PIPE).
• si on veut pouvoir récupérer des données de la sortie standard et de la sortie d'erreur du process, il faut faire : myPopen = subprocess.Popen(['cat', '-n'], stdout = subprocess.PIPE, stderr = subprocess.PIPE).
• myPopen.stdin, myPopen.stdout, myPopen.stderr : les entrées et sorties standard, quand elles ont été mises a subprocess.PIPE dans le constructeur.
• myPopen.stdout est de la classe file, dont on peut faire simplement :

  for line in myPopen.stdout:
    ...
      

• myPopen.pid : le process id.
• myPopen.returncode : le code de retour (0 si ça s'est bien passé), mais attention : avant d'appeler cette méthode, il faut appeler myPopen.wait() ou myPopen.poll()
• myPopen.terminate() et myPopen.kill() : stoppe ou tue le process (avec un signal SIGTERM ou SIGKILL respectivement).
• myPopen.poll() : renvoie le statut de retour si le programme appelé a terminé, sinon None s'il n'est pas fini.
• appel système bloquant :
  • (stdoutData, stderrData) = myPopen.communicate('my data') : envoie sur le stdin 'my data', attend la fin du process et récupère les sorties, mais il faut avoir mis comme paramètres stdin = subprocess.PIPE, stdout = subprocess.PIPE, stderr = subprocess.PIPE, donc ici, c'est une forme bloquante.
  • exemple avec forme bloquante :

    myPopen = subprocess.Popen(['cat', '-n'], stdin = subprocess.PIPE,
                             stdout = subprocess.PIPE, stderr = subprocess.PIPE)
    print 'PID', myPopen.pid
    (stdoutData, stderrData) = myPopen.communicate('ligne1
    ligne2
    ligne3
    ')
    print stdoutData
    print myPopen.returncode
          

• appel système non bloquant :
  • utiliser myPopen.poll() pour savoir si le programme a terminé, et utiliser myPopen.stdin, myPopen.stdout et myPopen.stderr pour communiquer avec le programme.
  • exemple avec forme non bloquante :

    myPopen = subprocess.Popen(['cat', '-n'], stdin = subprocess.PIPE,
                             stdout = subprocess.PIPE, stderr = subprocess.PIPE)
    myPopen.stdin.write('ligne1
    ligne2
    ligne3
    ')
    myPopen.stdin.close()
    while True:
        status = myPopen.poll()
        if status is not None:
            break
    for line in myPopen.stdout:
        sys.stdout.write(line)
    print status
          

  • attention : s'il y a une sortie à lire et que celle-ci ne tient pas dans le buffer courant, poll() continuera à renvoyer None. Il faut alors lire la sortie avant !
• attention : il y a aussi une fonction myPopen.wait() qui attend que le process soit terminé, mais si stdout ou stderr ont été fixés à PIPE, et que le buffer est plein (et non lu), la fonction va deadlock (bloquer indéfiniment).