The database that doesn't wait for you, it comes.
Project description
# Welcome to ActionDB
*The database that doesn't wait for you, it **goes**.*
![MyPy](https://img.shields.io/badge/MyPy-Passing-blue.svg)
![Flake8](https://img.shields.io/badge/Flake8-Pep%208-brightgreen.svg)
[![Build Status](https://travis-ci.org/Zwork101/actionDB.svg?branch=master)](https://travis-ci.org/Zwork101/actionDB)
Full docs [here](https://zwork101.github.io/action/)
## Introduction
Welcome to actionDB, the DB that comes to you. ActionDB is designed to keep events that need to be summoned at a later
date persistent. Personally, this will be used when I make discord bots via
https://github.com/b1naryth1ef/disco. However this doesn't mean you
can't use this with anything else, you can, and I highly encourage that you do. While this library was designed so that
you could easily create and use your own backend, you're welcome to use the sqlite3 backend that comes with it. Lastly,
I was to talk about what's planned. At some point, I want to do some major refactoring, and separate the client and
server. This would allow you connect to a remote database, something that's not essential but nice, but mainly use
whatever concurrency library you want. The backend will still be gevent, however the client can be asyncio, trio,
threading, etc.
## Quick Start
To get started, we'll need to create our client, this will also create a action.db file, however the name can be
changed when initializing:
```py
from action import Action
action = Action()
```
After this, you should add listeners to your heart's content:
```py
@action.listen("new_msg")
def new_message(name: str, content: str, id: str=None)
print(name + "\n\n" + content + "\n" + "(" + id + ")")
```
And if you want to do something, such as send a message in 5 minutes, you can do:
```py
action.trigger_in(5 * 60, "new_msg", "Hello World!", "My name is sam, and I live in a can", id="2323445")
```
Then presuming you're also doing other things, or have utilized ``gevent.joinall``, in 5 minutes you'll see:
Hello World!
My name is sam, and I live in a can
(2323445)
And that's all there is! If you want to see how you can trigger events at an exact time, or other fun stuff, see the
documentation graciously provided below!
### Note:
You can import the main classes from action like so:
```py
from action import Action, ActionBackend, ActionEmitter, Event
```
Happy Coding!
*The database that doesn't wait for you, it **goes**.*
![MyPy](https://img.shields.io/badge/MyPy-Passing-blue.svg)
![Flake8](https://img.shields.io/badge/Flake8-Pep%208-brightgreen.svg)
[![Build Status](https://travis-ci.org/Zwork101/actionDB.svg?branch=master)](https://travis-ci.org/Zwork101/actionDB)
Full docs [here](https://zwork101.github.io/action/)
## Introduction
Welcome to actionDB, the DB that comes to you. ActionDB is designed to keep events that need to be summoned at a later
date persistent. Personally, this will be used when I make discord bots via
https://github.com/b1naryth1ef/disco. However this doesn't mean you
can't use this with anything else, you can, and I highly encourage that you do. While this library was designed so that
you could easily create and use your own backend, you're welcome to use the sqlite3 backend that comes with it. Lastly,
I was to talk about what's planned. At some point, I want to do some major refactoring, and separate the client and
server. This would allow you connect to a remote database, something that's not essential but nice, but mainly use
whatever concurrency library you want. The backend will still be gevent, however the client can be asyncio, trio,
threading, etc.
## Quick Start
To get started, we'll need to create our client, this will also create a action.db file, however the name can be
changed when initializing:
```py
from action import Action
action = Action()
```
After this, you should add listeners to your heart's content:
```py
@action.listen("new_msg")
def new_message(name: str, content: str, id: str=None)
print(name + "\n\n" + content + "\n" + "(" + id + ")")
```
And if you want to do something, such as send a message in 5 minutes, you can do:
```py
action.trigger_in(5 * 60, "new_msg", "Hello World!", "My name is sam, and I live in a can", id="2323445")
```
Then presuming you're also doing other things, or have utilized ``gevent.joinall``, in 5 minutes you'll see:
Hello World!
My name is sam, and I live in a can
(2323445)
And that's all there is! If you want to see how you can trigger events at an exact time, or other fun stuff, see the
documentation graciously provided below!
### Note:
You can import the main classes from action like so:
```py
from action import Action, ActionBackend, ActionEmitter, Event
```
Happy Coding!
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
actiondb-1.1.0.tar.gz
(9.8 kB
view details)
File details
Details for the file actiondb-1.1.0.tar.gz
.
File metadata
- Download URL: actiondb-1.1.0.tar.gz
- Upload date:
- Size: 9.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.9.1 pkginfo/1.4.1 requests/2.18.4 setuptools/28.8.0 requests-toolbelt/0.8.0 tqdm/4.19.5 CPython/3.6.4
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | b38a691900dee10acd0390dea724aba91fe7ef351609d43361968a209d07f2b2 |
|
MD5 | cf562f0b631747f3986a298bc2d18658 |
|
BLAKE2b-256 | e25203093b08a1f75431091c692ea41d9793d101d982833d7c7e28ef371684e1 |