This is my personal fork from cerveur, a simple web framework written in C for fun and learning.
To see a full sample project built with Cerveurus, check out my Cerveurus Sample Project.
I feel like the original project is pretty inactive and there are pull requests from 1+ months that are still open and there's a lot I want to contribute to this project so I decided to fork it and develop my own separate chain.
The original name cerveur reminded me of cerberus so I'm naming it cerveurus.
I included cJSON as a git submodule to handle parsing JSON requests/reponses.
You MUST use the --recursive flag when cloning this repo. See below section.
The original project used plain Makefiles but I'm a fan of CMake, so I will use that as the build system for this fork.
This includes submodules so please clone the repo with:
git clone --recursive [email protected]:Kiyoshika/cerveurus.git
Or if you forget to clone recursively you can use:
git submodule initgit submodule updateWhich should fetch the submodules.
After cloning, enter the root directory and use:
mkdir build && cd buildcmake .. && make
Which should build the libcerveurus.a static library that can be linked to your server.
To run the tests, go to the build folder and use make test CTEST_OUTPUT_ON_FAILURE=TRUE.
After running make inside your build folder, a main executable will be generated inside build/src and copy over the templates/ and static/ folders. Use ./src/main (assuming you're inside the build folder) to run the server. By default it's on port 6100 then go to localhost:6100 in your browser. This is the development/testing server that you can play around with.
When killing the server (e.g., Ctrl+C) you may need to wait ~10 seconds and/or kill the server a few times for it to pick up a connection again (at least, this has been my experience...)
Will write more detail once library is more mature.