Metadata-Version: 2.1
Name: SSPM
Version: 1.2.1
Summary: SSPM simple plugin manger based on YAPSY
Home-page: https://gitlab.com/stevencnix/sspm
Download-URL: https://gitlab.com/stevencnix/sspm/-/archive/v1.2.1/sspm-v1.2.1.tar.gz
Author: Steven Nix
Author-email: stevencnix@gmail.com
License: GNU LGPLv3
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.10
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE

# Super Simple Plugin Manager - SSPM

## About SSPM

Super Simple Plugin Manager - SSPM is a library I created based off of Thibauld Nion's YAPSY. 
I liked how configurable YAPSY is and the inclusion of a configuration file to allow the plugin creator to include
details about their plugin. Unfortunately, I found that YAPSY had a lot of functionality that I didn't need, it is
out of date, and contains a lot of deprecated code. To address these issues I created SSPM. SSPM does not have the 
customization that yapsy has. However, it allows for much quicker implementation that I believe most people will 
find useful. It is meant to be a very simple hands-off plugin manager.

## Installation

The easiest way to install is to use pip:
	
	pip install SSPM

or if you have cloned the repo:
	
	cd <path to repo>
	pip install .

	or
	
	cd <path to repo>
	python setup.py install
	

## Basic Usage

1. Initialize the plugin manager

	``` shell
	plugin_manager = PluginManager(plugin_folder=\<INSERT PLUGINS DIR PATH HERE\>)
	```
	
2. Import the plugins in the plugins directory

	``` shell
	plugin_manager.import_plugins()
	```
 
3. Get the imported plugin

	```shell
	plugin = sspm.get_active_plugin("Plugin name")
	```
 
    or

    ```shell
    plugins = sspm.active_plugins
    ```
