/usr/lib/python2.7/dist-packages/jumble/IPlugin.py is in variety 0.6.0-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 | # -*- Mode: Python; coding: utf-8; indent-tabs-mode: nil; tab-width: 4 -*-
### BEGIN LICENSE
# Copyright (c) 2012, Peter Levi <peterlevi@peterlevi.com>
# This program is free software: you can redistribute it and/or modify it
# under the terms of the GNU General Public License version 3, as published
# by the Free Software Foundation.
#
# This program is distributed in the hope that it will be useful, but
# WITHOUT ANY WARRANTY; without even the implied warranties of
# MERCHANTABILITY, SATISFACTORY QUALITY, or FITNESS FOR A PARTICULAR
# PURPOSE. See the GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License along
# with this program. If not, see <http://www.gnu.org/licenses/>.
### END LICENSE
class IPlugin(object):
"""
The most simple interface to be inherited when creating a plugin.
"""
@classmethod
def get_info(cls):
"""
Returns the basic info about the plugin. Please make sure the name is unique among all Variety plugins
Format:
return {
"name": "Sample name",
"description": "Sample description",
"version": "1.0",
"author": "Author name", # optional
"url": "Plugin URL" # optional
}
"""
return {}
def __init__(self):
"""
All plugins must have a default constructor with no parameters.
Remember to call super.
"""
self.active = False
# These will be filled in by Jumble.load() and available before the first activate() call
self.jumble = None
self.path = None # Path to the plugin python file
self.folder = None # Folder where plugin is located (can be used for loading UI resources, etc.).
# This folder may be read-only. A separate config folder convention should be used to store config files.
def activate(self):
"""
Called at plugin activation. Please do not allocate large portions of memory or resources before this is called.
Remember to call super first.
This method can be called multiple times within a session.
It may be called when the plugin is already active - in this case it should simply return.
"""
if self.active:
return
self.active = True
def deactivate(self):
"""
Called when the plugin is disabled. Please free used memory and resources here.
Remember to call super first.
This method can be called multiple times within a session.
It may be called when the plugin is already inactive - in this case it should simply return.
"""
self.active = False
def is_active(self):
return self.active
|