Enum By 

pub enum By {
    Person(String),
    Session(Who),
    SignIn(String),
    Server,
    Other,
}

Who caused a record: the caller of its command, with its class (01M3X4Z60G1FXQTDC5XDJ05BAX). It holds only the user and the session ID. The session in a change is a full URI, with the place.

Caller	JSON
a person	{"person":"mike"}
a session	{"session":"mike/a6cf"}
a sign-in	{"sign_in":"mike@comotechnologies.io"}
the server	"server"

The set of classes can grow. A build reads a class that it does not know as By::Other.

use riff_core::name::Who;
use riff_core::record::By;

let session = By::Session(Who::new("mike", Some("a6cf"))?);
assert_eq!(serde_json::to_string(&session).unwrap(), r#"{"session":"mike/a6cf"}"#);
assert_eq!(serde_json::to_string(&By::Server).unwrap(), r#""server""#);
assert_eq!(session.to_string(), "the session mike/a6cf");

let read = |json: &str| serde_json::from_str::<By>(json).unwrap();
assert_eq!(read(r#"{"person":"mike"}"#), By::Person("mike".into()));
assert_eq!(read(r#"{"session":"mike/a6cf"}"#), session);
assert_eq!(read(r#""server""#), By::Server);
// A class of a later build.
assert_eq!(read(r#"{"robot":"r2"}"#), By::Other);
assert_eq!(read(r#""cron""#), By::Other);

Variants

Person(String)

A person, by the user.

Session(Who)

An agent session, by the user and the session ID.

SignIn(String)

A verified email of the provider, before a token is there.

Server

A timer of riff-server.

Other

A class that this build does not know.

Implementations

impl By

pub fn json(&self) -> Value

The class and the name as a JSON value: the form in a record and in a log line.

Trait Implementations

impl Clone for By

fn clone(&self) -> By

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for By

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for By

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<By, D::Error>

Deserialize this value from the given Serde deserializer.

impl Display for By

The caller for people, for example the session mike/a6cf.

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

Formats the value using the given formatter.

impl JsonSchema for By

The schema takes each value: By reads a class that it does not know as By::Other.

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn json_schema(_: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

impl PartialEq for By

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for By

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl Eq for By

impl StructuralPartialEq for By