5f4d1c1c8630e12c40c52b047f45a90e8aa7dcca
[plcapi.git] / PLC / Methods / AddAddressTypeToAddress.py
1 from PLC.Faults import *
2 from PLC.Method import Method
3 from PLC.Parameter import Parameter, Mixed
4 from PLC.AddressTypes import AddressType, AddressTypes
5 from PLC.Addresses import Address, Addresses
6 from PLC.Auth import Auth
7
8 class AddAddressTypeToAddress(Method):
9     """
10     Adds an address type to the specified address.
11
12     PIs may only update addresses of their own sites.
13
14     Returns 1 if successful, faults otherwise.
15     """
16
17     roles = ['admin', 'pi']
18
19     accepts = [
20         Auth(),
21         Mixed(AddressType.fields['address_type_id'],
22               AddressType.fields['name']),
23         Address.fields['address_id']
24         ]
25
26     returns = Parameter(int, '1 if successful')
27
28     event_type = 'AddTo'
29     object_type = 'Address'
30
31     def call(self, auth, address_type_id_or_name, address_id):
32         address_types = AddressTypes(self.api, [address_type_id_or_name])
33         if not address_types:
34             raise PLCInvalidArgument, "No such address type"
35         address_type = address_types[0]
36
37         addresses = Addresses(self.api, [address_id])
38         if not addresses:
39             raise PLCInvalidArgument, "No such address"
40         address = addresses[0]
41
42         if 'admin' not in self.caller['roles']:
43             if address['site_id'] not in self.caller['site_ids']:
44                 raise PLCPermissionDenied, "Address must be associated with one of your sites"
45
46         address.add_address_type(address_type)
47         self.object_ids = [address['address_id']]
48
49         return 1