libTS3 基础库
=================

[![Build Status](https://travis-ci.org/kjx98/libts-rust.svg?branch=main)](
https://travis-ci.org/kjx98/libts-rust)

## 一、基本说明
* libTS3 是 Jesse Kuang 独力开发的「rust 跨平台交易基础设施」程序库，移植c++版本libts
* 使用 rust (edition 2021 compatible as possible)
	* Windows: 
	* Linux:
		* rustc 1.58 or newer
* 跨平台Linux优先，但不支持老旧的OS
* 仅考虑 64 位平台
* 字符串仅支持 UTF8，source file 也使用 UTF8 编码。GBK应转码
* Why libts3? 在众多 open source 的情况下，为何还要libts3？
	* 追求速度
		* std 、 tokio 非常好，但速度不是他们追求的。
		* 当 **速度** 与 **通用性** 需要取舍时，libts3 选择 **速度**。
		* 当 **速度** 与 **内存RAM用量** 需要取舍时，libts3 选择 **速度**。
			* libts3 会权衡 大量的RAM 造成 CPU cache missing，速度不一定会变快。
		* 速度问题分成2类: Low latency、High throughtput，当2者有冲突时，尽量选择 **Low latency**。
	* 降低第3方的依赖。
	* 更符合自己的需求。
		* 许多第3方的 library，速度很快、功能强大，但也远超过我的需求。
		* 我个人倾向于：设计到刚好满足自己的需求就好。

### 准备工作
主要开发工具及版本
* Linux: AlmaLinux 8.5 w/ rustup
	* cargo test, rustfmt, clippy
* Windows:
	* cargo test, rustfmt, clippy
* 开启 compiler 全部的警告信息：警告信息的重要性，相信不用再提醒了。
	* 警告信息 -- 零容忍。
* UnitTest tools
    * rust 内置 test
    * bencher crates


## 二、支持库
  julian 儒略日， message 消息包抽象，serde 实现简单类型的序列化与反序列化，timestamp 低延迟微秒/纳秒级计时与时间戳，priceType针对价格及金额的定点与浮点double的互换

### julian
  儒略日数（Julian Day Number，JDN）的计算是从格林威治标准时间的中午开始，包含一个整天的时间，起点的时间（0日）回溯至儒略历的公元前4713年1月1日中午12点（在格里历是公元前4714年11月24日），这个日期是三种多年周期的共同起点，且是历史上最接近现代的一个起点。
  unix 纪元1970年1月1日， julian 日为2440588。采用julian日， 一个16位整数即可表示约180年，而且计算星期几只需要取7的余数即可（即0表示周一，6表示周日）

### serde
  简单序列化与反序列化，采用Little Endian（即小端编码，Intel/ARM64的CPU整数字节编码），字符串string以及字节串Bytes采用Pascal编码（长度0...255）以一字节表示长度后续bytes
  暂不支持Rust enum及其派生类型，完美支持tuple/struct类型

### timestamp
  timeval类 简单包封timespec结构并采用u64/u32 表示秒以及纳秒
  sysclock类 用于重演/模拟环境的系统时钟
  timestamp 抽象毫秒/微秒/纳秒级别时间戳
  DateTime 抽象 毫秒/微秒/纳秒级别 的日期时间点

### priceType
  定点数与浮点double的相互转换

### Mmap
  支持大页的共享内存mmap

### pitch proto
  类似ITCH的逐笔行情协议，在ThinkPad T440s实现每秒超两千五百万笔行情解码。

### Math
formula: $ f(x) = \int_{-\infty}^\infty \hat f(\xi)e^{2 \pi \xi x}d\xi $