Skip to main content

Launchpad represents a small factory and a distinct abstract for defining actionable items

Project description


Launchpad represents a small factory and a distinct abstract for defining actionable items. This is particularly useful when creating libraries of tools or processes which need to be exposed and invokable.

Each action contains general details such as name, description etc as well as some richer functionality to invoke the action or for the action to expose further sub-actions or properties.

As the LaunchPad class is just a factory its population is dynamic based upon the paths your feed it (or expose through the LAUNCHPAD_PLUGIN_PATHS variable).

An example of use might be...

import launchpad

# -- Instance launchpad, this gives access to all the
# -- actions
lp = launchpad.LaunchPad('/usr/my_actions')

# -- We can cycle over all the actions
for action in lp.identifiers():

    # -- We can get an action and run it

# -- We can access actions direclty too
action = lp.request('My Action Name')


If you use pip, you can simply run pip install launchpad. That will pull down the required dependencies (scribble & factories) automatically.

Note: If you install launchpanel this module will be pulled down automatically as a dependency. Therefore you only need to pull down this module explicitly if you do not plan to utilise the launchpanel ui.

The Abstract

To define an action you must implement a Launch Action. The process of implementing an action is just a case of creating a python file and inheriting from the LaunchAction object, like this:

import launchpad

# ------------------------------------------------------------------------------
class MyAction(launchpad):
    Name = ''
    Description = __doc__
    Icon = ''
    Groups = []

    def run(cls):

    def actions(cls):
        return dict()

    def properties(cls):
        return dict()

    def viability(cls):
        return cls.VALID

The properties are very much about giving descriptive information about your action. Description, Icon and Groups are all optional and can be left out entirely if desired - but Name must always be filled in.

run() is where you perform the default action for this action.

actions() allows you to return a dictionary of key value pairs where the key is the action label and the value is the function/callable. This allows you to give your action variations or extended behaviour which is accessible in a consistent way.

viability() is the mechanism to give an indiciation as to whether your action is valid within the current environment. For example, if your action relies on paths existing, or environment variables being set, you can run those tests there are return the Action Viability (VALID, INVALID, DISABLED).

properties() is a mechanism for storing blind data. It should always return a dictionary but there is not formal structure for that dictionary. This is implemented to give you the oppotunity to store tool specific data within the action depending upon your needs.

Credits & Collaboration

This module was inspired by some excellent collaborative projects with a fantastic tech-artist called Toby Harrison-Banfield.

I am always open to collaboration, so if you spot bugs lets me know, or if you would like to contribute or get involved just shout!


Launchpad has been tested under Python 2.7 and Python 3.7 on Windows and Ubuntu.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

launchpad-1.1.0.tar.gz (4.7 kB view hashes)

Uploaded source

Built Distribution

launchpad-1.1.0-py3-none-any.whl (6.6 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page