def is_system_principal(self):
"""
Determine if the current user is the default system user.
@return: true if the current user is the system user, false otherwise
@rtype: bool
"""
return self.get_principal() is system.SystemUser()
def set_principal(self, principal=None):
"""
Set the current user of the system to the provided principal,
if no principal is provided, set the current user to the system user.
@param principal: current user
@type principal: User or None
"""
_PRINCIPAL_STORAGE.principal = principal or system.SystemUser()
def get_principal(self):
"""
Get the current user of the system,
returning the default system user if there isn't one.
@return: current user of the system
@rtype: User or dict
"""
return getattr(_PRINCIPAL_STORAGE, 'principal', system.SystemUser())
def clear_principal(self):
"""
Clear the current user of the system.
"""
_PRINCIPAL_STORAGE.principal = system.SystemUser()