Skip to main content

Modular event-centric python library made for simplification typical stream applications development with python type system strong exploitation.

Project description

typed-blocks


Documentation: https://typed-blocks.readthedocs.io


Typed Blocks is a modular event-centric python library created to simplify development of typical stream applications. It hardly exploits standard Python type hints.

Distinctive features:

  • Boilerplate-less: just ties together pre-defined computational blocks.
  • Focuses on loose coupling and event-driven design.
  • Encourages explicit separation of data and code. Static typing to the rescue!
  • Minimalistic at it's core and easy-to-go.
  • Modular and open for extension via self-defined connectors for different data sources.

Installation

In minimal installation typed-blocks requires python 3.7 or greater and has no dependencies, so you may just use:

$ pip install typed-blocks

For each data source or extended features you may need corresponding client library. More details in documentation.

Example

If it is hard to understand, what is going on in the following snippet of code, this article also may help.

TL;DR:

  • we are defining events: minimally significant pieces of data
  • we are defining source of all events in our program
  • we define processors to handle them
  • we put all ingredients in the App. Type hints are important! It's actually definition of which processor should handle event and should it emit new events or not.
  • ???
  • it works!
from dataclasses import dataclass

from blocks import App, source, processor


@dataclass
class E:
    x: int


@dataclass
class E2:
    y: int


@source
def generator() -> E:
    return E(1)


@processor
def printer(e: E) -> E2:
    print('1', e)
    return E2(e.x)


@processor
def printer2(e: E2) -> None:
    print('2', e)


blocks = (generator(), printer(), printer2())
App(blocks).run(once=True)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

typed-blocks-0.15.1.tar.gz (48.8 kB view details)

Uploaded Source

Built Distribution

typed_blocks-0.15.1-py3-none-any.whl (56.5 kB view details)

Uploaded Python 3

File details

Details for the file typed-blocks-0.15.1.tar.gz.

File metadata

  • Download URL: typed-blocks-0.15.1.tar.gz
  • Upload date:
  • Size: 48.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.11.4

File hashes

Hashes for typed-blocks-0.15.1.tar.gz
Algorithm Hash digest
SHA256 df48a4d19a9d3c1b6eef976f173d597d263ad5c99c76cc289a8d79d52617e9c3
MD5 68fd604914ed69717493f724e3d40ce5
BLAKE2b-256 d759a696bb1e292ccbc545c14cf5495a49f9a095ea6baad7995dc74e9ce9123e

See more details on using hashes here.

File details

Details for the file typed_blocks-0.15.1-py3-none-any.whl.

File metadata

File hashes

Hashes for typed_blocks-0.15.1-py3-none-any.whl
Algorithm Hash digest
SHA256 bb627ec1776f9c674fcf1dc631248bb4db3ae76d94ea33b29920d8a008e85088
MD5 e6c72400a98c6ca58e1c81ede4b6793b
BLAKE2b-256 55283f33814f2af4c94be9a7ba06a2700b13f801f2f2107a4fe059d47649bbb9

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page