Repository files navigation

The core concept ofMarble.js assumes that almost everything is a stream. The main building block of the whole framework is an Effect, which is just a function that returns a stream of events. With the big popularity ofRxJS Observable, you can create a referential transparent program specification made up of functions that may produce side effects like network, logging, database access, etc. Using its monadic nature we can map I/O operations over effects and flat them to bring in other sequences of operations. RxJS is used as a hammer for expressing asynchronous flow with monadic manner.

Marble.js doesn't operate only over basicHTTP protocol but can be used also for general MDA (Message-Driven Architecture) solutions, includingWebSocket,microservices orCQRS, where the multi-event nature fits best. Don't be scared of the complexity and abstractions — Marble.js framework, in general, is incredibly simple. For more details about its specifics, please visit the next chapters that will guide you through the framework environment and implementation details.

For those who are curious about the framework name - it comes from a popular way of visually expressing the time-based behavior of event streams, aka marble diagrams. This kind of domain-specific language is a popular way of testing asynchronous streams, especially in RxJS environments.

{% hint %}👉 If you have ever worked with libraries likeRedux Observable,@ngrx/effects or other libraries that leverage functional reactive paradigm, you will feel at home.{% endhint %}

{% hint %}👉 If you don't have any experience with functional reactive programming, we strongly recommend to gain some basic overview first withReactiveX intro or withThe introduction to Reactive Programming you've been missing written by@andrestaltz.{% endhint %}

{% embed url="https://medium.com/@jflakus/announcing-marble-js-3-0-a-marbellous-evolution-ba9cdc91d591" caption="" %}

{% embed url="https://medium.com/@jflakus/marble-2-reactive-better-functional-stronger-5924119d3098" caption="" %}

{% embed url="https://medium.com/@jflakus/marble-js-when-node-js-meets-rxjs-da2764b7ca9b" caption="" %}

If you would like to get a quick glimpse of a simple RESTful API built with Marble.js, visit the following link:

{% page-ref page="other/how-does-it-glue-together.md" %}