Skip to main content

Qotto/eventy

Project description

Eventy

What is Eventy?

Eventy is both a protocol and a library for making the design of fault-tolerant, event-driven, concurrent and distributed applications in a microservices-oriented architecture easier.

As a protocol, Eventy is language-agnostic.

However, the reference implementation is written in Python. Whatever is your programming language, you can use Eventy. If you are using Python, you will be able to make the most of it quicker.

Motivation

The reality is, a distributed, microservices-oriented architecture is a bit hard to make right.

Martin Fowler even ended up stating:

First Law of Distributed Object Design: “don't distribute your objects”.

He later detailed his view of the First Law regarding microservices.

As Martin Folwer points out, inherently microservices come with their undeniable advantages and a few companies use them with great success. The only reason why a lot of people end up struggling with microservices, is because it greatly increases the complexity of the whole system, which makes it harder to get it right.

Eventy is adressing exactly that issue — providing you with a reliable framework to make microservices work for you.

A big part of the design process to create Eventy was to understand different use cases and see how the design can be simplified. For instance, not only does Eventy offer state partitionning for free, it actually comes up with a few stratagies that eliminate the need to persist state altogether.

Inspiration

Kafka Streams was a great influence in making Eventy. Celery and Faust are also worth to be looked at if you are looking for an opiniated framework easy to get started with.

However, these frameworks only partially solve all the issues you will have with microservices. And, in our opinion, these frameworks are not suitable for designing large critical systems.

They're both opinanated, and therefore cannot be easily integrated in your existing software. You will have to build your software around the framework, instead of the other way around. They also don't give you the full control on the way you can use them: you can only use them as a whole, or not at all.

What Eventy can do for you

Eventy implements multiple features, but all of them simply solve two main problems:

  • How to make services communicate with each other
  • How to access and persist state

With Eventy, you can serialize data the way you want. You can use Avro , JSON, gRPC, or whatever customer serializer you like.

With Eventy, you can use any system you like as a persistency layer, as long as it supports transactions, if you need strong processing guarantees. The most obvious choice is to use Apache Kafka, but persisting messages over PostgreSQL is completely feasable, too.

Eventy was destined with the mindset of a library of related but independently usable components - and not a framework: the behaviour is explicit and you're the one in charge: you can design your software your own way.

This explicit behaviour, albeit requiring more boilerplate, gives you better clarity on what is happening. Recipes and examples are provided so that you can understand how to use Eventy for most use cases.

You're free to use any part of Eventy as well. Even if you end up not using the Eventy protocol at all, simply reading the documentation and understanding the issues that are adressed and how they are adressed can help you to get on the right path.

Main components of Eventy

  • a well-defined communication protocol for sending various types of persisted messages, called Records: Events , Requests and Responses
  • persistency of Records that can be stored forever, which lets you keep track of all the changes in your system ( especially useful for audits and business analytics)
  • queues so that Records can be processed asynchroneously, and aren't lost even if your system is down or overloaded
  • strong processing guarantees: a Record can be designed to be processed at least once, at most once and _ exactly once_ even if your system encounters a process or network failure at any point
  • self-propagating Contexts that in many cases entirely eliminate the need of persisting state
  • partitionned state persistency so that you no longer have a single point of failure in your system (aka the database) and can scale up as your business grows

Contribute

Install with dev dependencies

poetry install -E celery -E sanic -E aiohttp -E django -E confluent-kafka -E avro -E requests -E gunicorn

The project uses poetry

poetry config pypi-token.pypi my-token
poetry config testpypi-token.pypi my-token

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

eventy-3.4.0.tar.gz (36.2 kB view details)

Uploaded Source

Built Distribution

eventy-3.4.0-py3-none-any.whl (48.8 kB view details)

Uploaded Python 3

File details

Details for the file eventy-3.4.0.tar.gz.

File metadata

  • Download URL: eventy-3.4.0.tar.gz
  • Upload date:
  • Size: 36.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.6.1 CPython/3.9.4 Darwin/23.2.0

File hashes

Hashes for eventy-3.4.0.tar.gz
Algorithm Hash digest
SHA256 700d0c2c6421d5b81b1d77548f0a2a0d0a4ff85ecb70fc6f49f817db320c9a4d
MD5 6f3d0130da8885ef75c66d53225ba61e
BLAKE2b-256 8a74ec0b315e8dbea90bc697bfdf3cd6114eeb51f69915b31b605dd906d8540a

See more details on using hashes here.

File details

Details for the file eventy-3.4.0-py3-none-any.whl.

File metadata

  • Download URL: eventy-3.4.0-py3-none-any.whl
  • Upload date:
  • Size: 48.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.6.1 CPython/3.9.4 Darwin/23.2.0

File hashes

Hashes for eventy-3.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 31d3bed7c3d3436461d3fc06f4baa04e3149851d3eafddf4a25f8317f757973b
MD5 362c47570217183cecd91f8f1bbdab1a
BLAKE2b-256 194b838a8384bd826846fd6fea0cf73f53e77e5099a286389e36b76f21171eef

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