e85d2e9148f283b62de93d86b04872debad42f3e
[plcapi.git] / PLC / Methods / DeletePerson.py
1 from PLC.Faults import *
2 from PLC.Method import Method
3 from PLC.Parameter import Parameter, Mixed
4 from PLC.Persons import Person, Persons
5 from PLC.Auth import Auth
6
7 class DeletePerson(Method):
8     """
9     Mark an existing account as deleted.
10
11     Users and techs can only delete themselves. PIs can only delete
12     themselves and other non-PIs at their sites. ins can delete
13     anyone.
14
15     Returns 1 if successful, faults otherwise.
16     """
17
18     roles = ['admin', 'pi', 'user', 'tech']
19
20     accepts = [
21         Auth(),
22         Mixed(Person.fields['person_id'],
23               Person.fields['email'])
24         ]
25
26     returns = Parameter(int, '1 if successful')
27
28     def call(self, auth, person_id_or_email):
29         # Get account information
30         persons = Persons(self.api, [person_id_or_email])
31         if not persons:
32             raise PLCInvalidArgument, "No such account"
33         person = persons[0]
34
35         if person['peer_id'] is not None:
36             raise PLCInvalidArgument, "Not a local account"
37
38         # Authenticated function
39         assert self.caller is not None
40
41         # Check if we can update this account
42         if not self.caller.can_update(person):
43             raise PLCPermissionDenied, "Not allowed to delete specified account"
44
45         person.delete()
46
47         # Logging variables
48         self.event_objects = {'Person': [person['person_id']]}
49         self.message = 'Person %d deleted' % person['person_id']
50
51         return 1