hikyuu 2.2.2__py3-none-win_amd64.whl

hikyuu/include/hikyuu/trade_manage/BorrowRecord.h

@@ -0,0 +1,91 @@
+/*
+ * BorrowRecord.h
+ *
+ *  Created on: 2013-5-2
+ *      Author: fasiondog
+ */
+
+#pragma once
+#ifndef BORROWRECORD_H_
+#define BORROWRECORD_H_
+
+#include "../DataType.h"
+#include "../serialization/Stock_serialization.h"
+#include "../serialization/Datetime_serialization.h"
+
+namespace hku {
+
+/**
+ * 记录当前借入的股票信息
+ * @ingroup TradeManagerClass
+ */
+class HKU_API BorrowRecord {
+public:
+    BorrowRecord();
+    BorrowRecord(const Stock&, double number, price_t value);
+
+    Stock stock;
+    double number;  // 借入总数量
+    price_t value;  // 借入总价值
+
+    struct Data {
+        Data() : datetime(Null<Datetime>()), price(0.0), number(0) {}
+        Data(const Datetime& datetime, price_t price, double number)
+        : datetime(datetime), price(price), number(number) {}
+
+        Datetime datetime;  // 借入时间
+        price_t price;      // 借入时的单价
+        double number;      // 借入数量
+
+#if HKU_SUPPORT_SERIALIZATION
+    private:
+        friend class boost::serialization::access;
+        template <class Archive>
+        void save(Archive& ar, const unsigned int version) const {
+            uint64_t datetime_num = datetime.number();
+            ar& boost::serialization::make_nvp("datetime", datetime_num);
+            ar& BOOST_SERIALIZATION_NVP(number);
+            ar& BOOST_SERIALIZATION_NVP(price);
+        }
+
+        template <class Archive>
+        void load(Archive& ar, const unsigned int version) {
+            uint64_t datetime_num;
+            ar& boost::serialization::make_nvp("datetime", datetime_num);
+            datetime = Datetime(datetime_num);
+            ar& BOOST_SERIALIZATION_NVP(number);
+            ar& BOOST_SERIALIZATION_NVP(price);
+        }
+
+        BOOST_SERIALIZATION_SPLIT_MEMBER()
+#endif
+    };
+
+    list<Data> record_list;  // 当前的借入记录
+
+// 序列化支持
+#if HKU_SUPPORT_SERIALIZATION
+private:
+    friend class boost::serialization::access;
+    template <class Archive>
+    void serialize(Archive& ar, const unsigned int version) {
+        ar& BOOST_SERIALIZATION_NVP(stock);
+        ar& BOOST_SERIALIZATION_NVP(number);
+        ar& BOOST_SERIALIZATION_NVP(value);
+        ar& BOOST_SERIALIZATION_NVP(record_list);
+    }
+#endif
+};
+
+typedef vector<BorrowRecord> BorrowRecordList;
+
+HKU_API std::ostream& operator<<(std::ostream&, const BorrowRecord&);
+
+} /* namespace hku */
+
+#if FMT_VERSION >= 90000
+template <>
+struct fmt::formatter<hku::BorrowRecord> : ostream_formatter {};
+#endif
+
+#endif /* BORROWRECORD_H_ */

hikyuu/include/hikyuu/trade_manage/CostRecord.h

@@ -0,0 +1,67 @@
+/*
+ * CostRecord.h
+ *
+ *  Created on: 2013-2-13
+ *      Author: fasiondog
+ */
+
+#pragma once
+#ifndef COSTRECORD_H_
+#define COSTRECORD_H_
+
+#include "../DataType.h"
+#include "../config.h"
+
+namespace hku {
+
+/**
+ * 成本记录
+ * @details 总成本 = 佣金 + 印花税 + 过户费 + 其他费用
+ * @note 该结构主要用于存放成本记录结果，一般当做struct直接使用，
+ *       该类本身不对总成本进行计算，也不保证上面的公式成立
+ * @ingroup TradeCost
+ */
+class HKU_API CostRecord {
+public:
+    CostRecord();
+    CostRecord(price_t commission, price_t stamptax, price_t transferfee, price_t others,
+               price_t total);
+
+    price_t commission;  /**< 佣金     */
+    price_t stamptax;    /**< 印花税   */
+    price_t transferfee; /**< 过户费   */
+    price_t others;      /**< 其他费用 */
+    price_t total;       /**< 总成本   */
+
+    string toString() const;
+
+#if HKU_SUPPORT_SERIALIZATION
+private:
+    friend class boost::serialization::access;
+    template <class Archive>
+    void serialize(Archive& ar, const unsigned int version) {
+        ar& BOOST_SERIALIZATION_NVP(commission);
+        ar& BOOST_SERIALIZATION_NVP(stamptax);
+        ar& BOOST_SERIALIZATION_NVP(transferfee);
+        ar& BOOST_SERIALIZATION_NVP(others);
+        ar& BOOST_SERIALIZATION_NVP(total);
+    }
+#endif /* HKU_SUPPORT_SERIALIZATION */
+};
+
+/**
+ * 输出成本信息
+ * @ingroup TradeCost
+ */
+HKU_API std::ostream& operator<<(std::ostream& os, const CostRecord&);
+
+bool HKU_API operator==(const CostRecord& d1, const CostRecord& d2);
+
+} /* namespace hku */
+
+#if FMT_VERSION >= 90000
+template <>
+struct fmt::formatter<hku::CostRecord> : ostream_formatter {};
+#endif
+
+#endif /* COSTRECORD_H_ */

hikyuu/include/hikyuu/trade_manage/FundsRecord.h

@@ -0,0 +1,110 @@
+/*
+ * FundsRecord.h
+ *
+ *  Created on: 2013-5-2
+ *      Author: fasiondog
+ */
+
+#pragma once
+#ifndef FUNDSRECORD_H_
+#define FUNDSRECORD_H_
+
+#include "../DataType.h"
+#include "../config.h"
+
+namespace hku {
+
+/**
+ * 当前资产情况记录，由TradeManager::getFunds返回
+ * @ingroup TradeManagerClass
+ */
+class HKU_API FundsRecord {
+public:
+    FundsRecord() = default;
+    FundsRecord(price_t cash, price_t market_value, price_t short_market_value, price_t base_cash,
+                price_t base_asset, price_t borrow_cash, price_t borrow_asset);
+
+    price_t cash{0.0};               /**< 当前现金 */
+    price_t market_value{0.0};       /**< 当前多头市值 */
+    price_t short_market_value{0.0}; /**< 当前空头仓位市值 */
+    price_t base_cash{0.0};          /**< 当前投入本金principal */
+    price_t base_asset{0.0};         /**< 当前投入的资产价值 */
+    price_t borrow_cash{0.0};        /**< 当前借入的资金，即负债 */
+    price_t borrow_asset{0.0};       /**< 当前借入证券资产价值 */
+
+    // 当前总资产 = 现金 + 多头市值 + 空头数量×（借入价格 - 当前价格)
+    //          = cash + market_value + borrow_asset - short_market_value
+    // 当前负债 = 借入的资金 + 借入的资产价值
+    //         = borrow_cash + borrow_asset
+    // 当前净资产 = 总资产 - 负债
+    //          = cash + market_value - short_market_value - borrow_cash
+    // 当前投入本值资产 = 投入本金 + 投入资产价值
+    //                = base_cash + base_asset
+    // 当前收益 = 当前净资产 - 当前投入本值资产
+    //         = cash + market_value - short_market_value - borrow_cash - base_cash - base_asset
+
+    // 当前总资产
+    price_t total_assets() const {
+        return cash + market_value + borrow_asset - short_market_value;
+    }
+
+    // 当前净资产
+    price_t net_assets() const {
+        return cash + market_value - short_market_value - borrow_cash;
+    }
+
+    // 总负债
+    price_t total_borrow() const {
+        return borrow_cash + borrow_asset;
+    }
+
+    // 当前投入本值资产
+    price_t total_base() const {
+        return base_cash + base_asset;
+    }
+
+    // 当前收益
+    price_t profit() const {
+        return cash + market_value - short_market_value - borrow_cash - base_cash - base_asset;
+    }
+
+    FundsRecord operator+(const FundsRecord& other) const;
+
+    FundsRecord& operator+=(const FundsRecord& other);
+
+    // 序列化支持
+#if HKU_SUPPORT_SERIALIZATION
+private:
+    friend class boost::serialization::access;
+    template <class Archive>
+    void serialize(Archive& ar, const unsigned int version) {
+        ar& BOOST_SERIALIZATION_NVP(cash);
+        ar& BOOST_SERIALIZATION_NVP(market_value);
+        ar& BOOST_SERIALIZATION_NVP(short_market_value);
+        ar& BOOST_SERIALIZATION_NVP(base_cash);
+        ar& BOOST_SERIALIZATION_NVP(base_asset);
+        ar& BOOST_SERIALIZATION_NVP(borrow_cash);
+        ar& BOOST_SERIALIZATION_NVP(borrow_asset);
+    }
+#endif
+};
+
+typedef vector<FundsRecord> FundsList;
+typedef vector<FundsRecord> FundsRecordList;
+
+/**
+ * 输出TradeRecord信息
+ * @ingroup TradeManagerClass
+ */
+HKU_API std::ostream& operator<<(std::ostream&, const FundsRecord&);
+
+bool HKU_API operator==(const FundsRecord& d1, const FundsRecord& d2);
+
+} /* namespace hku */
+
+#if FMT_VERSION >= 90000
+template <>
+struct fmt::formatter<hku::FundsRecord> : ostream_formatter {};
+#endif
+
+#endif /* FUNDSRECORD_H_ */

hikyuu/include/hikyuu/trade_manage/LoanRecord.h

@@ -0,0 +1,64 @@
+/*
+ * LoanRecord.h
+ *
+ *  Created on: 2013-5-24
+ *      Author: fasiondog
+ */
+
+#pragma once
+#ifndef LOANRECORD_H_
+#define LOANRECORD_H_
+
+#include "../DataType.h"
+#include "../config.h"
+
+namespace hku {
+
+/**
+ * 借款记录（融资记录）
+ * @ingroup TradeManagerClass
+ */
+class HKU_API LoanRecord {
+public:
+    LoanRecord() : datetime(Null<Datetime>()), value(0.0) {}
+    LoanRecord(const Datetime& datetime, price_t value) : datetime(datetime), value(value) {}
+
+    Datetime datetime;
+    price_t value;
+
+#if HKU_SUPPORT_SERIALIZATION
+private:
+    friend class boost::serialization::access;
+    template <class Archive>
+    void save(Archive& ar, const unsigned int version) const {
+        namespace bs = boost::serialization;
+        hku::uint64_t date_number = datetime.number();
+        ar& bs::make_nvp("datetime", date_number);
+        ar& BOOST_SERIALIZATION_NVP(value);
+    }
+
+    template <class Archive>
+    void load(Archive& ar, const unsigned int version) {
+        namespace bs = boost::serialization;
+        hku::uint64_t date_number;
+        ar& bs::make_nvp("datetime", date_number);
+        datetime = Datetime(date_number);
+        ar& BOOST_SERIALIZATION_NVP(value);
+    }
+
+    BOOST_SERIALIZATION_SPLIT_MEMBER()
+#endif
+};
+
+typedef vector<LoanRecord> LoanRecordList;
+
+HKU_API std::ostream& operator<<(std::ostream&, const LoanRecord&);
+
+} /* namespace hku */
+
+#if FMT_VERSION >= 90000
+template <>
+struct fmt::formatter<hku::LoanRecord> : ostream_formatter {};
+#endif
+
+#endif /* LOANRECORD_H_ */

hikyuu/include/hikyuu/trade_manage/OrderBrokerBase.h

@@ -0,0 +1,182 @@
+/*
+ * OrderBrokerBase.h
+ *
+ *  Created on: 2017年6月28日
+ *      Author: fasiondog
+ */
+
+#pragma once
+#ifndef TRADE_MANAGE_ORDERBROKERBASE_H_
+#define TRADE_MANAGE_ORDERBROKERBASE_H_
+
+#include "../DataType.h"
+#include "../utilities/Parameter.h"
+#include "../trade_sys/system/SystemPart.h"
+
+namespace hku {
+
+struct HKU_API BrokerPositionRecord {
+    Stock stock;
+    price_t number{0.0};  // 数量
+    price_t money{0.0};   // 买入花费总资金
+
+    BrokerPositionRecord() = default;
+    BrokerPositionRecord(const Stock& stock, price_t number, price_t money);
+    BrokerPositionRecord(const BrokerPositionRecord&) = default;
+    BrokerPositionRecord(BrokerPositionRecord&& rv);
+
+    BrokerPositionRecord& operator=(const BrokerPositionRecord&) = default;
+    BrokerPositionRecord& operator=(BrokerPositionRecord&& rv);
+
+    string str() const;
+};
+
+HKU_API std::ostream& operator<<(std::ostream& os, const BrokerPositionRecord&);
+
+/**
+ * 订单代理基类，实现实际的订单操作及程序化的订单。
+ * @details 可通过向 TradeManager.regBroker 向 TradeManager 注册多个订单代理实例。
+ *          这些订单代理可执行额外的买入/卖出动作，如邮件订单代理，在 TradeManager 发出
+ *          买入/卖出指令时， 邮件订单代理可以发送邮件。
+ *
+ *          默认情况下，TradeManager会在执行买入/卖出操作时，调用订单代理执行代理的买入/卖出动作，
+ *          但这样在实盘操作时会存在问题。因为系统在计算信号指示时，需要回溯历史数据才能得到最新的信号，
+ *          这样TradeManager会在历史时刻就执行买入/卖出操作。此时如果订单代理本身没有对发出
+ *          买入/卖出指令的时刻进行控制，会导致代理发送错误的指令 。因此，需要指定在某一个时刻之后，
+ *          才允许执行订单代理的买入/卖出操作。TradeManager的属性 brokeLastDatetime 即用于
+ *          指定该时刻。
+ * @ingroup OrderBroker
+ */
+class HKU_API OrderBrokerBase {
+    PARAMETER_SUPPORT
+
+public:
+    OrderBrokerBase();
+    OrderBrokerBase(const string& name);
+    virtual ~OrderBrokerBase();
+
+    /** 获取名称 */
+    const string& name() const;
+
+    /** 设置名称 */
+    void name(const string& name);
+
+    /**
+     * 执行买入操作
+     * @param datetime 策略指示时间
+     * @param market 市场标识
+     * @param code 证券代码
+     * @param price 买入价格
+     * @param num 买入数量
+     * @param stoploss 预期的止损价
+     * @param goalPrice 预期的目标价位
+     * @param from 系统部件来源
+     */
+    void buy(Datetime datetime, const string& market, const string& code, price_t price, double num,
+             price_t stoploss, price_t goalPrice, SystemPart from) noexcept;
+
+    /**
+     * 执行卖出操作
+     * @param datetime 策略指示时间
+     * @param market 市场标识
+     * @param code 证券代码
+     * @param price 卖出价格
+     * @param num 卖出数量
+     * @param stoploss 新的预期止损价
+     * @param goalPrice 新的预期目标价位
+     * @param from 系统部件来源
+     */
+    void sell(Datetime datetime, const string& market, const string& code, price_t price,
+              double num, price_t stoploss, price_t goalPrice, SystemPart from) noexcept;
+
+    /**
+     * 获取当前资产信息
+     * @return string json字符串
+     * <pre>
+     * 接口规范：
+     * {
+     *   "datetime": "2001-01-01 18:00:00.12345",
+     *   "cash": 0.0,
+     *   "positions": [
+     *       {"market": "SZ", "code": "000001", "number": 100.0, "stoploss": 0.0, "goal_price": 0.0,
+     *        "cost_price": 0.0},
+     *       {"market": "SH", "code": "600001", "number": 100.0, "stoploss": 0.0, "goal_price": 0.0,
+     *        "cost_price": 0.0},
+     *    ]
+     * }
+     *
+     * 说明：
+     * cash: 当前可用资金
+     * number 应该为：现有持仓 + 正在买入 - 正在卖出
+     * cost_price: 每股买入成本价
+     * </pre>
+     */
+    string getAssetInfo() noexcept;
+
+    /**
+     * 子类实现接口，执行实际买入操作
+     * @param datetime 策略指示时间
+     * @param market 市场标识
+     * @param code 证券代码
+     * @param price 买入价格
+     * @param num 买入数量
+     * @param stoploss 预期的止损价
+     * @param goalPrice 预期的目标价位
+     * @param from 系统部件来源
+     */
+    virtual void _buy(Datetime datetime, const string& market, const string& code, price_t price,
+                      double num, price_t stoploss, price_t goalPrice, SystemPart from) = 0;
+
+    /**
+     * 子类实现接口，执行实际卖出操作
+     * @param datetime 策略指示时间
+     * @param market 市场标识
+     * @param code 证券代码
+     * @param price 卖出价格
+     * @param num 卖出数量
+     * @param stoploss 新预期的止损价
+     * @param goalPrice 新预期的目标价位
+     * @param from 系统部件来源
+     */
+    virtual void _sell(Datetime datetime, const string& market, const string& code, price_t price,
+                       double num, price_t stoploss, price_t goalPrice, SystemPart from) = 0;
+
+    virtual string _getAssetInfo() {
+        return string();
+    }
+
+protected:
+    string m_name;
+};
+
+/**
+ * 客户程序应使用此类型进行实际操作
+ * @ingroup OrderBroker
+ */
+typedef shared_ptr<OrderBrokerBase> OrderBrokerPtr;
+
+/** @ingroup OrderBroker */
+HKU_API std::ostream& operator<<(std::ostream& os, const OrderBrokerBase&);
+
+/** @ingroup OrderBroker */
+HKU_API std::ostream& operator<<(std::ostream& os, const OrderBrokerPtr&);
+
+inline const string& OrderBrokerBase::name() const {
+    return m_name;
+}
+
+inline void OrderBrokerBase::name(const string& name) {
+    m_name = name;
+}
+
+} /* namespace hku */
+
+#if FMT_VERSION >= 90000
+template <>
+struct fmt::formatter<hku::OrderBrokerBase> : ostream_formatter {};
+
+template <>
+struct fmt::formatter<hku::OrderBrokerPtr> : ostream_formatter {};
+#endif
+
+#endif /* TRADE_MANAGE_ORDERBROKERBASE_H_ */

hikyuu/include/hikyuu/trade_manage/Performance.h

@@ -0,0 +1,80 @@
+/*
+ * Performance.h
+ *
+ *  Created on: 2013-4-23
+ *      Author: fasiondog
+ */
+
+#pragma once
+#ifndef PERFORMANCE_H_
+#define PERFORMANCE_H_
+
+#include <boost/function.hpp>
+#include "TradeManager.h"
+
+namespace hku {
+
+/**
+ * 简单绩效统计
+ * @ingroup Performance
+ */
+class HKU_API Performance {
+public:
+    Performance();
+    virtual ~Performance();
+
+    Performance(const Performance& other) : m_result(other.m_result) {}
+    Performance(Performance&& other) : m_result(std::move(other.m_result)) {}
+
+    Performance& operator=(const Performance& other);
+    Performance& operator=(Performance&& other);
+
+    /** 是否为合法的统计项 */
+    static bool exist(const string& key);
+
+    /** 复位，清除已计算的结果 */
+    void reset();
+
+    /** 按指标名称获取指标值，必须在运行 statistics 或 report 之后生效  */
+    double get(const string& name) const;
+
+    /** 同 get */
+    double operator[](const string& name) const {
+        return get(name);
+    }
+
+    /**
+     * 简单的文本统计报告，用于直接输出打印
+     * @param tm
+     * @param datetime 指定的截止时刻
+     * @return
+     */
+    string report(const TradeManagerPtr& tm, const Datetime& datetime = Datetime::now());
+
+    /**
+     * 根据交易记录，统计截至某一时刻的系统绩效, datetime必须大于等于lastDatetime，
+     * 以便用于计算当前市值
+     * @param tm 指定的交易管理实例
+     * @param datetime 统计截止时刻
+     */
+    void statistics(const TradeManagerPtr& tm, const Datetime& datetime = Datetime::now());
+
+    /** 获取所有统计项名称，顺序与 values 相同 */
+    const StringList& names() const {
+        return ms_keys;
+    }
+
+    /** 获取所有统计项值，顺序与 names 相同*/
+    PriceList values() const;
+
+    typedef std::map<string, double> map_type;
+    typedef map_type::iterator iterator;
+    typedef map_type::const_iterator const_iterator;
+
+private:
+    map_type m_result;
+    static StringList ms_keys;  // 保存统计项顺序, map/unordered_map都不能保持按插入顺序遍历
+};
+
+} /* namespace hku */
+#endif /* PERFORMANCE_H_ */

hikyuu/include/hikyuu/trade_manage/PositionRecord.h

@@ -0,0 +1,108 @@
+/*
+ * PositionRecord.h
+ *
+ *  Created on: 2013-2-21
+ *      Author: fasiondog
+ */
+
+#pragma once
+#ifndef POSITIONRECORD_H_
+#define POSITIONRECORD_H_
+
+#include "../StockManager.h"
+#include "../serialization/Stock_serialization.h"
+
+namespace hku {
+
+/**
+ * 持仓记录
+ * @ingroup TradeManagerClass
+ */
+class HKU_API PositionRecord {
+public:
+    PositionRecord();
+    PositionRecord(const Stock& stock, const Datetime& takeDatetime, const Datetime& cleanDatetime,
+                   double number, price_t stoploss, price_t goalPrice, double totalNumber,
+                   price_t buyMoney, price_t totalCost, price_t totalRisk, price_t sellMoney);
+
+    /** 仅用于python的__str__ */
+    string str() const;
+
+    Stock stock;              ///< 交易对象
+    Datetime takeDatetime;    ///< 初次建仓日期
+    Datetime cleanDatetime;   ///< 平仓日期，当前持仓记录中为Null<Datetime>()
+    double number{0.0};       ///< 当前持仓数量
+    price_t stoploss{0.0};    ///< 当前止损价
+    price_t goalPrice{0.0};   ///< 当前的目标价格
+    double totalNumber{0.0};  ///< 累计持仓数量
+    price_t buyMoney{0.0};    ///< 累计买入资金
+    price_t totalCost{0.0};   ///< 累计交易总成本
+    price_t totalRisk{0.0};  ///< 累计交易风险 = 各次 （买入价格-止损)*买入数量, 不包含交易成本
+    price_t sellMoney{0.0};  ///< 累计卖出资金
+
+//===================
+// 序列化支持
+//===================
+#if HKU_SUPPORT_SERIALIZATION
+private:
+    friend class boost::serialization::access;
+    template <class Archive>
+    void save(Archive& ar, const unsigned int version) const {
+        namespace bs = boost::serialization;
+        ar& BOOST_SERIALIZATION_NVP(stock);
+        uint64_t take = takeDatetime.number();
+        uint64_t clean = cleanDatetime.number();
+        ar& bs::make_nvp("takeDatetime", take);
+        ar& bs::make_nvp("cleanDatetime", clean);
+        ar& BOOST_SERIALIZATION_NVP(number);
+        ar& BOOST_SERIALIZATION_NVP(stoploss);
+        ar& BOOST_SERIALIZATION_NVP(goalPrice);
+        ar& BOOST_SERIALIZATION_NVP(totalNumber);
+        ar& BOOST_SERIALIZATION_NVP(buyMoney);
+        ar& BOOST_SERIALIZATION_NVP(totalCost);
+        ar& BOOST_SERIALIZATION_NVP(totalRisk);
+        ar& BOOST_SERIALIZATION_NVP(sellMoney);
+    }
+
+    template <class Archive>
+    void load(Archive& ar, const unsigned int version) {
+        namespace bs = boost::serialization;
+        ar& BOOST_SERIALIZATION_NVP(stock);
+        uint64_t take, clean;
+        ar& bs::make_nvp("takeDatetime", take);
+        ar& bs::make_nvp("cleanDatetime", clean);
+        takeDatetime = Datetime(take);
+        cleanDatetime = Datetime(clean);
+        ar& BOOST_SERIALIZATION_NVP(number);
+        ar& BOOST_SERIALIZATION_NVP(stoploss);
+        ar& BOOST_SERIALIZATION_NVP(goalPrice);
+        ar& BOOST_SERIALIZATION_NVP(totalNumber);
+        ar& BOOST_SERIALIZATION_NVP(buyMoney);
+        ar& BOOST_SERIALIZATION_NVP(totalCost);
+        ar& BOOST_SERIALIZATION_NVP(totalRisk);
+        ar& BOOST_SERIALIZATION_NVP(sellMoney);
+    }
+
+    BOOST_SERIALIZATION_SPLIT_MEMBER()
+#endif /* HKU_SUPPORT_SERIALIZATION */
+};
+
+/** @ingroup TradeManagerClass */
+typedef vector<PositionRecord> PositionRecordList;
+
+/**
+ * 输出持仓记录信息
+ * @ingroup TradeManagerClass
+ */
+HKU_API std::ostream& operator<<(std::ostream&, const PositionRecord&);
+
+bool HKU_API operator==(const PositionRecord& d1, const PositionRecord& d2);
+
+} /* namespace hku */
+
+#if FMT_VERSION >= 90000
+template <>
+struct fmt::formatter<hku::PositionRecord> : ostream_formatter {};
+#endif
+
+#endif /* POSITIONRECORD_H_ */