# Copyright (c) 2013 Mirantis Inc. # # Licensed 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 "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or # implied. # See the License for the specific language governing permissions and # limitations under the License. import operator import os import re import time import flask from flask.ext import gravatar as gravatar_ext import itertools from oslo.config import cfg import six from dashboard import decorators from dashboard import helpers from dashboard import kpi from dashboard import parameters from dashboard import reports from dashboard import vault from stackalytics.openstack.common import log as logging from stackalytics.processor import config from stackalytics.processor import utils # Application objects --------- app = flask.Flask(__name__) app.config.from_object(__name__) app.config.from_envvar('DASHBOARD_CONF', silent=True) app.register_blueprint(reports.blueprint) app.register_blueprint(kpi.blueprint) LOG = logging.getLogger(__name__) conf = cfg.CONF conf.register_opts(config.OPTS) logging.setup('dashboard') LOG.info('Logging enabled') conf_file = os.getenv('STACKALYTICS_CONF') if conf_file and os.path.isfile(conf_file): conf(default_config_files=[conf_file]) app.config['DEBUG'] = cfg.CONF.debug else: LOG.info('Conf file is empty or not exist') # Handlers --------- @app.route('/') @decorators.templated() def overview(): pass @app.route('/widget') def widget(): return flask.render_template('widget.html') @app.errorhandler(404) @decorators.templated('404.html', 404) def page_not_found(e): pass # AJAX Handlers --------- def _get_aggregated_stats(records, metric_filter, keys, param_id, param_title=None, finalize_handler=None): param_title = param_title or param_id result = dict((c, {'metric': 0, 'id': c}) for c in keys) for record in records: metric_filter(result, record, param_id) result[record[param_id]]['name'] = record[param_title] response = [r for r in result.values() if r['metric']] response.sort(key=lambda x: x['metric'], reverse=True) response = [item for item in map(finalize_handler, response) if item] utils.add_index(response, item_filter=lambda x: x['id'] != '*independent') return response @app.route('/api/1.0/stats/companies') @decorators.jsonify('stats') @decorators.exception_handler() @decorators.record_filter() @decorators.aggregate_filter() def get_companies(records, metric_filter, finalize_handler): return _get_aggregated_stats(records, metric_filter, vault.get_memory_storage().get_companies(), 'company_name') @app.route('/api/1.0/stats/modules') @decorators.jsonify('stats') @decorators.exception_handler() @decorators.record_filter() @decorators.aggregate_filter() def get_modules(records, metric_filter, finalize_handler): return _get_aggregated_stats(records, metric_filter, vault.get_memory_storage().get_modules(), 'module') def is_engineer_core_in_modules(user, modules): is_core = False for (module, branch) in user['core']: if module in modules: is_core = branch if branch == 'master': # we need master, but stables are ok break return is_core @app.route('/api/1.0/stats/engineers') @decorators.jsonify('stats') @decorators.exception_handler() @decorators.record_filter() @decorators.aggregate_filter() def get_engineers(records, metric_filter, finalize_handler): modules_names = parameters.get_parameter({}, 'module', 'modules') modules = vault.resolve_modules(modules_names) def postprocessing(record): if finalize_handler: record = finalize_handler(record) user = vault.get_user_from_runtime_storage(record['id']) record['core'] = is_engineer_core_in_modules(user, modules) return record return _get_aggregated_stats(records, metric_filter, vault.get_memory_storage().get_user_ids(), 'user_id', 'author_name', finalize_handler=postprocessing) @app.route('/api/1.0/stats/engineers_extended') @decorators.jsonify('stats') @decorators.exception_handler() @decorators.record_filter(ignore='metric') def get_engineers_extended(records): modules_names = parameters.get_parameter({}, 'module', 'modules') modules = vault.resolve_modules(modules_names) def postprocessing(record): record = decorators.mark_finalize(record) if not (record['mark'] or record['review'] or record['commit'] or record['email'] or record['patch_count']): return user = vault.get_user_from_runtime_storage(record['id']) record['company'] = user['companies'][-1]['company_name'] record['core'] = is_engineer_core_in_modules(user, modules) return record def record_processing(result, record, param_id): result_row = result[record[param_id]] record_type = record['record_type'] result_row[record_type] = result_row.get(record_type, 0) + 1 if record_type == 'mark': decorators.mark_filter(result, record, param_id) if record_type == 'review': result_row['patch_count'] = (result_row.get('patch_count', 0) + record['patch_count']) result = dict((user_id, {'id': user_id, 'mark': 0, 'review': 0, 'commit': 0, 'email': 0, 'patch_count': 0, 'metric': 0}) for user_id in vault.get_memory_storage().get_user_ids()) for record in records: record_processing(result, record, 'user_id') result[record['user_id']]['name'] = record['author_name'] response = result.values() response.sort(key=lambda x: x['mark'], reverse=True) response = [item for item in map(postprocessing, response) if item] utils.add_index(response) return response @app.route('/api/1.0/stats/distinct_engineers') @decorators.jsonify('stats') @decorators.exception_handler() @decorators.record_filter() def get_distinct_engineers(records): result = {} for record in records: result[record['user_id']] = { 'author_name': record['author_name'], 'author_email': record['author_email'], } return result @app.route('/api/1.0/activity') @decorators.jsonify('activity') @decorators.exception_handler() @decorators.record_filter() def get_activity_json(records): start_record = int(flask.request.args.get('start_record') or 0) page_size = int(flask.request.args.get('page_size') or parameters.DEFAULT_RECORDS_LIMIT) return helpers.get_activity(records, start_record, page_size) @app.route('/api/1.0/contribution') @decorators.jsonify('contribution') @decorators.exception_handler() @decorators.record_filter(ignore='metric') def get_contribution_json(records): return helpers.get_contribution_summary(records) @app.route('/api/1.0/companies') @decorators.jsonify('companies') @decorators.exception_handler() @decorators.record_filter(ignore='company') def get_companies_json(records): query = flask.request.args.get('company_name') or '' options = set() for record in records: name = record['company_name'] if name in options: continue if name.lower().find(query.lower()) >= 0: options.add(name) result = [{'id': utils.safe_encode(c.lower()), 'text': c} for c in sorted(options)] return result @app.route('/api/1.0/modules') @decorators.jsonify('modules') @decorators.exception_handler() @decorators.record_filter(ignore='module') def get_modules_json(records): module_group_index = vault.get_vault()['module_group_index'] module_id_index = vault.get_vault()['module_id_index'] tags = parameters.get_parameter({}, 'tag', 'tags') # all modules mentioned in records module_ids = set(record['module'] for record in records) # plus all module groups that hold these modules module_ids |= set(itertools.chain.from_iterable( module_group_index.get(module, []) for module in module_ids)) # keep only modules with specified tags if tags: module_ids = set(module_id for module_id in module_ids if module_id_index[module_id].get('tag') in tags) # keep only modules that are in project type completely pts = parameters.get_parameter({}, 'project_type', 'project_types') if pts: m = set(vault.resolve_project_types(pts)) module_ids = set(module_id for module_id in module_ids if module_id_index[module_id]['modules'] <= m) query = (flask.request.args.get('query') or '').lower() matched = [] for module_id in module_ids: if module_id.find(query) >= 0: module = dict([(k, v) for k, v in six.iteritems(module_id_index[module_id]) if k not in ['modules']]) matched.append(module) return sorted(matched, key=operator.itemgetter('text')) @app.route('/api/1.0/companies/') @decorators.jsonify('company') def get_company(company_name): memory_storage_inst = vault.get_memory_storage() for company in memory_storage_inst.get_companies(): if company.lower() == company_name.lower(): return { 'id': company_name, 'text': memory_storage_inst.get_original_company_name( company_name) } flask.abort(404) @app.route('/api/1.0/modules/') @decorators.jsonify('module') def get_module(module): module_id_index = vault.get_vault()['module_id_index'] module = module.lower() if module in module_id_index: return {'id': module_id_index[module]['id'], 'text': module_id_index[module]['text'], 'tag': module_id_index[module]['tag']} flask.abort(404) @app.route('/api/1.0/stats/bp') @decorators.jsonify('stats') @decorators.exception_handler() @decorators.record_filter() def get_bpd(records): result = [] for record in records: if record['record_type'] in ['bpd', 'bpc']: mention_date = record.get('mention_date') if mention_date: date = helpers.format_date(mention_date) else: date = 'never' result.append({ 'date': date, 'status': record['lifecycle_status'], 'metric': record.get('mention_count') or 0, 'id': record['name'], 'name': record['name'], 'link': helpers.make_blueprint_link(record['module'], record['name']) }) result.sort(key=lambda x: x['metric'], reverse=True) utils.add_index(result) return result @app.route('/api/1.0/users') @decorators.jsonify('users') @decorators.exception_handler() @decorators.record_filter(ignore='user_id') def get_users_json(records): user_name_query = flask.request.args.get('user_name') or '' user_ids = set() result = [] for record in records: user_id = record['user_id'] if user_id in user_ids: continue user_name = record['author_name'] if user_name.lower().find(user_name_query.lower()) >= 0: user_ids.add(user_id) result.append({'id': user_id, 'text': user_name}) result.sort(key=lambda x: x['text']) return result @app.route('/api/1.0/users/') @decorators.jsonify('user') def get_user(user_id): user = vault.get_user_from_runtime_storage(user_id) if not user: flask.abort(404) user = helpers.extend_user(user) return user @app.route('/api/1.0/releases') @decorators.jsonify('releases') @decorators.exception_handler() def get_releases_json(): query = (flask.request.args.get('query') or '').lower() return [{'id': r['release_name'], 'text': r['release_name'].capitalize()} for r in vault.get_release_options() if r['release_name'].find(query) >= 0] @app.route('/api/1.0/releases/') @decorators.jsonify('release') def get_release_json(release): if release != 'all': if release not in vault.get_vault()['releases']: release = parameters.get_default('release') return {'id': release, 'text': release.capitalize()} @app.route('/api/1.0/metrics') @decorators.jsonify('metrics') @decorators.exception_handler() def get_metrics_json(): query = (flask.request.args.get('query') or '').lower() return sorted([{'id': m, 'text': t} for m, t in six.iteritems(parameters.METRIC_LABELS) if t.lower().find(query) >= 0], key=operator.itemgetter('text')) @app.route('/api/1.0/metrics/') @decorators.jsonify('metric') @decorators.exception_handler() def get_metric_json(metric): if metric not in parameters.METRIC_LABELS: metric = parameters.get_default('metric') return {'id': metric, 'text': parameters.METRIC_LABELS[metric]} @app.route('/api/1.0/project_types') @decorators.jsonify('project_types') @decorators.exception_handler() def get_project_types_json(): return [{'id': pt['id'], 'text': pt['title'], 'items': pt.get('items', [])} for pt in vault.get_project_types()] @app.route('/api/1.0/project_types/') @decorators.jsonify('project_type') @decorators.exception_handler() def get_project_type_json(project_type): if not vault.is_project_type_valid(project_type): project_type = parameters.get_default('project_type') pt = vault.get_project_type(project_type) return {'id': pt['id'], 'text': pt['title']} def _get_date(kwargs, param_name): date_param = parameters.get_single_parameter(kwargs, param_name) if date_param: ts = utils.date_to_timestamp_ext(date_param) else: ts = vault.get_vault()[param_name] return utils.timestamp_to_week(ts) @app.route('/api/1.0/stats/timeline') @decorators.jsonify('timeline') @decorators.exception_handler() @decorators.record_filter(ignore='release') def timeline(records, **kwargs): # find start and end dates release_name = parameters.get_single_parameter(kwargs, 'release') or 'all' releases = vault.get_vault()['releases'] if 'all' in release_name: start_date = release_start_date = _get_date(kwargs, 'start_date') end_date = release_end_date = _get_date(kwargs, 'end_date') else: release = releases[release_name] start_date = release_start_date = utils.timestamp_to_week( release['start_date']) end_date = release_end_date = utils.timestamp_to_week( release['end_date']) now = utils.timestamp_to_week(int(time.time())) + 1 # expand start-end to year if needed if release_end_date - release_start_date < 52: expansion = (52 - (release_end_date - release_start_date)) // 2 if release_end_date + expansion < now: end_date += expansion else: end_date = now start_date = end_date - 52 # empty stats for all weeks in range weeks = range(start_date, end_date) week_stat_loc = dict((c, 0) for c in weeks) week_stat_commits = dict((c, 0) for c in weeks) week_stat_commits_hl = dict((c, 0) for c in weeks) param = parameters.get_parameter(kwargs, 'metric') if ('commits' in param) or ('loc' in param): handler = lambda record: record['loc'] else: handler = lambda record: 0 # fill stats with the data for record in records: week = record['week'] if week in weeks: week_stat_loc[week] += handler(record) week_stat_commits[week] += 1 if 'all' == release_name or record['release'] == release_name: week_stat_commits_hl[week] += 1 # form arrays in format acceptable to timeline plugin array_loc = [] array_commits = [] array_commits_hl = [] for week in weeks: week_str = utils.week_to_date(week) array_loc.append([week_str, week_stat_loc[week]]) array_commits.append([week_str, week_stat_commits[week]]) array_commits_hl.append([week_str, week_stat_commits_hl[week]]) return [array_commits, array_commits_hl, array_loc] gravatar = gravatar_ext.Gravatar(app, size=64, rating='g', default='wavatar') @app.template_filter('make_url') def to_url_params(dict_params, base_url): return base_url + '?' + '&'.join( ['%s=%s' % (k, v) for k, v in six.iteritems(dict_params)]) @app.template_filter('remove_ctrl_chars') def remove_ctrl_chars(text): return re.sub(r'[\W]', '_', text) def main(): app.run(cfg.CONF.listen_host, cfg.CONF.listen_port) if __name__ == '__main__': main()