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