Source code for pyplanet.apps.apps

import threading
import logging

from collections import OrderedDict

from pyplanet.utils.toposort import toposort
from pyplanet.apps.config import AppConfig, AppState
from pyplanet.core.exceptions import ImproperlyConfigured


[docs]class Apps: """ The apps class contains the context applications, loaded or not loaded in order of declaration or requirements if given by app configuration. The apps should contain a configuration class that could be loaded for reading out metadata, options and other useful information such as description, author, version and more. """ def __init__(self, instance): """ Initiate registry with pre-loaded apps. :param instance: Instance of the controller. :type instance: pyplanet.core.instance.Instance """ self.instance = instance self.apps = OrderedDict() self.unloaded_apps = OrderedDict() # Set ready states. self.apps_ready = self.ready = False # Set a lock for threading. self._lock = threading.Lock() # Listen to events self.instance.signals.listen('contrib.mode:script_mode_changed', self._on_mode_change)
[docs] def populate(self, apps, in_order=False): """ Loads application into the apps registry. Once you populate, the order isn't yet been decided. After all imports are done you should shuffle the apps list so it's in the right order of execution! :param apps: Apps list. :param in_order: Is the list already in order? :type apps: list """ if self.ready: return populated_apps = dict() dep_dict = dict() # Load modules. for entry in apps: app = AppConfig.import_app(entry, self.instance) # Check if the app is unique. if app.label in self.apps: raise ImproperlyConfigured('Application labels aren\'t unique! Duplicates: {}'.format(app.label)) # Inject apps instance into app itself. app.apps = self # Set state on app. app.state = AppState.UNLOADED # Get dependencies to other apps. deps = getattr(app, 'app_dependencies', list()) if not type(deps) is list: deps = list() # Add to the list so it can get ordered by dependencies. (not if in_order is true). if in_order: self.apps[app.label] = app else: populated_apps[app.label] = app # Add nodes of dependencies. dep_dict[app.label] = deps if in_order: return # Determinate order. order = toposort(dep_dict) # Add in order for label in order: try: self.apps[label] = populated_apps[label] except KeyError: if label.startswith('core.'): pass else: raise Exception('One of the apps depends on a non existing app: {}'.format(label))
[docs] async def check(self, on_start=False): """ Check and remove unsupported apps based on the current game and script mode. Also loads unloaded apps and try if the mode and game does support it again. """ # Check if disabled apps can be loaded again. for app_label, app_module in list(self.unloaded_apps.items()): try: # Load the module and initiate by creating the app class instance. self.populate([app_module], in_order=True) if app_label not in self.apps: raise Exception() # Flow control, stop executing restart of app. # Init + start the app again. await self.apps[app_label].on_init() await self.apps[app_label].on_start() # Clear the label from the unloaded list. del self.unloaded_apps[app_label] logging.info('(Re)loaded app {} as it seems that it supports this game/mode again.'.format(app_label)) except Exception as e: logging.debug('Can\'t start app {}, Got exception with error: {}'.format(app_label, str(e))) # logging.exception(e) # Some apps can't be reloaded. pass # Check enabled apps, and replace the apps dictionary with the up-to-date apps. script_name = await self.instance.mode_manager.get_current_script(refresh=True) apps_dict = OrderedDict() for label, app in self.apps.items(): if not app.is_game_supported(self.instance.game.game_full): logging.warning('Unloading app {}. Doesn\'t support the current game \'{}\'!'.format( label, self.instance.game.game_full )) if not on_start: await app.on_stop() await app.on_destroy() self.unloaded_apps[label] = app.module.__name__ del app elif not app.is_mode_supported(script_name): logging.warning('Unloading app {}. Doesn\'t support the current script mode!'.format(label)) if not on_start: await app.on_stop() await app.on_destroy() self.unloaded_apps[label] = app.module.__name__ del app else: apps_dict[label] = app self.apps = apps_dict
[docs] async def discover(self): """ The discover function will discover all models, signals and more from apps in the right order. """ for label, app in self.apps.items(): # Discover models. self.instance.db.registry.init_app(app) # Discover signals. self.instance.signals.init_app(app) # Finishing signal manager. self.instance.signals.finish_reservations()
[docs] async def init(self): """ This method will initiate all apps in order and in series. """ if self.apps_ready: raise Exception('Apps are not yet ordered!') for label, app in self.apps.items(): await app.on_init()
[docs] async def start(self): """ This method will start all apps that are previously initiated. """ if self.apps_ready: raise Exception('Apps are not yet ordered!') # The apps are in order, lets loop over them. for label, app in self.apps.items(): await app.on_start() app.state = AppState.LOADED logging.debug('App is ready: {}'.format(label)) logging.info('Apps successfully started!')
[docs] async def stop(self): """ This method is executed when the instance is shutting down (will stop all the apps). """ for label, app in reversed(self.apps.items()): if app.state == AppState.LOADED: await app.on_stop() logging.debug('Stopped app {}'.format(label)) logging.info('Apps successfully stopped!')
async def _on_mode_change(self, unloaded_script, loaded_script, **kwargs): await self.check()