Basic

--------------2------------ CO 是一个优雅、高效的 C++ 基础库，支持 Linux, Windows 与 Mac 平台。

CO 追求极简、高效，不依赖于 boost 等三方库，仅使用了少量 C++11 特性。

• CO 包含如下的功能组件：
  • 基本定义(def)
  • 原子操作(atomic)
  • 快速随机数生成器(ramdom)
  • LruMap
  • 基本类型快速转字符串(fast)
  • 高效字符流(fastream)
  • 高效字符串(fastring)
  • 字符串操作(str)
  • 命令行参数与配置文件解析库(flag)
  • 高效流式日志库(log)
  • 单元测试框架(unitest)
  • 时间库(time)
  • 线程库(thread)
  • 协程库(co)
  • 高效 json 库
  • 高性能 json rpc 框架
  • hash 库
  • path 库
  • 文件系统操作(fs)
  • 系统操作(os)

特别致谢

• co 协程库切换 context 的相关代码取自 ruki 的 tbox，特别表示感谢！

• co 英文参考文档，由 Leedehai 翻译，特别表示感谢！

参考文档

• English md
• 中文 md
• 中文 pdf

亮点功能

• flag

这是一个真正为程序员考虑的配置文件库，支持自动生成配置文件，支持整数类型带单位 k, m, g, t, p，不区分大小写。

• log

这是一个超级快的本地日志系统，直观感受一下:

log vs glog	google glog	co log
win2012 机械硬盘	1.6MB/s	180MB/s
win10 ssd	3.7MB/s	560MB/s
mac ssd	17MB/s	450MB/s
linux ssd	54MB/s	1023MB/s

上表是单线程连续打印 100w 条 info 日志(50 字节左右)的测试结果，co/log 几乎快了 glog 两个数量级。

为何如此快？一是 log 库内部基于比 sprintf 快 8-25 倍的 fastream 实现，二是 log 库几乎没有什么内存分配操作。

• json

这是一个速度堪比 rapidjson 的 json 库，如果使用 jemalloc，parse 与 stringify 的性能会进一步提升。

co/json 对 json 标准的支持不如 rapidjson 全面，但能满足程序员的基本需求，且更容易使用。

• co

这是一个 golang 风格的协程库，内置多线程调度，是网络编程之利器。

• json rpc

这是一个基于协程与 json 的高性能 rpc 框架，支持代码自动生成，简单易用，单线程 qps 能达到 12w+。

• Kakalot(卡卡洛特)

这是一个与 co::Pool 配套使用的模板类。co::Pool 是一个协程安全的池子，内部存储 void* 指针。

卡卡洛特构造时从 Pool 拉取一个指针，析构时将指针放回 Pool，同时，卡卡洛特还自带智能指针属性:

co::Pool p;

void f() {
    co::Kakalot<Redis> rds(p);         // 卡卡洛特现在变身为 Redis* 指针
    if (rds == NULL) rds = new Redis;  // 对卡卡洛特重新赋值
    rds->get("xx");                    // 卡卡洛特调用 redis 的 get 操作
}

go(f);

编译执行

CO 已将构建工具切换为 ruki 的 xmake，后续可能放弃 scons, vs project。

• 安装 xmake

windows 与 debian/ubuntu 可以直接去 xmake 的 release 页面下载安装包，其他系统请参考 xmake 的 Installation 说明。

xmake 在 linux 上默认禁止 root 用户编译，ruki 说 root 不安全，可以在 ~/.bashrc 中加上下面的一行，启用 root 编译:

export XMAKE_ROOT=y

• 编译 co/base 库

co/base 是 CO 提供的核心基础库，其他工具都依赖于 base 库。

# 在 co/lib 目录下生成 libbase.a 或 base.lib
cd co/base
xmake

• 编译 co/unitest

co/unitest 是单元测试代码，用于检验 base 库功能的正确性。

# 在 co/build 目录下生成可执行文件 unitest 或 unitest.exe
cd co/unitest/base
xmake

cd ../../build
./unitest -a      # 执行所有单元测试
./unitest -os     # 执行 os 单元测试
./unitest -json   # 执行 json 单元测试

• 编译 co/test

co/test 包含了一些测试代码。

# 在 co/build 目录下生成相应的可执行文件
cd co/test
xmake             # 编译 test 目录下的全部目标代码
xmake -b log      # 编译 log_test.cc
xmake -b flag     # 编译 flag_test.cc
xmake build flag  # 编译 flag_test.cc

cd ../build
./log.exe -perf   # log 库性能测试
./rpc.exe -c=0    # 启动 rpc server
./rpc.exe -c=1    # 启动 rpc client

• 编译 rpcgen

rpcgen 是 json rpc 的代码生成器，根据指定的 proto 文件，自动生成相应的代码。

# 在 co/build 目录下生成 rpcgen 或 rpcgen.exe
cd co/rpcgen
xmake

# 建议将 rpcgen 放到系统目录下(/usr/local/bin/).
# 有些 linux 系统自带了一个 rpcgen，为避免冲突，可能需要重命名 rpcgen.
rpcgen hello_world.proto

proto 文件格式可以参考 co/test/rpc/hello_world.proto。

贡献代码

1. co/base 目录下修改或新增代码，确保 base 库编译通过.
2. 若有必要，在 co/unitest/base 目录下修改或新增单元测试用例，确保单元测试全部通过.
3. 若有必要，在 co/test 目录下修改或新增测试代码.

友情合作

• 有问题请提交到 github.
• 赞助、商务合作请联系 idealvin@qq.com.
• 捐他一个亿！请用微信扫 co.pdf 中的二维码.