Warning

This document is for an in-development version of Galaxy. You can alternatively view this page in the latest release if it exists or view the top of the latest release's documentation.

Source code for galaxy.tours

"""
This module manages loading/etc of Galaxy interactive tours.
"""
import logging
import os

import yaml

from galaxy import util

log = logging.getLogger(__name__)


[docs]def tour_loader(contents_dict): # Some of this can be done on the clientside. Maybe even should? title_default = contents_dict.get('title_default', None) for step in contents_dict['steps']: if 'intro' in step: step['content'] = step.pop('intro') if 'position' in step: step['placement'] = step.pop('position') if 'element' not in step: step['orphan'] = True if title_default and 'title' not in step: step['title'] = title_default return contents_dict
[docs]class ToursRegistry:
[docs] def __init__(self, tour_directories): self.tour_directories = util.config_directories_from_setting(tour_directories) self.load_tours()
[docs] def tours_by_id_with_description(self): return [{'id': k, 'description': self.tours[k].get('description', None), 'name': self.tours[k].get('name', None), 'tags': self.tours[k].get('tags', None)} for k in self.tours.keys()]
[docs] def load_tour(self, tour_id): for tour_dir in self.tour_directories: tour_path = os.path.join(tour_dir, tour_id + ".yaml") if not os.path.exists(tour_path): tour_path = os.path.join(tour_dir, tour_id + ".yml") if os.path.exists(tour_path): return self._load_tour_from_path(tour_path)
[docs] def load_tours(self): self.tours = {} for tour_dir in self.tour_directories: for filename in os.listdir(tour_dir): if self._is_yaml(filename): self._load_tour_from_path(os.path.join(tour_dir, filename)) return self.tours_by_id_with_description()
[docs] def reload_tour(self, path): # We may safely assume that the path is within the tour directory filename = os.path.basename(path) if self._is_yaml(filename): self._load_tour_from_path(path)
[docs] def tour_contents(self, tour_id): # Extra format translation could happen here (like the previous intro_to_tour) # For now just return the loaded contents. return self.tours.get(tour_id, None)
def _is_yaml(self, filename): return filename.endswith('.yaml') or filename.endswith('.yml') def _load_tour_from_path(self, tour_path): filename = os.path.basename(tour_path) tour_id = os.path.splitext(filename)[0] try: with open(tour_path) as handle: conf = yaml.safe_load(handle) tour = tour_loader(conf) self.tours[tour_id] = tour_loader(conf) log.info("Loaded tour '%s'" % tour_id) return tour except OSError: log.exception("Tour '%s' could not be loaded, error reading file.", tour_id) except yaml.error.YAMLError: log.exception("Tour '%s' could not be loaded, error within file. Please check your yaml syntax.", tour_id) except TypeError: log.exception("Tour '%s' could not be loaded, error within file. Possibly spacing related. Please check your yaml syntax.", tour_id) return None