Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/owent/hiredis-happ
Redis high available solution for c++
https://github.com/owent/hiredis-happ
cluster highavailable hiredis redis
Last synced: 6 days ago
JSON representation
Redis high available solution for c++
- Host: GitHub
- URL: https://github.com/owent/hiredis-happ
- Owner: owent
- License: mit
- Created: 2015-07-04T09:23:44.000Z (over 9 years ago)
- Default Branch: main
- Last Pushed: 2022-11-29T15:08:54.000Z (almost 2 years ago)
- Last Synced: 2024-11-02T04:12:18.645Z (13 days ago)
- Topics: cluster, highavailable, hiredis, redis
- Language: C++
- Homepage:
- Size: 697 KB
- Stars: 26
- Watchers: 9
- Forks: 11
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# hiredis-happ
Redis HA connector
[![ci-badge]][ci-link]
[ci-badge]: https://github.com/owent/hiredis-happ/actions/workflows/main.yml/badge.svg "Github action build status"
[ci-link]: https://github.com/owent/hiredis-happ/actions/workflows/main.yml "Github action build status"
## CI Job Matrix
| Target System | Toolchain | Note |
| ------------- | ------------------ | --------------------- |
| Linux | GCC |
| Linux | GCC-11 |
| Linux | Clang | With libc++ |
| Linux | GCC 4.8 |
| MinGW64 | GCC | Static linking |
| MinGW64 | GCC | Dynamic linking |
| Windows | Visual Studio 2019 | Static linking |
| Windows | Visual Studio 2019 | Dynamic linking |
| Windows | Visual Studio 2017 | Legacy,Static linking |
| macOS | AppleClang | With libc++ |
## Tips
1. auto reconnect
2. support redis cluster
3. ~~[TODO] support redis sential~~
4. support raw redis connection
## Usage
```bash
git clone https://github.com/owent/hiredis-happ.git;
mkdir -p hiredis-happ/build_jobs_dir && cd hiredis-happ/build_jobs_dir;
# cmake -DDCMAKE_INSTALL_PREFIX=/usr
# cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo
cmake .. ;
cmake --build . ;
# for install only, if not installed, all header files are in [BUILDDIR]/include, all libraries files are in [BUILDDIR]/lib
cmake --build . -- install
```
### Custom CMake Options
+ **CMAKE_BUILD_TYPE**: This cmake option will be default set to **RelWithDebInfo**.(Please add -DCMAKE_BUILD_TYPE=RelWithDebInfo when used in product environment)
+ **BUILD_SHARED_LIBS**: Default set to OFF
+ **ENABLE_BOOST_UNIT_TEST**: If using [boost.unittest](http://www.boost.org/libs/test/doc/html/index.html) for test framework(default: OFF)
+ **PROJECT_HIREDIS_HAPP_ENABLE_SAMPLE**: If building samples(default: OFF)
+ **PROJECT_HIREDIS_HAPP_ENABLE_UNITTEST**: If building unittest(default: OFF)
### Sample
See [sample_cluster_cli](sample/sample_cluster_cli) for redis cluster practice and [sample_raw_cli](sample/sample_raw_cli) for raw redis connection.
Both [happ_cluster](include/detail/happ_cluster.h) and [happ_raw](include/detail/happ_raw.h) support auto reconnecting and retry when cmd failed.
You can also custom how to print log by using *set_log_writer* to help you to find any problem.
## Document
See [doc](doc)
## Notice
This lib only support Request-Response commands now.(means every request should has only one response).
### Unsupport Commands
+ subscribe
+ unsubscribe
+ monitor
### Directory list
**3rd_party** -- script for 3rd party libraries
**doc** -- document
**include** -- include files
**project** -- project configure
**src** -- source
**sample** -- samples
**test** -- unit test
**tools** -- misc tools