Crow

Crow is C++ microframework for web. (inspired by Python Flask)

Features

• Easy routing
  • Similiar to Flask
  • Type-safe Handlers (see Example)
• Fast built-in JSON parser (crow::json)
• Mustache based templating library (crow::mustache)
• Header only
• Provide an amalgamated header file `crow_all.h' with every features
• Middleware support

Still in development

• Built-in ORM

Example

#include "crow.h"
#include "json.h"

#include <sstream>

int main()
{
    crow::SimpleApp app;

    CROW_ROUTE(app, "/about")
    ([](){
        return "About Crow example.";
    });

    // simple json response
    CROW_ROUTE(app, "/json")
    ([]{
        crow::json::wvalue x;
        x["message"] = "Hello, World!";
        return x;
    });

    // argument
    CROW_ROUTE(app,"/hello/<int>")
    ([](int count){
        if (count > 100)
            return crow::response(400);
        std::ostringstream os;
        os << count << " bottles of beer!";
        return crow::response(os.str());
    });

    // Compile error with message "Handler type is mismatched with URL paramters"
    //CROW_ROUTE(app,"/another/<int>")
    //([](int a, int b){
        //return crow::response(500);
    //});

    // more json example
    CROW_ROUTE(app, "/add_json")
    ([](const crow::request& req){
        auto x = crow::json::load(req.body);
        if (!x)
            return crow::response(400);
        int sum = x["a"].i()+x["b"].i();
        std::ostringstream os;
        os << sum;
        return crow::response{os.str()};
    });

    app.port(18080)
        .multithreaded()
        .run();
}

How to Build

If you just want to use crow, copy amalgamate/crow_all.h and include it.

Requirements

• C++ compiler with good C++11 support (tested with g++>=4.8)

• boost library

• CMake

• Linking with tcmalloc/jemalloc is recommended for speed.

Building (Tests, Examples)

Out-of-source build with CMake is recommended.

mkdir build
cd build
cmake ..
make

You can run tests with following commands:

ctest

Installing missing dependencies

Ubuntu

sudo apt-get install build-essential libtcmalloc-minimal4 && sudo ln -s /usr/lib/libtcmalloc_minimal.so.4 /usr/lib/libtcmalloc_minimal.so

OSX

brew install boost google-perftools