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