gorilla 0.4.0

Features

• intuitive and convenient decorator approach to create patches.

• can create patches for all class or module members at once.

• compatible with both Python 2 and Python 3.

• customizable behaviour.

Usage

Thanks to the dynamic nature of Python that makes monkey patching possible, the process happens at runtime without ever having to directly modify the source code of the third-party library:

>>> import gorilla
>>> import destination
>>> @gorilla.patches(destination.Class)
... class MyClass(object):
...     def method(self):
...         print("Hello")
...     @classmethod
...     def class_method(cls):
...         print("world!")

The code above creates two patches, one for each member of the class MyClass, but does not apply them yet. In other words, they define the information required to carry on the operation but are not yet inserted into the specified destination class destination.Class.

Such patches created with the decorators can then be automatically retrieved by recursively scanning a package or a module, then applied:

>>> import gorilla
>>> import mypackage
>>> patches = gorilla.find_patches([mypackage])
>>> for patch in patches:
...     gorilla.apply(patch)

See the Tutorial section from the documentation for more detailed examples and explanations on how to use Gorilla.

Documentation

Read the documentation online at gorilla.readthedocs.io or check its source in the doc directory.

Out There

Projects using Gorilla include:

• bana

• mlflow

Author

Christopher Crouzet <christophercrouzet.com>