https://github.com/hoytech/golpe
C++ application framework
https://github.com/hoytech/golpe
Last synced: about 2 months ago
JSON representation
C++ application framework
- Host: GitHub
- URL: https://github.com/hoytech/golpe
- Owner: hoytech
- Created: 2021-10-29T03:08:27.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-09-14T13:43:23.000Z (9 months ago)
- Last Synced: 2025-03-25T16:22:22.689Z (2 months ago)
- Language: Perl
- Homepage:
- Size: 291 KB
- Stars: 5
- Watchers: 3
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# golpe - C++ application framework
golpe is an opinionated framework for building C++ servers. It is specially tailored for building websocket servers that interact with an embedded LMDB database.
Most of the framework is configured in a declarative manner, by editing a file named `golpe.yaml`.
## Features
* [LMDB](https://lmdb.tech/) database integration
* C++17 fork of [lmdbxx](https://github.com/hoytech/lmdbxx/)
* [RasgueaDB](https://github.com/hoytech/rasgueadb) indexing and query layer
* [Flatbuffers](https://google.github.io/flatbuffers/) for DB record encoding (and optionally network transports)
* Fork of [uWebsockets 0.14](https://github.com/hoytech/uWebSockets) (last version with websocket client support)
* Automatic detection of `cmd_*.cpp` files and git-like subcommand dispatching
* [taocpp config](https://github.com/taocpp/config) setup and hot reloading app when config file changes
* Setup of [loguru](https://github.com/emilk/loguru) logging with nice defaults
* [docopt.cpp](https://github.com/docopt/docopt.cpp) integration for command-line argument processing
* Flexible `make` build framework
* Lots of little conveniences
## Setup
Run:
mkdir myapp
cd myapp
git init
git submodule add https://github.com/hoytech/golpe.git
Edit `Makefile`:
BIN = myapp
OPT = -O3 -g
include golpe/rules.mk
Edit `golpe.yaml`:
appName: myapp
Run:
make setup-golpe
## Example apps
Coming soon
## Tips
* If you add a new command, to avoid rebuilding everything, run `rm build/main.*` and then `make`