PlayTrace.h

浏览该文件的文档.

#pragma once
 
#include "common/Export.h"
#include "common/Result.h"
#include "common/Value.h"
#include "devtools/PlayHost.h"
 
#include <cstdint>
#include <string>
#include <string_view>
 
namespace eve::dev {
 
[[nodiscard]] EVENGINE_API_FOUNDATION Result<std::string> playObservationDigest(const Value& state);
 
[[nodiscard]] EVENGINE_API_FOUNDATION Result<Value> parsePlayTrace(const Value& recording);
 
[[nodiscard]] EVENGINE_API_FOUNDATION Result<Value> replayPlayTrace(const Value& recording, IPlayHostRuntime& runtime);
 
class EVENGINE_API_FOUNDATION PlayReplayGuard final {
public:
    PlayReplayGuard();
    ~PlayReplayGuard();
    PlayReplayGuard(const PlayReplayGuard&)            = delete;
    PlayReplayGuard& operator=(const PlayReplayGuard&) = delete;
};
 
class EVENGINE_API_FOUNDATION PlayTraceBuffer final {
public:
    static PlayTraceBuffer& instance();
 
    void clear();
    [[nodiscard]] bool isReplaying() const { return replaying_; }
    void setReplaying(bool value) { replaying_ = value; }
    void begin(std::string contractId, std::string contractHash, std::int64_t seed,
               std::string startCheckpoint);
    void append(const Value& request, const Value& response, std::uint64_t hostFrame);
    [[nodiscard]] bool isRecording() const { return begun_; }
    [[nodiscard]] bool empty() const { return stepCount_ == 0; }
    [[nodiscard]] Value exportTrace() const;
 
private:
    PlayTraceBuffer() = default;
 
    std::string   contractId_;
    std::string   contractHash_;
    std::int64_t  seed_ = 0;
    std::string   startCheckpoint_;
    Value::Array  stepItems_;
    std::int64_t  stepCount_ = 0;
    bool          begun_ = false;
    bool          replaying_ = false;
};
 
}  // namespace eve::dev