An universal wrapper (and useful tool) to make event / commands in python
Project description
easy-events
A library that help you to manage events
Getting started
Installation
pip install easy-events
GitHub : Github
Usages
text
Code example
from easy_events import EasyEvents
# create an event or use it in a class
client = EasyEvents()
# create another event (can be sync or async)
# you can put as much parameters as you want
@client.add_event(aliases="test1")
def test(arg1, arg2, *, arg3):
# data is the default parameter, it contain some basic informations that you can format as you want
print(arg1, arg2, arg3)
# trigger the event
client.trigger(data=test1, parameters="arg1 arg2 arg3 arg4")
client.trigger("test1", "arg1 arg2 arg3 arg4")
client.trigger("test1", ["arg1", "arg2", "arg3", "arg4"])
client.trigger("test1", {"arg1": "arg1", "arg2": "arg2", "arg3": ["arg3", "arg4"]})
# dict way
client.trigger({"event": "test1", "parameters": {"arg1": "arg1", "arg2": "arg2", "arg3": ["arg3", "arg4"]}})
# dict way v2
client.trigger({"event": "test", "parameters": ["arg1", "arg2", "arg3", "arg4"]})
# dict way v3
client.trigger({"event": "test1", "parameters": "arg1 arg2 arg3 arg4"})
# list way
client.trigger(["test", "arg1", "arg2", "arg3", "arg4"])
# str way
client.trigger("test arg1 arg2 arg3 arg4")
# the result will be (for all cases):
# arg1 = arg1
# arg2 = arg2
# arg3 = [arg3, arg4]
This library also support type assignation
from easy_events import EasyEvents
client = EasyEvents()
@client.add_event()
def sum(X: int, Y: int):
return X+Y
client.trigger("sum 5 10")
client.trigger(["sum", "5", 10])
# the result will be 15
Context support
from easy_events import EasyEvents
class CTX:
def __init__(self, data: int = 0):
self.data = data
client = EasyEvents(default_context=CTX)
# client = EasyEvents(default_context=CTX(0)) works as well
@client.add_event()
def context(ctx):
print("ctx.data = ", ctx.data)
client.trigger("context", context=CTX(1))
client.trigger("context")
# this will print :
# "ctx.data = 1"
# "ctx.data = 0"
Project details
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
easy-events-3.1.0.tar.gz
(9.3 kB
view hashes)
Built Distribution
Close
Hashes for easy_events-3.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e89c88460a448cfccc35d63b19c788a96c659e24d79a3d89f884620224525c21 |
|
MD5 | ee3550ced6b97838c176c7c01eef1141 |
|
BLAKE2b-256 | d83e2945a73db8b3c212edcec5a733f65468967767ef26ef4b51e2c601226e56 |