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