1 # Copyright 2011-2012 GRNET S.A. All rights reserved.
3 # Redistribution and use in source and binary forms, with or
4 # without modification, are permitted provided that the following
7 # 1. Redistributions of source code must retain the above
8 # copyright notice, this list of conditions and the following
11 # 2. Redistributions in binary form must reproduce the above
12 # copyright notice, this list of conditions and the following
13 # disclaimer in the documentation and/or other materials
14 # provided with the distribution.
16 # THIS SOFTWARE IS PROVIDED BY GRNET S.A. ``AS IS'' AND ANY EXPRESS
17 # OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
18 # WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
19 # PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GRNET S.A OR
20 # CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
21 # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
22 # LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
23 # USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
24 # AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25 # LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
26 # ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
27 # POSSIBILITY OF SUCH DAMAGE.
29 # The views and conclusions contained in the software and
30 # documentation are those of the authors and should not be
31 # interpreted as representing official policies, either expressed
32 # or implied, of GRNET S.A.
34 from sqlalchemy.sql import select, literal
35 from sqlalchemy.sql.expression import join, union
37 from xfeatures import XFeatures
38 from groups import Groups
39 from public import Public
46 class Permissions(XFeatures, Groups, Public):
48 def __init__(self, **params):
49 XFeatures.__init__(self, **params)
50 Groups.__init__(self, **params)
51 Public.__init__(self, **params)
53 def access_grant(self, path, access, members=()):
54 """Grant members with access to path.
55 Members can also be '*' (all),
56 or some group specified as 'owner:group'."""
60 feature = self.xfeature_create(path)
61 self.feature_setmany(feature, access, members)
63 def access_set(self, path, permissions):
64 """Set permissions for path. The permissions dict
65 maps 'read', 'write' keys to member lists."""
67 r = permissions.get('read', [])
68 w = permissions.get('write', [])
70 self.xfeature_destroy(path)
72 feature = self.xfeature_create(path)
73 self.feature_clear(feature, READ)
74 self.feature_clear(feature, WRITE)
76 self.feature_setmany(feature, READ, r)
78 self.feature_setmany(feature, WRITE, w)
80 def access_get(self, path):
81 """Get permissions for path."""
83 feature = self.xfeature_get(path)
86 permissions = self.feature_dict(feature)
87 if READ in permissions:
88 permissions['read'] = permissions[READ]
89 del(permissions[READ])
90 if WRITE in permissions:
91 permissions['write'] = permissions[WRITE]
92 del(permissions[WRITE])
95 def access_members(self, path):
96 feature = self.xfeature_get(path)
99 permissions = self.feature_dict(feature)
101 members.update(permissions.get(READ, []))
102 members.update(permissions.get(WRITE, []))
103 for m in set(members):
104 parts = m.split(':', 1)
109 members.update(self.group_members(user, group))
112 def access_clear(self, path):
113 """Revoke access to path (both permissions and public)."""
115 self.xfeature_destroy(path)
116 self.public_unset(path)
118 def access_clear_bulk(self, paths):
119 """Revoke access to path (both permissions and public)."""
121 self.xfeature_destroy_bulk(paths)
122 self.public_unset_bulk(paths)
124 def access_check(self, path, access, member):
125 """Return true if the member has this access to the path."""
127 feature = self.xfeature_get(path)
130 members = self.feature_get(feature, access)
131 if member in members or '*' in members:
133 for owner, group in self.group_parents(member):
134 if owner + ':' + group in members:
138 def access_inherit(self, path):
139 """Return the paths influencing the access for path."""
141 # r = self.xfeature_inherit(path)
145 # return [x[0] for x in r if x[0] in valid]
147 # Only keep path components.
148 parts = path.rstrip('/').split('/')
150 for i in range(1, len(parts)):
151 subp = '/'.join(parts[:i + 1])
154 valid.append(subp + '/')
155 return [x for x in valid if self.xfeature_get(x)]
157 def access_list_paths(self, member, prefix=None):
158 """Return the list of paths granted to member."""
160 xfeatures_xfeaturevals = self.xfeatures.join(self.xfeaturevals)
162 selectable = (self.groups.c.owner + ':' + self.groups.c.name)
163 member_groups = select([selectable.label('value')],
164 self.groups.c.member == member)
166 members = select([literal(member).label('value')])
167 any = select([literal('*').label('value')])
169 u = union(member_groups, members, any).alias()
170 inner_join = join(xfeatures_xfeaturevals, u,
171 self.xfeaturevals.c.value == u.c.value)
172 s = select([self.xfeatures.c.path], from_obj=[inner_join]).distinct()
174 s = s.where(self.xfeatures.c.path.like(
175 self.escape_like(prefix) + '%', escape='\\'))
176 r = self.conn.execute(s)
177 l = [row[0] for row in r.fetchall()]
181 def access_list_shared(self, prefix=''):
182 """Return the list of shared paths."""
184 s = select([self.xfeatures.c.path],
185 self.xfeatures.c.path.like(self.escape_like(prefix) + '%', escape='\\')).order_by(self.xfeatures.c.path.asc())
186 r = self.conn.execute(s)
187 l = [row[0] for row in r.fetchall()]