Struct EnginePlayStats 

pub struct EnginePlayStats {

    pub report_id: String,
    pub game_id: Option<String>,
    pub engine: String,
    pub client_version: String,
    pub platform: String,
    pub format: Option<String>,
    pub seats: u32,
    pub multiplayer: bool,
    pub duration_s: u32,
    pub end_reason: String,
    pub turnaround: EngineTurnaround,
    pub reply_wait: Option<EngineTurnaround>,
    pub client_work: Option<EngineTurnaround>,
    pub engine_think: Option<EngineTurnaround>,
    pub engine_think_same_turn: Option<EngineTurnaround>,
    pub engine_think_cross_turn: Option<EngineTurnaround>,
    pub engine_think_bot: Option<EngineTurnaround>,
    pub engine_think_rules: Option<EngineTurnaround>,
    pub think_samples_hidden: u32,
    pub by_type: Vec<EngineTypeTurnaround>,
}

Fields

report_id: String

Generated by the client, so a retry cannot double-count the game.

game_id: Option<String>

Which game these timings belong to: the relay’s game_id for a relay game, and OfflinePlayGame::report_id for an offline one. Without it a report is an orphan: the timings are there, but nothing says what was played, who won, or how it ended.

It points at a record that names players. The report itself stays anonymous, and erasure reaches the record it points at by handle, so the id survives a scrub while what it leads to no longer names anyone.

engine: String

Which engine actually ran, which is not always the one the room asked for: a browser with the Forge engine on hosts a “Manabrew” room on it.

client_version: String

platform: String

format: Option<String>

seats: u32

multiplayer: bool

duration_s: u32

end_reason: String

turnaround: EngineTurnaround

Client-side turnaround: answer sent to next prompt landing. This is the interval the player feels, and the one comparable across engines.

reply_wait: Option<EngineTurnaround>

turnaround cut at the first reply frame reaching the client. reply_wait is everything outside the player’s machine: the server, the wire, and the transfer of the reply. client_work is everything on it: parsing, applying the state, rendering, until the prompt is handled. Absent from clients that predate the cut and from engines with no frame boundary to stamp.

client_work: Option<EngineTurnaround>

engine_think: Option<EngineTurnaround>

The engine’s own think time, when it reports one.

engine_think_same_turn: Option<EngineTurnaround>

engine_think split by whether an opponent turn happened inside the window. A window is answer-received to next-prompt-ready, so in a game against the AI the cross-turn half carries whole opponent turns and is not a measure of one decision.

engine_think_cross_turn: Option<EngineTurnaround>

engine_think_bot: Option<EngineTurnaround>

engine_think split by who owned the time: the part of each window spent on bot prompts, and the rest, which is the rules engine resolving what the table did. Absent from an engine that does not tag its windows.

engine_think_rules: Option<EngineTurnaround>

think_samples_hidden: u32

Windows dropped because the tab was backgrounded for part of them: the engine times itself in wall clock, which keeps running while the worker is descheduled.

by_type: Vec<EngineTypeTurnaround>

Implementations

impl EnginePlayStats

pub fn is_plausible(&self) -> bool

Whether this is worth storing. Rejects the shapes a mistake or a hostile client produces: an unparseable id, empty or oversized text, a table with impossible seats, a report of no decisions at all.

pub fn linked_game_id(&self) -> Option<&str>

The game this report belongs to, when the id is one a store can key on. A bad id costs the link, never the report: the timings are the point, and dropping a whole game over a malformed field is how telemetry ends up measuring nothing.

Trait Implementations

impl Clone for EnginePlayStats

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for EnginePlayStats

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for EnginePlayStats

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for EnginePlayStats

impl PartialEq for EnginePlayStats

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for EnginePlayStats

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for EnginePlayStats

impl TS for EnginePlayStats

type WithoutGenerics = EnginePlayStats

If this type does not have generic parameters, then WithoutGenerics should just be Self. If the type does have generic parameters, then all generic parameters must be replaced with a dummy type, e.g ts_rs::Dummy or (). The only requirement for these dummy types is that EXPORT_TO must be None.

fn ident() -> String

Identifier of this type, excluding generic parameters.

fn name() -> String

Name of this type in TypeScript, including generic parameters

fn decl_concrete() -> String

Declaration of this type using the supplied generic arguments. The resulting TypeScript definition will not be generic. For that, see TS::decl(). If this type is not generic, then this function is equivalent to TS::decl().

fn decl() -> String

Declaration of this type, e.g. type User = { user_id: number, ... }. This function will panic if the type has no declaration.

fn inline() -> String

Formats this types definition in TypeScript, e.g { user_id: number }. This function will panic if the type cannot be inlined.

fn inline_flattened() -> String

Flatten a type declaration.
This function will panic if the type cannot be flattened.

fn visit_generics(v: &mut impl TypeVisitor)

where Self: 'static,

Iterates over all type parameters of this type.

fn output_path() -> Option<&'static Path>

Returns the output path to where T should be exported.
The returned path does not include the base directory from TS_RS_EXPORT_DIR.

fn visit_dependencies(v: &mut impl TypeVisitor)

where Self: 'static,

Iterates over all dependency of this type.

const DOCS: Option<&'static str> = None

JSDoc comment to describe this type in TypeScript - when TS is derived, docs are automatically read from your doc comments or #[doc = ".."] attributes

fn dependencies() -> Vec<Dependency>

where Self: 'static,

Resolves all dependencies of this type recursively.

fn export() -> Result<(), ExportError>

where Self: 'static,

Manually export this type to the filesystem. To export this type together with all of its dependencies, use TS::export_all.

fn export_all() -> Result<(), ExportError>

where Self: 'static,

Manually export this type to the filesystem, together with all of its dependencies.
To export only this type, without its dependencies, use TS::export.

fn export_all_to(out_dir: impl AsRef<Path>) -> Result<(), ExportError>

where Self: 'static,

Manually export this type into the given directory, together with all of its dependencies.
To export only this type, without its dependencies, use TS::export.

fn export_to_string() -> Result<String, ExportError>

where Self: 'static,

Manually generate bindings for this type, returning a String.
This function does not format the output, even if the format feature is enabled.

fn default_output_path() -> Option<PathBuf>

Returns the output path to where T should be exported.