1# Copyright (c) 2006,2007,2008 Mitch Garnaat http://garnaat.org/
2#
3# Permission is hereby granted, free of charge, to any person obtaining a
4# copy of this software and associated documentation files (the
5# "Software"), to deal in the Software without restriction, including
6# without limitation the rights to use, copy, modify, merge, publish, dis-
7# tribute, sublicense, and/or sell copies of the Software, and to permit
8# persons to whom the Software is furnished to do so, subject to the fol-
9# lowing conditions:
10#
11# The above copyright notice and this permission notice shall be included
12# in all copies or substantial portions of the Software.
13#
14# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
15# OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABIL-
16# ITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
17# SHALL THE AUTHOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
18# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
19# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
20# IN THE SOFTWARE.
21
22class Key(object):
23
24    @classmethod
25    def from_path(cls, *args, **kwds):
26        raise NotImplementedError("Paths are not currently supported")
27
28    def __init__(self, encoded=None, obj=None):
29        self.name = None
30        if obj:
31            self.id = obj.id
32            self.kind = obj.kind()
33        else:
34            self.id = None
35            self.kind = None
36
37    def app(self):
38        raise NotImplementedError("Applications are not currently supported")
39
40    def kind(self):
41        return self.kind
42
43    def id(self):
44        return self.id
45
46    def name(self):
47        raise NotImplementedError("Key Names are not currently supported")
48
49    def id_or_name(self):
50        return self.id
51
52    def has_id_or_name(self):
53        return self.id is not None
54
55    def parent(self):
56        raise NotImplementedError("Key parents are not currently supported")
57
58    def __str__(self):
59        return self.id_or_name()
60