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).
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-4.1.13.tar.gz
(8.4 kB
view hashes)
Built Distribution
Close
Hashes for hs_formation-4.1.13-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f04b218dccc4a66348b50914766f21531db4843ab03ea817c843a7138ea75a63 |
|
MD5 | c973126bc5374b5f427c3393b846093b |
|
BLAKE2b-256 | 90666aa3375192680cb84b196cd418ca73bcc6042e94649bf0921a666a0507bd |