cfe815e78f2e180dbe7aae328ef3e0cd10b7ecc0
[plcapi.git] / PLC / Methods / SliceInfo.py
1 # $Id$
2 from PLC.Method import Method
3 from PLC.Parameter import Parameter, Mixed
4 from PLC.Faults import *
5 from PLC.Filter import Filter
6 from PLC.Auth import Auth
7 from PLC.Slices import Slice, Slices
8 from PLC.Sites import Site, Sites
9 from PLC.Persons import Person, Persons
10 from PLC.Nodes import Node, Nodes
11
12 class SliceInfo(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         [Mixed(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):
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
62         for slice in slices:
63             index = slices.index(slice)
64             node_ids = slices[index].pop('node_ids')
65             person_ids = slices[index].pop('person_ids')
66             if return_users or return_users is None:
67                 persons = Persons(self.api, person_ids)
68                 emails = [person['email'] for person in persons]
69                 slices[index]['users'] = emails
70             if return_nodes or return_nodes is None:
71                 nodes = Nodes(self.api, node_ids)
72                 hostnames = [node['hostname'] for node in nodes]
73                 slices[index]['nodes'] = hostnames
74                 
75         
76         return slices