summaryrefslogtreecommitdiff
path: root/sleekxmpp/xmlstream/matcher/base.py
blob: 701ab32f2fb56bc0452fcb2ca83335a2377c332b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
"""
    SleekXMPP: The Sleek XMPP Library
    Copyright (C) 2010  Nathanael C. Fritz
    This file is part of SleekXMPP.

    See the file LICENSE for copying permission.
"""


class MatcherBase(object):

    """
    Base class for stanza matchers. Stanza matchers are used to pick
    stanzas out of the XML stream and pass them to the appropriate
    stream handlers.
    """

    def __init__(self, criteria):
        """
        Create a new stanza matcher.

        Arguments:
            criteria -- Object to compare some aspect of a stanza
                        against.
        """
        self._criteria = criteria

    def match(self, xml):
        """
        Check if a stanza matches the stored criteria.

        Meant to be overridden.
        """
        return False