Re: cpython: Add documentation for the new PyErr_SetFromImport* functions

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
2 messages Options
Reply | Threaded
Open this post in threaded view
|

Re: cpython: Add documentation for the new PyErr_SetFromImport* functions

Georg Brandl-2
On 16.04.2012 22:14, brian.curtin wrote:

> http://hg.python.org/cpython/rev/5cc8b717b38c
> changeset:   76363:5cc8b717b38c
> user:        Brian Curtin<[hidden email]>
> date:        Mon Apr 16 15:14:36 2012 -0500
> summary:
>    Add documentation for the new PyErr_SetFromImport* functions
>
> files:
>    Doc/c-api/exceptions.rst |  18 ++++++++++++++++++
>    1 files changed, 18 insertions(+), 0 deletions(-)
>
>
> diff --git a/Doc/c-api/exceptions.rst b/Doc/c-api/exceptions.rst
> --- a/Doc/c-api/exceptions.rst
> +++ b/Doc/c-api/exceptions.rst
> @@ -229,6 +229,24 @@
>      Similar to :c:func:`PyErr_SetFromWindowsErrWithFilename`, with an additional
>      parameter specifying the exception type to be raised. Availability: Windows.
>
> +.. c:function:: PyObject* PyErr_SetExcWithArgsKwargs(PyObject *exc, PyObject *args, PyObject *kwargs)
> +
> +   This is a convenience function to set an *exc* with the given *args* and
> +   *kwargs* values. If *args* is ``NULL``, an empty :func:`tuple` will be
> +   created when *exc* is created via :c:func:`PyObject_Call`.
> +
> +.. c:function:: PyObject* PyErr_SetFromImportErrorWithName(PyObject *msg, PyObject *name)
> +
> +   This is a convenience function to raise :exc:`ImportError`. *msg* will be
> +   set as the exception's message string, and *name* will be set as the
> +   :exc:`ImportError`'s ``name`` attribute.
> +
> +.. c:function:: PyObject* PyErr_SetFromImportErrorWithNameAndPath(PyObject *msg, PyObject *name, PyObject *path)
> +
> +   This is a convenience function to raise :exc:`ImportError`. *msg* will be
> +   set as the exception's message string. Both *name* and *path* will be set
> +   as the :exc:`ImportError`'s respective ``name`` and ``path`` attributes.
> +

versionadded please.

Georg

_______________________________________________
Python-Dev mailing list
[hidden email]
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: http://mail.python.org/mailman/options/python-dev/lists%2B1324100855712-1801473%40n6.nabble.com
Reply | Threaded
Open this post in threaded view
|

Re: cpython: Add documentation for the new PyErr_SetFromImport* functions

Brian Curtin
On Mon, Apr 16, 2012 at 18:02, Georg Brandl <[hidden email]> wrote:

> On 16.04.2012 22:14, brian.curtin wrote:
>>
>> http://hg.python.org/cpython/rev/5cc8b717b38c
>> changeset:   76363:5cc8b717b38c
>> user:        Brian Curtin<[hidden email]>
>> date:        Mon Apr 16 15:14:36 2012 -0500
>> summary:
>>   Add documentation for the new PyErr_SetFromImport* functions
>>
>> files:
>>   Doc/c-api/exceptions.rst |  18 ++++++++++++++++++
>>   1 files changed, 18 insertions(+), 0 deletions(-)
>>
>>
>> diff --git a/Doc/c-api/exceptions.rst b/Doc/c-api/exceptions.rst
>> --- a/Doc/c-api/exceptions.rst
>> +++ b/Doc/c-api/exceptions.rst
>> @@ -229,6 +229,24 @@
>>     Similar to :c:func:`PyErr_SetFromWindowsErrWithFilename`, with an
>> additional
>>     parameter specifying the exception type to be raised. Availability:
>> Windows.
>>
>> +.. c:function:: PyObject* PyErr_SetExcWithArgsKwargs(PyObject *exc,
>> PyObject *args, PyObject *kwargs)
>> +
>> +   This is a convenience function to set an *exc* with the given *args*
>> and
>> +   *kwargs* values. If *args* is ``NULL``, an empty :func:`tuple` will be
>> +   created when *exc* is created via :c:func:`PyObject_Call`.
>> +
>> +.. c:function:: PyObject* PyErr_SetFromImportErrorWithName(PyObject *msg,
>> PyObject *name)
>> +
>> +   This is a convenience function to raise :exc:`ImportError`. *msg* will
>> be
>> +   set as the exception's message string, and *name* will be set as the
>> +   :exc:`ImportError`'s ``name`` attribute.
>> +
>> +.. c:function:: PyObject*
>> PyErr_SetFromImportErrorWithNameAndPath(PyObject *msg, PyObject *name,
>> PyObject *path)
>> +
>> +   This is a convenience function to raise :exc:`ImportError`. *msg* will
>> be
>> +   set as the exception's message string. Both *name* and *path* will be
>> set
>> +   as the :exc:`ImportError`'s respective ``name`` and ``path``
>> attributes.
>> +
>
>
> versionadded please.

http://hg.python.org/cpython/rev/d79aa61ec96d
_______________________________________________
Python-Dev mailing list
[hidden email]
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: http://mail.python.org/mailman/options/python-dev/lists%2B1324100855712-1801473%40n6.nabble.com