coost-A tiny boost library in C++11​

coost 是一个兼具性能与易用性的跨平台 C++ 基础库，原名为 co，后改为 cocoyaxi，前者过短，后者过长，取中庸之道，又改为 coost。

为什么叫 coost 呢？以前有朋友称之为小型 boost 库，比 boost 小一点，那就叫 coost 好了。它有多小呢？在 linux 与 mac 上编译出来的静态库仅 1M 左右大小。虽然小，却提供了足够强大的功能：

• 命令行参数与配置文件解析库(flag)
• 高性能日志库(log)
• 单元测试框架(unitest)
• go-style 协程
• 基于协程的网络编程框架
• 高效 JSON 库
• 基于 JSON 的 RPC 框架
• 面向玄学编程
• 原子操作(atomic)
• 随机数生成器(random)
• 高效字符流(fastream)
• 高效字符串(fastring)
• 字符串操作(str)
• 时间库(time)
• 线程库(thread)
• 定时任务调度器
• 高性能内存分配器
• LruMap
• hash 库
• path 库
• 文件系统操作(fs)
• 系统操作(os)

本次发布的版本，直接从 v2.0.3 跳到了 v3.0.0，跨度非常之大，它在性能、易用性、稳定性等方面均有全面的提升。

性能优化

内存分配器

v3.0 中实现了一个新的内存分配器(co/malloc)，它不是通用的内存分配器，在 free 与 realloc 时，需要额外带上原内存块的 size 信息，这在使用时可能有一点点不便，但可以简化设计，提升内存分配器的性能。

通用的内存分配器，像 ptmalloc, jemalloc, tcmalloc 以及 mimalloc 等，小内存释放后大概率会被它们缓存住，而并没有归还给操作系统，这可能造成释放大量小内存后内存占用量却始终不降的疑似内存泄漏的现象。co/malloc 对此做了优化，在兼顾性能的同时，会尽可能多的将释放的内存归还给操作系统，有利于降低程序的内存占用量，在实测中也取得了良好的效果。

co/malloc 还提供了 co::stl_allocator，可以替换 STL 容器中默认的分配器 std::allocator。co/stl.h 中提供了一些常用的替换 allocator 后的容器，与 std 版本相比有着性能上的优势。

co/malloc 已经成为 coost 内部使用的默认内存分配器，像 fastring、fastream、Json 等均基于 co/malloc 实现。co/test 中提供了简单的测试代码，可以执行如下命令编译及运行：

xmake b mem
xmake r mem -t 4 -s

mo_relaxed    mo_consume    mo_acquire 
mo_release    mo_acq_rel    mo_seq_cst

int i = 0;
uint64 u = 0;
atomic_inc(&i, mo_relaxed);
atomic_load(&i, mo_relaxed);
atomic_add(&u, 3); // mo_seq_cst
atomic_add(&u, 7, mo_acquire);

#include "co/flag.h"
#include "co/log.h"
#include "co/co.h"

int main(int argc, char** argv) {
    flag::init(argc, argv);
    log::init();
    co::init();
    // do something here...
    co::exit();
    return 0;
}

#include "co/flag.h"

int main(int argc, char** argv) {
    flag::init(argc, argv);
    // do something here...
    return 0;
}

DEF_bool(debug, false, "");         // no alias
DEF_bool(debug, false, "", d);      // d is an alias of debug
DEF_bool(debug, false, "", d, dbg); // 2 aliases

#include "co/log.h"

int main(int argc, char** argv) {
    flag::init(argc, argv);

    DLOG << "hello " << 23; // debug
    LOG << "hello " << 23;  // info
    WLOG << "hello " << 23; // warning
    ELOG << "hello " << 23; // error
    FLOG << "hello " << 23; // fatal
    TLOG("rpc") << "hello " << 23;
    TLOG("xxx") << "hello " << 23;

    return 0;
}

// {"a":23,"b":false,"s":"123","v":[1,2,3],"o":{"xx":0}}
Json x = {
    { "a", 23 },
    { "b", false },
    { "s", "123" },
    { "v", {1,2,3} },
    { "o", {
        {"xx", 0}
    }},
};

// equal to x
Json y = Json()
    .add_member("a", 23)
    .add_member("b", false)
    .add_member("s", "123")
    .add_member("v", Json().push_back(1).push_back(2).push_back(3))
    .add_member("o", Json().add_member("xx", 0));

x.get("a").as_int();       // 23
x.get("s").as_string();    // "123"
x.get("s").as_int();       // 123, string -> int
x.get("v", 0).as_int();    // 1
x.get("v", 2).as_int();    // 3
x.get("o", "xx").as_int(); // 0

x["a"] == 23;          // true
x["s"] == "123";       // true
x.get("o", "xx") != 0; // false

#include "co/all.h"

int main(int argc, char** argv) {
    flag::init(argc, argv);

    rpc::Server()
        .add_service(new xx::HelloWorldImpl)
        .start("127.0.0.1", 7788, "/xx");

    for (;;) sleep::sec(80000);
    return 0;
}

curl http://127.0.0.1:7788/xx --request POST --data '{"api":"ping"}'
curl http://127.0.0.1:7788/xx --request POST --data '{"api":"HelloWorld.hello"}'