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 hs_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'])
return ctx
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).
added support for async http client via aio_http
You can use this via for_aio_http
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
hs-formation-5.0.0.tar.gz
(10.4 kB
view hashes)
Built Distribution
Close
Hashes for hs_formation-5.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 76776b29db05f14f9b83f8527995b8d54df5d23aa077e9875368a7a1c6e6a13a |
|
MD5 | c5bc01f07fc68f695e5e454feb88ca77 |
|
BLAKE2b-256 | fb4866e73df6137db9b3bdf7b4bdf946a3887cf0a4526439bc0bed184b6a5f1b |