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.10.2.tar.gz (36.1 kB view details)

Uploaded Source

Built Distribution

typed_blocks-0.10.2-py3-none-any.whl (46.9 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for typed-blocks-0.10.2.tar.gz
Algorithm Hash digest
SHA256 2a3ea19bd7ce49be52034e6dabb6603be10f840f16db71d0d3f30c9cef4bd70c
MD5 9431925b468beabeb0b89af86bdf6ee3
BLAKE2b-256 f54d35b7bd4d7bc22dc9ae42a8b25010e8e0513e210fd2d0fc7bbf9d8044c385

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for typed_blocks-0.10.2-py3-none-any.whl
Algorithm Hash digest
SHA256 8d3b90db5a726d230eae38b13a14077a8c4a34beb82c3b1da0942214698a2c48
MD5 db957652bb6d3edb36de7efba769b50d
BLAKE2b-256 f7e34cca5f42ee297de3b4e0866fa03688c531ed44c981a3f6e16ba132b62ea7

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