Fully document subprocess.CalledProcessError

[ncoghlan]

BPO	14966
Nosy	@ncoghlan, @asvetlov, @swarmer

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2012-08-09.12:34:06.534>
created_at = <Date 2012-05-31.06:46:02.363>
labels = ['easy', 'type-feature', 'docs']
title = 'Fully document subprocess.CalledProcessError'
updated_at = <Date 2012-08-09.12:34:06.520>
user = 'https://github.com/ncoghlan'

bugs.python.org fields:

activity = <Date 2012-08-09.12:34:06.520>
actor = 'asvetlov'
assignee = 'docs@python'
closed = True
closed_date = <Date 2012-08-09.12:34:06.534>
closer = 'asvetlov'
components = ['Documentation']
creation = <Date 2012-05-31.06:46:02.363>
creator = 'ncoghlan'
dependencies = []
files = []
hgrepos = []
issue_num = 14966
keywords = ['easy']
message_count = 3.0
messages = ['161984', '162643', '167783']
nosy_count = 6.0
nosy_names = ['ncoghlan', 'cvrebert', 'asvetlov', 'docs@python', 'michael.driscoll', 'anton.barkovsky']
pr_nums = []
priority = 'normal'
resolution = 'duplicate'
stage = 'resolved'
status = 'closed'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue14966'
versions = ['Python 2.7', 'Python 3.2', 'Python 3.3']

[ncoghlan]

CalledProcessError provides a nice encapsulation for a returncode, the original command and any partial output. The API should be officially documented so that third party subprocess.Popen convenience wrappers can use it easily.

[michaeldriscoll]

I don't see the error, TimeoutExpired, documented either. At least the doc page mentions CalledProcessError a couple times. Do we want to use the docstring for CalledProcessError for the documentation page? Where on the page would it go? I assume we'd want an example showing how to use it?

[asvetlov]

Documented in bpo-15501. I like to close this issue as duplicate.
If anybody don't agree with closing feel free to reopen this one.