Skip to content

modelsim71/PlugSy

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

86 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PlugSy is a cross-platform threaded plugin framework and SDK for Python. With PlugSy, each plugin runs in a separate thread and has a handle to the global PlugSy plugin management object, allowing plugins to communicate and interact with each other. Whilst there are numerous existing Python Plugin frameworks, it's this built-in support for threading that makes PlugSy slightly different.

Documentation Status

Links

Project Goal

The goal of this project is to aid with the rapid development of Python applications of varying size and complexity. PlugSy tries to make it easy for developers to create small modular components (plugins) that interact and combine to form the basis of a complete software piece. By keeping extensibility and modularity in mind, PlugSy allows you to move from a basic single-plugin application, to a large application with a multitude of complex plugins, at your own pace.

Features

  • Separation of plugins into core and addon packages
  • Cross-platform support
  • Pure-python, no dependencies required
  • Built-in logging support for the PlugSy manager and each individual plugin
  • SDK GUI for quickly creating and deleting plugins

Roadmap

  • PyInstaller integration and executable production
    • Combining PlugSy and any developed plugins into a PyInstaller executable via SDK and SDK GUI
    • Option to add a Windows service wrapper
  • Further support for additional Python versions

Similar Projects

Example Usage

PlugSy

Initiating PlugSy :

from plugsy import Plugsy

plugsy = Plugsy()

Activating all existing plugins :

plugsy.activate_plugins()

Activating specific plugins :

plugsy.activate_plugins(["MainPlugin", "FirstPlugin", "FifthPlugin"])

Deactivating all plugins :

plugsy.deactivate_plugins()

Deactivating specific plugins :

plugsy.deactivate_plugins(["MainPlugin", "FirstPlugin", "FifthPlugin"])

Interacting with plugin objects :

main_plugin = plugsy.get_plugin("MainPlugin")
main_plugin.do_something()
main_plugin.do_something_else()

first_plugin = plugsy.get_plugin("FirstPlugin")
first_plugin.take_an_action("some_action")
some_data = first_plugin.get_some_data()

SDK

Initiating the SDK :

from plugsy.sdk.Sdk import Sdk

# Pass in path to directory containing plugins (or path to an empty dir)
sdk = Sdk(plugins_home_path=".\\plugins")

Creating a new plugin :

# Pass in the plugin type (core or addon) and plugin name
sdk.create_plugin(plugin_type="core", name="MyNewPlugin")

Deleting a plugin :

sdk.delete_plugin(name="MyNewPlugin")

Installation

Installation of PlugSy is simple using Pip: :

pip install plugsy

Dependencies

*wxPython is only required if you're running Windows and want to use the SDK GUI

About

Threaded Python Plugin Framework

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%