A generic functional middleware infrastructure for Python.
Project description
Formation
A generic functional middleware infrastructure for Python.
Take a look:
from datetime.datetime import now
from formation import wrap
from requests import get
def log(ctx, call):
print("started")
ctx = call(ctx)
print("ended")
return ctx
def timeit(ctx, call):
started = now()
ctx = call(ctx)
ended = now() - started
ctx['duration'] = ended
return ctx
def to_requests(ctx):
get(ctx['url'])
fancy_get = wrap(to_requests, middleware=[log, timeit])
fancy_get({'url':'https://google.com'})
Quick Start
Install using pip/pipenv/etc. (we recommend poetry for sane dependency management):
$ poetry add formation
Best Practices
A context
object is a loose bag of objects. With that freedom comes responsibility and opinion.
For example, this is how Formation models a requests
integration, with data flowing inside context
:
- It models a
FormationHttpRequest
which abstracts the essentials of making an HTTP request (later shipped torequests
itself in the way that it likes) - It tucks
FormationHttpRequest
under thefmtn.req
key. - Additional information regarding such a request is kept alongside
fmtn.req
. For example a request id is kept in thereq.id
key. This creates a flat (good thing) dict to probe. The reason additional data does not have thefmtn
prefix is that you can always build your own that uses a different prefix (which you cant say about internal Formation inner workings).
Thanks:
To all Contributors - you make this happen, thanks!
Copyright
Copyright (c) 2018 @jondot. See LICENSE for further details.
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
formation-0.1.21.tar.gz
(4.8 kB
view hashes)
Built Distribution
Close
Hashes for formation-0.1.21-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0cba630d880c020d2d9c20ffc6b711919822c7f575bfbacc0cd04e98300aec79 |
|
MD5 | d92be1480afcdd0d7311fd6012070ed3 |
|
BLAKE2b-256 | 57d7e2285e6ee0d5d6529cf82fde784e2d5171bd7a705b164c768462a50f2e5b |