91308928285e79cb6858bcf615967f20edee9651
[plcapi.git] / PLC / Methods / DeleteRoleFromPerson.py
1 # $Id$
2 from PLC.Faults import *
3 from PLC.Method import Method
4 from PLC.Parameter import Parameter, Mixed
5 from PLC.Persons import Person, Persons
6 from PLC.Auth import Auth
7 from PLC.Roles import Role, Roles
8
9 class DeleteRoleFromPerson(Method):
10     """
11     Deletes the specified role from the person.
12     
13     PIs can only revoke the tech and user roles from users and techs
14     at their sites. ins can revoke any role from any user.
15
16     Returns 1 if successful, faults otherwise.
17     """
18
19     roles = ['admin', 'pi']
20
21     accepts = [
22         Auth(),
23         Mixed(Role.fields['role_id'],
24               Role.fields['name']),
25         Mixed(Person.fields['person_id'],
26               Person.fields['email']),
27         ]
28
29     returns = Parameter(int, '1 if successful')
30
31     def call(self, auth, role_id_or_name, person_id_or_email):
32         # Get role
33         roles = Roles(self.api, [role_id_or_name])
34         if not roles:
35             raise PLCInvalidArgument, "Invalid role '%s'" % unicode(role_id_or_name)
36         role = roles[0]
37
38         # Get account information
39         persons = Persons(self.api, [person_id_or_email])
40         if not persons:
41             raise PLCInvalidArgument, "No such account"
42         person = persons[0]
43
44         if person['peer_id'] is not None:
45             raise PLCInvalidArgument, "Not a local account"
46
47         # Authenticated function
48         assert self.caller is not None
49
50         # Check if we can update this account
51         if not self.caller.can_update(person):
52             raise PLCPermissionDenied, "Not allowed to update specified account"
53
54         # Can only revoke lesser (higher) roles from others
55         if 'admin' not in self.caller['roles'] and \
56            role['role_id'] <= min(self.caller['role_ids']):
57             raise PLCPermissionDenied, "Not allowed to revoke that role"
58
59         if role['role_id'] in person['role_ids']:
60             person.remove_role(role)
61         
62         # Logging variables
63         self.event_objects = {'Person': [person['person_id']],
64                               'Role': [role['role_id']]}        
65         self.message = "Role %d revoked from person %d" % \
66                        (role['role_id'], person['person_id'])
67
68         return 1