Write declarative, reactive expressions or just implement the observer pattern.
Observable is a self-contained, header-only library that has no depencencies. Drop it somewhere in your include path and you're good to go.
Example:
#include <iostream>
#include <observable/observable.hpp>
using namespace std;
using namespace observable;
int main()
{
auto sub = subject<void(string)> { };
sub.subscribe([](auto const & msg) { cout << msg << endl; });
// "Hello, world!" will be printed to stdout.
sub.notify("Hello, world!");
auto a = value<int> { 5 };
auto b = value<int> { 5 };
auto avg = observe(
(a + b) / 2.0f
);
auto eq_msg = observe(
select(a == b, "equal", "not equal")
);
avg.subscribe([](auto val) { cout << val << endl; });
eq_msg.subscribe([](auto const & msg) { cout << msg << endl; });
// "10" and "not equal" will be printed to stdout in an
// unspecified order.
b = 15;
return 0;
}You can access the documentation here: https://danieldinu.com/observable/.
The library uses CMake to build the tests, benchmarks and documentation. You do not need CMake if you don't plan on running the tests or benchmarks.
Bug reports, feature requests, documentation and code contributions are welcome and highly appreciated. Please open an issue or feature request before you start working on any pull request.
The library is licensed under the Apache License version 2.0.
All contributions must be provided under the terms of this license.
Any relatively recent compiler with C++14 support should work.
The code has been tested with the following compilers:
- MSVC 15 (Visual Studio 2017)
- MSVC 14 (Visual Studio 2015)
- GCC 5, 6, 7
- Clang 3.6, 3.8
- AppleClang 9.1
Visual Studio 2017 builds:
(32 bit, C++14)
(64 bit, C++14)
(32 bit, C++17)
(64 bit, C++17)
Visual Studio 2015 builds:
(32 bit, C++14)
(64 bit, C++14)
Linux (GCC, Clang) and OS X (Clang) builds:
(64 bit)
