1. Olemis Lang
  2. bloodhound-dashboard


bloodhound-dashboard / bhdashboard / web_ui.py

#!/usr/bin/env python
# -*- coding: UTF-8 -*-

#  Licensed to the Apache Software Foundation (ASF) under one
#  or more contributor license agreements.  See the NOTICE file
#  distributed with this work for additional information
#  regarding copyright ownership.  The ASF licenses this file
#  to you under the Apache License, Version 2.0 (the
#  "License"); you may not use this file except in compliance
#  with the License.  You may obtain a copy of the License at
#   http://www.apache.org/licenses/LICENSE-2.0
#  Unless required by applicable law or agreed to in writing,
#  software distributed under the License is distributed on an
#  KIND, either express or implied.  See the License for the
#  specific language governing permissions and limitations
#  under the License.

r"""Project dashboard for Apache(TM) Bloodhound

Implementing dashboard user interface.

import pkg_resources
import re

from genshi.builder import tag
from trac.core import Component, implements
from trac.config import Option
from trac.mimeview.api import Context
from trac.util.translation import _
from trac.web.api import IRequestHandler
from trac.web.chrome import Chrome, INavigationContributor, \
                            ITemplateProvider, add_stylesheet

class DashboardModule(Component):
    implements(IRequestHandler, INavigationContributor, ITemplateProvider)

    mainnav_label = Option('dashboard', 'mainnav', 'Dashboard', \
                            """Dashboard label in mainnav""")

    # IRequestHandler methods
    def match_request(self, req):
        """Match dashboard prefix"""
        return bool(re.match(r'^/dashboard(/.)?', req.path_info))

    def process_request(self, req):
        """Initially this will render static widgets. With time it will be 
        more and more dynamic and flexible.
        #add_stylesheet(req, 'dashboard/reset-fonts-grids.css')
        add_stylesheet(req, 'dashboard/grids.css')
        add_stylesheet(req, 'dashboard/skin.css')
        return 'bhdb_one_col.html', \
                    'widgets' : self.expand_widget_data(req), 
                    'title' : _('Dashboard')
                }, \

    # INavigationContributor methods
    def get_active_navigation_item(self, req):
        """Highlight dashboard mainnav item.
        return 'dashboard'

    def get_navigation_items(self, req):
        """Add an item in mainnav to access global dashboard
        if 'DASHBOARD_VIEW' in req.perm:
            yield ('mainnav', 'dashboard', 
                    tag.a(_(self.mainnav_label), href=req.href.dashboard()))

    # ITemplateProvider methods
    def get_htdocs_dirs(self):
        """List `htdocs` dirs for dashboard and widgets.
        resource_filename = pkg_resources.resource_filename
        return [
                 ('dashboard', resource_filename('bhdashboard', 'htdocs')),
                 #('widgets', resource_filename('bhdashboard.widgets', 'htdocs'))

    def get_templates_dirs(self):
        """List `templates` folders for dashboard and widgets.
        resource_filename = pkg_resources.resource_filename
        return [resource_filename('bhdashboard', 'templates'),
                resource_filename('bhdashboard.widgets', 'templates')]

    # Public API
    def expand_widget_data(self, req):
        """Expand raw widget data and format it for use in template

        Notes: So far it only renders a single report widget and there's no
        chance to customize this at all.
        # TODO: Implement dynamic dashboard specification
        from bhdashboard.widgets.report import TicketReportWidget
        w = TicketReportWidget(self.env)
        ctx = Context.from_request(req)
        args = ('TicketReport', ctx, {'args' : {'id' : 7, 'limit' : 10}})
        chrome = Chrome(self.env)
        template, data, _ = w.render_widget(*args)
        render = chrome.render_template
        return [{'title' : data['title'], 
                'content' : render(req, template, data['data'], fragment=True)}]