XEP 0086

1.6 Documentation

«  XEP 0085   ::   Contents   ::   XEP 0092  »

XEP 0086

class slixmpp.plugins.xep_0086.XEP_0086(xmpp, config=None)[source]

XEP-0086: Error Condition Mappings

Older XMPP implementations used code based error messages, similar to HTTP response codes. Since then, error condition elements have been introduced. XEP-0086 provides a mapping between the new condition elements and a combination of error types and the older response codes.

Also see <http://xmpp.org/extensions/xep-0086.html>.

Configuration Values:

override -- Indicates if applying legacy error codes should
            be done automatically. Defaults to True.
            If False, then inserting legacy error codes can
            be done using:
                iq['error']['legacy']['condition'] = ...
stanza = <module 'slixmpp.plugins.xep_0086.stanza' from '/home/docs/checkouts/readthedocs.org/user_builds/slixmpp/checkouts/slix-1.6.0/slixmpp/plugins/xep_0086/stanza.py'>

Stanza elements

Slixmpp: The Slick XMPP Library Copyright (C) 2011 Nathanael C. Fritz, Lance J.T. Stout This file is part of Slixmpp.

See the file LICENSE for copying permission.

class slixmpp.plugins.xep_0086.stanza.LegacyError(xml=None, parent=None)[source]

Older XMPP implementations used code based error messages, similar to HTTP response codes. Since then, error condition elements have been introduced. XEP-0086 provides a mapping between the new condition elements and a combination of error types and the older response codes.

Also see <http://xmpp.org/extensions/xep-0086.html>.

Example legacy error stanzas:

<error xmlns="jabber:client" code="501" type="cancel">
  <feature-not-implemented
        xmlns="urn:ietf:params:xml:ns:xmpp-stanzas" />
</error>

<error code="402" type="auth">
  <payment-required
        xmlns="urn:ietf:params:xml:ns:xmpp-stanzas" />
</error>
Variables

error_map – A map of error conditions to error types and code values.

error_map = {'bad-request': ('modify', '400'), 'conflict': ('cancel', '409'), 'feature-not-implemented': ('cancel', '501'), 'forbidden': ('auth', '403'), 'gone': ('modify', '302'), 'internal-server-error': ('wait', '500'), 'item-not-found': ('cancel', '404'), 'jid-malformed': ('modify', '400'), 'not-acceptable': ('modify', '406'), 'not-allowed': ('cancel', '405'), 'not-authorized': ('auth', '401'), 'payment-required': ('auth', '402'), 'recipient-unavailable': ('wait', '404'), 'redirect': ('modify', '302'), 'registration-required': ('auth', '407'), 'remote-server-not-found': ('cancel', '404'), 'remote-server-timeout': ('wait', '504'), 'resource-constraint': ('wait', '500'), 'service-unavailable': ('cancel', '503'), 'subscription-required': ('auth', '407'), 'undefined-condition': (None, '500'), 'unexpected-request': ('wait', '400')}
interfaces = {'condition'}
name = 'legacy'
namespace = 'jabber:client'
overrides = ['set_condition']
plugin_attrib = 'legacy'
set_condition(value)[source]

Set the error type and code based on the given error condition value.

Parameters

value – The new error condition.

setup(xml)[source]

Don’t create XML for the plugin.

«  XEP 0085   ::   Contents   ::   XEP 0092  »