Merge from HEAD. Signed off by tmack.
[plcapi.git] / PLC / Methods / SliceExtendedInfo.py
1 from PLC.Method import Method
2 from PLC.Parameter import Parameter, Mixed
3 from PLC.Filter import Filter
4 from PLC.Auth import Auth
5 from PLC.Slices import Slice, Slices
6 from PLC.SliceAttributes import SliceAttribute, SliceAttributes
7 from PLC.Sites import Site, Sites
8 from PLC.Nodes import Node, Nodes
9 from PLC.Persons import Person, Persons
10
11 class SliceExtendedInfo(Method):
12     """
13     Deprecated. Can be implemented with GetSlices.
14
15     Returns an array of structs containing details about slices. 
16     The summary can optionally include the list of nodes in and 
17     users of each slice.
18
19     Users may only query slices of which they are members. PIs may
20     query any of the slices at their sites. Admins may query any
21     slice. If a slice that cannot be queried is specified in
22     slice_filter, details about that slice will not be returned.
23     """
24
25     status = "deprecated"
26
27     roles = ['admin', 'pi', 'user']
28
29     accepts = [
30         Auth(),
31         [Slice.fields['name']],
32         Parameter(bool, "Whether or not to return users for the slices", nullok = True),
33         Parameter(bool, "Whether or not to return nodes for the slices", nullok = True)
34         ]
35
36     returns = [Slice.fields]
37     
38
39     def call(self, auth, slice_name_list=None, return_users=None, return_nodes=None, return_attributes=None):
40         # If we are not admin, make sure to return only viewable
41         # slices.
42         slice_filter = slice_name_list
43         slices = Slices(self.api, slice_filter)
44         if not slices:
45             raise PLCInvalidArgument, "No such slice"
46
47         if 'admin' not in self.caller['roles']:
48             # Get slices that we are able to view
49             valid_slice_ids = self.caller['slice_ids']
50             if 'pi' in self.caller['roles'] and self.caller['site_ids']:
51                 sites = Sites(self.api, self.caller['site_ids'])
52                 for site in sites:
53                     valid_slice_ids += site['slice_ids']
54
55             if not valid_slice_ids:
56                 return []
57           
58             slices = filter(lambda slice: slice['slice_id'] in valid_slice_ids, slices)
59
60         for slice in slices:
61             index = slices.index(slice)
62             node_ids = slices[index].pop('node_ids')
63             person_ids = slices[index].pop('person_ids')
64             attribute_ids = slices[index].pop('slice_attribute_ids')
65             if return_users or return_users is None:
66                 persons = Persons(self.api, person_ids)
67                 person_info = [{'email': person['email'], 
68                                 'person_id': person['person_id']} \
69                                for person in persons]
70                 slices[index]['users'] = person_info
71             if return_nodes or return_nodes is None:
72                 nodes = Nodes(self.api, node_ids)
73                 node_info = [{'hostname': node['hostname'], 
74                               'node_id': node['node_id']} \
75                              for node in nodes]
76                 slices[index]['nodes'] = node_info
77             if return_attributes or return_attributes is None:
78                 attributes = SliceAttributes(self.api, attribute_ids)
79                 attribute_info = [{'name': attribute['name'],
80                                    'value': attribute['value']} \
81                                   for attribute in attributes]
82                 slices[index]['attributes'] = attribute_info
83         
84         return slices