hoytech / golpe

C++ application framework

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 database integration
  • C++17 fork of lmdbxx
  • RasgueaDB indexing and query layer
  • Flatbuffers for DB record encoding (and optionally network transports)
• Fork of uWebsockets 0.14 (last version with websocket client support)
• Automatic detection of cmd_*.cpp files and git-like subcommand dispatching
• taocpp config setup and hot reloading app when config file changes
• Setup of loguru logging with nice defaults
• 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