subproceso: argumento de palabra clave inesperado capture_output

Al ejecutar subprocess.run() como se da en el Documentos de Pythonobtengo un TypeError:

>>> import subprocess
>>> subprocess.run(["ls", "-l", "/dev/null"], capture_output=True)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "/usr/lib/python3.6/subprocess.py", line 403, in run
    with Popen(*popenargs, **kwargs) as process:
TypeError: __init__() got an unexpected keyword argument 'capture_output'

Estoy ejecutando Python 3.6.6:

$ python3 --version
Python 3.6.6

Inspeccionó la documentación incorrecta, para python-3.6 este parámetro no no existen, como se puede encontrar en el documentación (usted selecciona la versión en la parte superior izquierda):

subprocess.run(args, *, stdin=None, input=None, stdout=None, stderr=None,
               shell=False, cwd=None, timeout=None, check=False, encoding=None,
               errors=None, env=None)

Sin embargo, puede “emular” esto fácilmente configurando ambos stdout y stderr a PIPE:

from subprocess import PIPE

subprocess.run(["ls", "-l", "/dev/null"], stdout=PIPE, stderr=PIPE)

De hecho, si miramos el código fuente de la versión python-3.7, donde se introdujo la característica, vemos en el código fuente [GitHub]:

if capture_output:
    if ('stdout' in kwargs) or ('stderr' in kwargs):
        raise ValueError('stdout and stderr arguments may not be used '
                         'with capture_output.')
    kwargs['stdout'] = PIPE
    kwargs['stderr'] = PIPE

El método más simple es usar el subproceso.check_output función:

import subprocess
subprocess.check_output(["ls", "-l", "/dev/null"])

Me encontré con este error porque estaba llamando subprocess.call (que es la antigua API de alto nivel) en lugar de subprocess.run.