README

Sese Framework

Intro

This is a cross-platform framework for developing fundamental components, used to some extent as a supplement to the standard library. It is positioned similarly to Boost and folly with respect to the standard library. The project uses C++ 20 standard and introduces vcpkg as a package manager to help us simplify dependency management issues.

Demo

Builtin logger

Modern formatting style

#include <sese/Log.h>
// ...
namespace sese::text::overload {
template<>
struct Formatter<Point> {
    bool parse(const std::string &) { return true; }
    void format(FmtCtx &ctx, const Point &p) {
        ctx.builder << fmt("({},{})", p.x, p.y);
    }
};
}
// ...
int a = 1, b = 2;
Point point{1, 2};
SESE_INFO("hello world");
SESE_INFO("a + b = {}", a + b);
SESE_INFO("point {}", point);

2024-06-27T01:43:05.571Z I main.cpp:7 Main:10376> hello world
2024-06-27T01:43:05.572Z I main.cpp:8 Main:10376> a + b = 3
2024-06-27T01:43:05.572Z I main.cpp:9 Main:10376> point (1,2)

C-Like formatting style

#define SESE_C_LIKE_FORMAT
#include <sese/Log.h>
// ...
SESE_INFO("hello world");
SESE_WARN("error %s", err.what().c_str());

2024-05-15T15:54:48.296Z I main.cpp:8 Main:7116> hello world
2024-05-15T15:54:48.296Z W main.cpp:9 Main:7116> error End of file

HTTP Controller

#include <sese/service/http/HttpServer_V3.h>
// ...
SESE_CTRL(MyController, std::mutex mutex{}; int times = 0) {
    SESE_INFO("LOADING MyController");
    SESE_URL(timers, RequestType::GET, "/times") {
        sese::Locker locker(mutex);
        auto &resp = ctx.getResp();
        times += 1;
        auto message = "timers = '" + std::to_string(this->times) + "'\n";
        resp.getBody().write(message.data(), message.length());
    };
    SESE_URL(say, RequestType::GET, "/say?<say>") {
        auto &resp = ctx.getResp();
        auto words = req.get("say");
        auto message = "you say '" + words + "'\n";
        resp.getBody().write(message.data(), message.length());
    };
    SESE_INFO("LOADED");
}

Cross-process communication

#include <sese/system/IPC.h>
#include <sese/Log.h>
// ···
// server
auto channel = sese::system::IPCChannel::create("Test", 1024);
while (true) {
    auto messages = channel->read(1);
    if (messages.empty()) {
        sese::sleep(1s);
        continue;
    }
    for (auto &&msg: messages) {
        SESE_INFO("recv {}", msg.getDataAsString());
        if (msg.getDataAsString() == "Exit") {
            goto end;
        }
    }
}
end:
return 0;
// ···
// client
auto channel = sese::system::IPCChannel::use("Test");
channel->write(1, "Hello");
channel->write(2, "Hi");
channel->write(1, "Exit");

Build

For Developers/Contributors

1. Configure the development environment

For Windows users, please install and config the vcpkg.

For non-Windows users, vcpkg is likewise available. But at the same time, you can choose to install the dependencies using the native system dependency management tool. We have provided several preset installation scripts.

• Ubuntu

sudo ./scripts/install_ubuntu_deps.sh

• Fedora

sudo ./scripts/install_fedora_deps.sh

• macOS

./scripts/install_darwin_deps.sh

2. Compilation options

If you have vcpkg configured, you can simply configure the dependencies by setting the toolchain file.

If you're using a system dependency management tool, you'll need to manually add the 'SESE_USE_NATIVE_MANAGER' compilation option after pressing the corresponding dependency.

sese/CMakeLists.txt

Lines 8 to 16 in 4cd7438

	option(SESE_USE_NATIVE_MANAGER "use the unix-like packages control" OFF)
	option(SESE_BUILD_TEST "build unit test targets" OFF)
	option(SESE_BUILD_EXAMPLE "build example targets" OFF)
	option(SESE_AUTO_VCPKG "auto find vcpkg and include toolchain" OFF)
	option(SESE_USE_ASYNC_LOGGER "use async logger" OFF)
	option(SESE_USE_ARCHIVE "add archive support" OFF)
	option(SESE_DB_USE_SQLITE "add sqlite support" ON)
	option(SESE_DB_USE_MARIADB "add mariadb and mysql support" OFF)
	option(SESE_DB_USE_POSTGRES "add postgresql support" OFF)

Tip

Please refer to the latest CMakeLists.txt file understands the corresponding functional options Or you can just use our default CMakePresets.json, which will enable most of the options by default.

3. Compile

Configuring the finished compilation options only requires a regular build, such as:

cmake --build build/linux-debug -- -j 4

For Normal Users

For common users, we recommend using vcpkg to import this dependency, you can refer to our template project to config your project()

Warning

Projects can also be installed on ordinary machines as normal projects, but this is not a recommended practice and cannot be supported. If you want to do this, you can refer to the 'Build' > 'For Developers/Contributors' section on dependency management tools.

The main job is to write the project's dependency configuration file, for example:

vcpkg.json

{
  "dependencies": [
    "sese"
  ]
}

Important

Since the built-in baseline 14b91796a68c87bc8d5cb35911b39287ccb7bd95, sese has been included in the built-in list. Before this, you needed to create an additional configuration file to import our private registry, just like this:

vcpkg-configuration.json

{
  "default-registry": {
    "kind": "git",
    "repository": "https://github.com/microsoft/vcpkg.git",
    "baseline": "c8696863d371ab7f46e213d8f5ca923c4aef2a00"
  },
  "registries": [
    {
      "kind": "git",
      "repository": "https://github.com/libsese/vcpkg-registry.git",
      "baseline": "73268778d5f796f188ca66f71536377b171ee37e",
      "packages": [
        "sese"
      ]
    }
  ]
}

If you're not using vcpkg, the above steps are unnecessary.

Testing

We used googletest as our testing framework. Detailed information about our tests can be found in github actions, including the results of various platforms and linux test coverage.

Platform	Entry	Unit Test	Coverage Test
Windows	Unit Tests	✅
Linux	Unit Tests	✅	✅
macOS	Unit Tests	✅

1. Local Testing

• Services on Ubuntu workflow

If you need to run full tests locally, you may need to pay attention to the database side of the test, which requires some additional service and configuration support.

sese/.github/workflows/ubuntu-22.04-apt.yml

Lines 14 to 34 in 4cd7438

	services:
	mariadb:
	image: mariadb
	env:
	MARIADB_ROOT_HOST: '%'
	MARIADB_USER: libsese
	MARIADB_PASSWORD: libsese
	MARIADB_ROOT_PASSWORD: libsese
	ports:
	- '127.0.0.1:18806:3306'
	postgresql:
	image: postgres
	env:
	POSTGRES_PASSWORD: libsese
	options: >-
	--health-cmd pg_isready
	--health-interval 10s
	--health-timeout 5s
	--health-retries 5
	ports:
	- '127.0.0.1:18080:5432'

sese/.github/workflows/ubuntu-22.04-apt.yml

Lines 45 to 53 in 4cd7438

	- name: Setup Database
	working-directory: ${{ github.workspace }}
	env:
	PGPASSWORD: libsese
	run: |
	mysql -uroot -plibsese -h 127.0.0.1 -P 18806 < ./scripts/mysql_dump.sql
	psql -U postgres -d postgres -h 127.0.0.1 -p 18080 -f ./scripts/postgres_dump.sql
	mkdir build
	sqlite3 build/db_test.db < scripts/sqlite_dump.sql

sese/.github/workflows/ubuntu-22.04-apt.yml

Lines 72 to 75 in 4cd7438

	-DSESE_DB_MYSQL_CONNECTION_STRING="host=127.0.0.1\;port=18806\;user=root\;pwd=libsese\;db=db_test\;"
	-DSESE_DB_PSQL_CONNECTION_STRING="host=127.0.0.1\;port=18080\;user=postgres\;pwd=libsese\;db=db_test\;"
	-DSESE_DB_SQLITE_CONNECTION_STRING="${{ github.workspace }}/build/db_test.db"
	-DCMAKE_CXX_FLAGS="--coverage -fprofile-update=atomic"

• Deploy services through docker-compose

docker-compose -f ./docker/docker-compose.yml up -d
sqlite3 build/db_test.db < scripts/sqlite_dump.sql

2. Generate coverage test reports

Gcovr needs to be installed, either by pip or using the System Package Manager.

mkdir -p build/coverage/html
gcovr

Note

Generating coverage test data first requires setting some additional compilation options to generate test data such as gcov format, such as GCC compilation options:

sese/.github/workflows/ubuntu-22.04-apt.yml

Line 75 in 4cd7438

-DCMAKE_CXX_FLAGS="--coverage -fprofile-update=atomic"

Documents

Documents will be updated automatically with the update of the main branch to making pages.

Document content is automatically generated from code comments, and the docs directory actually houses some of the resources needed to build the document.

Contributors

License