pluggy - A minimalist production ready plugin system

This is the core framework used by the pytest, tox, and devpi projects.

Please read the docs to learn more!

A definitive example

import pluggy

hookspec = pluggy.HookspecMarker("myproject")
hookimpl = pluggy.HookimplMarker("myproject")


class MySpec(object):
    """A hook specification namespace.
    """
    @hookspec
    def myhook(self, arg1, arg2):
        """My special little hook that you can customize.
        """


class Plugin_1(object):
    """A hook implementation namespace.
    """
    @hookimpl
    def myhook(self, arg1, arg2):
        print("inside Plugin_1.myhook()")
        return arg1 + arg2


class Plugin_2(object):
    """A 2nd hook implementation namespace.
    """
    @hookimpl
    def myhook(self, arg1, arg2):
        print("inside Plugin_2.myhook()")
        return arg1 - arg2


# create a manager and add the spec
pm = pluggy.PluginManager("myproject")
pm.add_hookspecs(MySpec)

# register plugins
pm.register(Plugin_1())
pm.register(Plugin_2())

# call our `myhook` hook
results = pm.hook.myhook(arg1=1, arg2=2)
print(results)

Metadata

Release files for pluggy 0.7.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pluggy 0.7.1
File	Size	Uploaded
pluggy-0.7.1.tar.gz	47.8 kB	Jul 28, 2018	Details

Built distribution (wheel)

Table of built distributions (wheels) for pluggy 0.7.1
File	Interpreter	ABI	Platform	Reset
pluggy-0.7.1-py2.py3-none-any.whl 14.1 kB Jul 28, 2018	Python 2, Python 3	none	any	Details

Total release size: 61.8 kB

Release files / pluggy-0.7.1.tar.gz

Download URL	pluggy-0.7.1.tar.gz
Size	47.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`95eb8364a4708392bae89035f45341871286a333f749c3141c20573d2b3876e1`
BLAKE2b-256 checksum How to use checksums	`a183ef7d976c12d67a5c7a5bc2a47f0501c926cabae9d9fcfdc26d72abc9ba15`
Upload date	Jul 28, 2018
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.24.0 CPython/3.6.3`

Release files / pluggy-0.7.1-py2.py3-none-any.whl

Download URL	pluggy-0.7.1-py2.py3-none-any.whl
Size	14.1 kB
Tags	Python 2 Python 3
SHA-256 checksum How to use checksums	`6e3836e39f4d36ae72840833db137f7b7d35105079aee6ec4a62d9f80d594dd1`
BLAKE2b-256 checksum How to use checksums	`f5f15a93c118663896d83f7bcbfb7f657ce1d0c0d617e6b4a443a53abcc658ca`
Upload date	Jul 28, 2018
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.24.0 CPython/3.6.3`