Beer-garden plugin and utility library
Project description
Brewtils
Brewtils is the Python library for interfacing with Beergarden systems. If you are planning on writing beer-garden plugins, this is the correct library for you. In addition to writing plugins, it provides simple ways to query the API and is officially supported by the beer-garden team.
Features
Brewtils helps you interact with beer-garden.
- Easy way to create beer-garden plugins
- Full support of the entire Beer-Garden API
- Officially supported by the beer-garden team
Installation
To install brewtils, run this command in your terminal:
$ pip install brewtils
Or add it to your requirements.txt
$ cat brewtils >> requirements.txt
$ pip install -r requirements.txt
Quick Start
You can create your own beer-garden plugins without much problem at all. To start, we'll create the obligatory hello-world plugin. Creating a plugin is as simple as:
from brewtils.decorators import system, parameter, command
from brewtils.plugin import RemotePlugin
@system
class HelloWorld(object):
@parameter(key="message", description="The message to echo", type="String")
def say_hello(self, message="World!"):
print("Hello, %s!" % message)
return "Hello, %s!" % message
if __name__ == "__main__":
client = HelloWorld()
plugin = RemotePlugin(client,
name="hello",
version="0.0.1",
bg_host='127.0.0.1',
bg_port=2337)
plugin.run()
Assuming you have a Beer Garden running on port 2337 on localhost, running this will register and
start your plugin! You now have your first plugin running in beer-garden. Let's use another part
of the brewtils library to exercise your plugin from python.
The SystemClient is designed to help you interact with registered Systems as if they were native
Python objects.
from brewtils.rest.system_client import SystemClient
hello_client = SystemClient('localhost', 2337, 'hello')
request = hello_client.say_hello(message="from system client")
print(request.status) # 'SUCCESS'
print(request.output) # Hello, from system client!
In the background, the SystemClient has executed an HTTP POST with the payload required to get
beer-garden to execute your command. The SystemClient is how most people interact with
beer-garden when they are in the context of python and want to be making requests.
Of course, the rest of the API is accessible through the brewtils package. The EasyClient
provides simple convenient methods to call the API and auto-serialize the responses. Suppose you
want to get a list of all the commands on all systems:
from brewtils.rest.easy_client import EasyClient
client = EasyClient('localhost', 2337)
systems = client.find_systems()
for system in systems:
for command in system.commands:
print(command.name)
This is just a small taste of what is possible with the EasyClient. Feel free to explore all the
methods that are exposed.
For more detailed information and better walkthroughs, checkout the full documentation!
Documentation
- Full Beer Garden documentation is available at https://beer-garden.io
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file brewtils-3.31.1.tar.gz.
File metadata
- Download URL: brewtils-3.31.1.tar.gz
- Upload date:
- Size: 106.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
93ba2cb1447240b98a1087f96e2802f45abffd66a3818ff77795c4943297b909
|
|
| MD5 |
74b34d2fcc1c1519e6aa418b8217b195
|
|
| BLAKE2b-256 |
d8c4784ded2e30a9c7ef563c62e7f7202d15ba2637231201163b0c28e77ac9ec
|
Provenance
The following attestation bundles were made for brewtils-3.31.1.tar.gz:
Publisher:
tag-actions.yml on beer-garden/brewtils
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
brewtils-3.31.1.tar.gz -
Subject digest:
93ba2cb1447240b98a1087f96e2802f45abffd66a3818ff77795c4943297b909 - Sigstore transparency entry: 802664385
- Sigstore integration time:
-
Permalink:
beer-garden/brewtils@76920e2bbad5e34ef0513549ca811db76f280187 -
Branch / Tag:
refs/tags/3.31.1 - Owner: https://github.com/beer-garden
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
tag-actions.yml@76920e2bbad5e34ef0513549ca811db76f280187 -
Trigger Event:
push
-
Statement type:
File details
Details for the file brewtils-3.31.1-py2.py3-none-any.whl.
File metadata
- Download URL: brewtils-3.31.1-py2.py3-none-any.whl
- Upload date:
- Size: 117.0 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9b078ec7d5720178b2a58b71ee0ea5f0fcd96e8d182c214a2afb0e8e46fb4207
|
|
| MD5 |
b269071c0b293ec09d5d2b2701f66fd5
|
|
| BLAKE2b-256 |
fec3a1b85dc56851043f19e4dbb583fae0ad89301b1a42217552abd2369354c4
|
Provenance
The following attestation bundles were made for brewtils-3.31.1-py2.py3-none-any.whl:
Publisher:
tag-actions.yml on beer-garden/brewtils
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
brewtils-3.31.1-py2.py3-none-any.whl -
Subject digest:
9b078ec7d5720178b2a58b71ee0ea5f0fcd96e8d182c214a2afb0e8e46fb4207 - Sigstore transparency entry: 802664432
- Sigstore integration time:
-
Permalink:
beer-garden/brewtils@76920e2bbad5e34ef0513549ca811db76f280187 -
Branch / Tag:
refs/tags/3.31.1 - Owner: https://github.com/beer-garden
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
tag-actions.yml@76920e2bbad5e34ef0513549ca811db76f280187 -
Trigger Event:
push
-
Statement type:
