371 lines
12 KiB
Python
371 lines
12 KiB
Python
from __future__ import unicode_literals
|
|
|
|
import inspect
|
|
import logging
|
|
import urllib
|
|
import urlparse
|
|
|
|
from django.apps import apps
|
|
from django.conf import settings
|
|
from django.core.exceptions import PermissionDenied
|
|
from django.core.urlresolvers import resolve, reverse
|
|
from django.template import VariableDoesNotExist, Variable
|
|
from django.template.defaulttags import URLNode
|
|
from django.utils.encoding import smart_str, smart_unicode
|
|
from django.utils.http import urlencode, urlquote
|
|
|
|
from common.utils import return_attrib
|
|
from permissions import Permission
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
|
|
class ResolvedLink(object):
|
|
def __init__(self, link, current_view):
|
|
self.current_view = current_view
|
|
self.disabled = False
|
|
self.link = link
|
|
self.url = '#'
|
|
|
|
@property
|
|
def active(self):
|
|
return self.link.view == self.current_view
|
|
|
|
@property
|
|
def description(self):
|
|
return self.link.description
|
|
|
|
@property
|
|
def icon(self):
|
|
return self.link.icon
|
|
|
|
@property
|
|
def tags(self):
|
|
return self.link.tags
|
|
|
|
@property
|
|
def text(self):
|
|
return self.link.text
|
|
|
|
|
|
class Menu(object):
|
|
_registry = {}
|
|
|
|
@classmethod
|
|
def get(cls, name):
|
|
return cls._registry[name]
|
|
|
|
def __init__(self, name):
|
|
if name in self.__class__._registry:
|
|
raise Exception('A menu with this name already exists')
|
|
|
|
self.name = name
|
|
self.bound_links = {}
|
|
self.unbound_links = {}
|
|
self.link_positions = {}
|
|
self.__class__._registry[name] = self
|
|
|
|
def _map_links_to_source(self, links, source, map_variable='bound_links', position=None):
|
|
source_links = getattr(self, map_variable).setdefault(source, [])
|
|
|
|
for link in links:
|
|
source_links.append(link)
|
|
self.link_positions[link] = position
|
|
|
|
def bind_links(self, links, sources=None, position=None):
|
|
"""
|
|
Associate a link to a model, a view inside this menu
|
|
"""
|
|
|
|
try:
|
|
for source in sources:
|
|
self._map_links_to_source(
|
|
links=links, position=position, source=source
|
|
)
|
|
except TypeError:
|
|
# Unsourced links display always
|
|
self._map_links_to_source(
|
|
links=links, position=position, source=sources
|
|
)
|
|
|
|
def resolve(self, context, source=None):
|
|
try:
|
|
request = Variable('request').resolve(context)
|
|
except VariableDoesNotExist:
|
|
# There is no request variable, most probable a 500 in a test view
|
|
# Don't return any resolved links then.
|
|
logger.warning('No request variable, aborting menu resolution')
|
|
return ()
|
|
|
|
current_path = request.META['PATH_INFO']
|
|
|
|
# Get sources: view name, view objects
|
|
current_view = resolve(current_path).view_name
|
|
resolved_navigation_object_list = []
|
|
|
|
result = []
|
|
|
|
if source:
|
|
resolved_navigation_object_list = [source]
|
|
else:
|
|
navigation_object_list = context.get(
|
|
'navigation_object_list', ('object',)
|
|
)
|
|
|
|
# Multiple objects
|
|
for navigation_object in navigation_object_list:
|
|
try:
|
|
resolved_navigation_object_list.append(
|
|
Variable(navigation_object).resolve(context)
|
|
)
|
|
except VariableDoesNotExist:
|
|
pass
|
|
|
|
for resolved_navigation_object in resolved_navigation_object_list:
|
|
resolved_links = []
|
|
|
|
for bound_source, links in self.bound_links.iteritems():
|
|
try:
|
|
if inspect.isclass(bound_source) and type(resolved_navigation_object) == bound_source:
|
|
for link in links:
|
|
resolved_link = link.resolve(
|
|
context=context,
|
|
resolved_object=resolved_navigation_object
|
|
)
|
|
if resolved_link:
|
|
resolved_links.append(resolved_link)
|
|
# No need for further content object match testing
|
|
break
|
|
except TypeError:
|
|
# When source is a dictionary
|
|
pass
|
|
|
|
if resolved_links:
|
|
result.append(resolved_links)
|
|
|
|
resolved_links = []
|
|
# View links
|
|
for link in self.bound_links.get(current_view, []):
|
|
resolved_link = link.resolve(context)
|
|
if resolved_link:
|
|
resolved_links.append(resolved_link)
|
|
|
|
if resolved_links:
|
|
result.append(resolved_links)
|
|
|
|
resolved_links = []
|
|
|
|
# Main menu links
|
|
for link in self.bound_links.get(None, []):
|
|
resolved_link = link.resolve(context)
|
|
if resolved_link:
|
|
resolved_links.append(resolved_link)
|
|
|
|
if resolved_links:
|
|
result.append(resolved_links)
|
|
|
|
if result:
|
|
unbound_links = []
|
|
unbound_links.extend(self.unbound_links.get(source, ()))
|
|
unbound_links.extend(self.unbound_links.get(current_view, ()))
|
|
|
|
for resolved_link in result[0]:
|
|
if resolved_link.link in unbound_links:
|
|
result[0].remove(resolved_link)
|
|
|
|
# Sort links by position value passed during bind
|
|
result[0] = sorted(
|
|
result[0], key=lambda item: self.link_positions.get(item.link)
|
|
)
|
|
|
|
return result
|
|
|
|
def unbind_links(self, links, sources=None):
|
|
"""
|
|
Allow unbinding links from sources, used to allow 3rd party apps to
|
|
change the link binding of core apps
|
|
"""
|
|
|
|
try:
|
|
for source in sources:
|
|
self._map_links_to_source(
|
|
links=links, source=source, map_variable='unbound_links'
|
|
)
|
|
except TypeError:
|
|
# Unsourced links display always
|
|
self._map_links_to_source(
|
|
links=links, source=sources, map_variable='unbound_links'
|
|
)
|
|
|
|
|
|
class Link(object):
|
|
def __init__(self, text, view, args=None, condition=None,
|
|
conditional_disable=None, description=None, icon=None,
|
|
keep_query=False, kwargs=None, permissions=None,
|
|
remove_from_query=None, tags=None):
|
|
|
|
self.args = args or []
|
|
self.condition = condition
|
|
self.conditional_disable = conditional_disable
|
|
self.description = description
|
|
self.icon = icon
|
|
self.keep_query = keep_query
|
|
self.kwargs = kwargs or {}
|
|
self.permissions = permissions or []
|
|
self.remove_from_query = remove_from_query or []
|
|
self.tags = tags
|
|
self.text = text
|
|
self.view = view
|
|
|
|
def resolve(self, context, resolved_object=None):
|
|
AccessControlList = apps.get_model(
|
|
app_label='acls', model_name='AccessControlList'
|
|
)
|
|
|
|
request = Variable('request').resolve(context)
|
|
current_path = request.META['PATH_INFO']
|
|
current_view = resolve(current_path).view_name
|
|
|
|
# ACL is tested agains the resolved_object or just {{ object }} if not
|
|
if not resolved_object:
|
|
try:
|
|
resolved_object = Variable('object').resolve(context=context)
|
|
except VariableDoesNotExist:
|
|
pass
|
|
|
|
# If this link has a required permission check that the user have it
|
|
# too
|
|
if self.permissions:
|
|
try:
|
|
Permission.check_permissions(request.user, self.permissions)
|
|
except PermissionDenied:
|
|
# If the user doesn't have the permission, and we are passed
|
|
# an instance, check to see if the user has at least ACL
|
|
# access to the instance.
|
|
if resolved_object:
|
|
try:
|
|
AccessControlList.objects.check_access(
|
|
self.permissions, request.user, resolved_object
|
|
)
|
|
except PermissionDenied:
|
|
return None
|
|
else:
|
|
return None
|
|
|
|
# Check to see if link has conditional display function and only
|
|
# display it if the result of the conditional display function is
|
|
# True
|
|
if self.condition:
|
|
if not self.condition(context):
|
|
return None
|
|
|
|
resolved_link = ResolvedLink(current_view=current_view, link=self)
|
|
|
|
view_name = Variable('"{}"'.format(self.view))
|
|
if isinstance(self.args, list) or isinstance(self.args, tuple):
|
|
# TODO: Don't check for instance check for iterable in try/except
|
|
# block. This update required changing all 'args' argument in
|
|
# links.py files to be iterables and not just strings.
|
|
args = [Variable(arg) for arg in self.args]
|
|
else:
|
|
args = [Variable(self.args)]
|
|
|
|
# If we were passed an instance of the view context object we are
|
|
# resolving, inject it into the context. This help resolve links for
|
|
# object lists.
|
|
if resolved_object:
|
|
context['resolved_object'] = resolved_object
|
|
|
|
try:
|
|
kwargs = self.kwargs(context)
|
|
except TypeError:
|
|
# Is not a callable
|
|
kwargs = self.kwargs
|
|
|
|
kwargs = {key: Variable(value) for key, value in kwargs.iteritems()}
|
|
|
|
# Use Django's exact {% url %} code to resolve the link
|
|
node = URLNode(
|
|
view_name=view_name, args=args, kwargs=kwargs, asvar=None
|
|
)
|
|
|
|
try:
|
|
resolved_link.url = node.render(context)
|
|
except Exception as exception:
|
|
logger.error(
|
|
'Error resolving link "%s" URL; %s', self.text, exception
|
|
)
|
|
|
|
# This is for links that should be displayed but that are not clickable
|
|
if self.conditional_disable:
|
|
resolved_link.disabled = self.conditional_disable(context)
|
|
else:
|
|
resolved_link.disabled = False
|
|
|
|
# Lets a new link keep the same URL query string of the current URL
|
|
if self.keep_query:
|
|
# Sometimes we are required to remove a key from the URL QS
|
|
previous_path = smart_unicode(
|
|
urllib.unquote_plus(
|
|
smart_str(
|
|
request.get_full_path()
|
|
) or smart_str(
|
|
request.META.get(
|
|
'HTTP_REFERER',
|
|
reverse(settings.LOGIN_REDIRECT_URL)
|
|
)
|
|
)
|
|
)
|
|
)
|
|
query_string = urlparse.urlparse(previous_path).query
|
|
parsed_query_string = urlparse.parse_qs(query_string)
|
|
|
|
for key in self.remove_from_query:
|
|
try:
|
|
del parsed_query_string[key]
|
|
except KeyError:
|
|
pass
|
|
|
|
resolved_link.url = '%s?%s' % (
|
|
urlquote(resolved_link.url),
|
|
urlencode(parsed_query_string, doseq=True)
|
|
)
|
|
|
|
return resolved_link
|
|
|
|
|
|
class SourceColumn(object):
|
|
_registry = {}
|
|
|
|
@classmethod
|
|
def get_for_source(cls, source):
|
|
try:
|
|
return cls._registry[source]
|
|
except KeyError:
|
|
try:
|
|
return cls._registry[source.model]
|
|
except AttributeError:
|
|
try:
|
|
return cls._registry[source.__class__]
|
|
except KeyError:
|
|
return ()
|
|
except TypeError:
|
|
# unhashable type: list
|
|
return ()
|
|
|
|
def __init__(self, source, label, attribute=None, func=None):
|
|
self.source = source
|
|
self.label = label
|
|
self.attribute = attribute
|
|
self.func = func
|
|
self.__class__._registry.setdefault(source, [])
|
|
self.__class__._registry[source].append(self)
|
|
|
|
def resolve(self, context):
|
|
if self.attribute:
|
|
result = return_attrib(context['object'], self.attribute)
|
|
elif self.func:
|
|
result = self.func(context=context)
|
|
|
|
return result
|