Struct Rating 

pub struct Rating {
    pub total_reviews: u64,
    pub total_rating: f64,
    pub last_rating: u8,
    pub max_rate: u8,
    pub min_rate: u8,
}

User reputation snapshot, suitable for publishing as Nostr tags.

The fields are the same aggregates stored on crate::user::User, but typed for transport (unsigned integers for counts, u8 for rating values).

Fields

total_reviews: u64

Total number of ratings received.

total_rating: f64

Weighted rating average across all reviews.

last_rating: u8

Most recent rating, in the MIN_RATING..=MAX_RATING range.

max_rate: u8

Highest rating ever received.

min_rate: u8

Lowest rating ever received.

Implementations

impl Rating

pub fn new( total_reviews: u64, total_rating: f64, last_rating: u8, min_rate: u8, max_rate: u8, ) -> Self

Construct a new Rating from its individual components.

pub fn from_json(json: &str) -> Result<Self, ServiceError>

Parse a Rating from its JSON representation.

Returns ServiceError::MessageSerializationError if json is not a valid serialization of this type.

pub fn as_json(&self) -> Result<String, ServiceError>

Serialize the rating to a JSON string.

pub fn to_tags(&self) -> Result<Tags>

Encode the rating as a set of Nostr tags, ready to attach to an event.

The returned Tags value contains one entry per numeric field plus a z marker tag identifying the payload as a rating.

pub fn from_tags(tags: Tags) -> Result<Self, ServiceError>

Rebuild a Rating from a set of Nostr tags previously produced by Rating::to_tags.

Unknown tag keys are ignored so that the function keeps working if the server adds new metadata fields. Returns a ServiceError if a required key carries a non-parseable value.

Trait Implementations

impl Clone for Rating

fn clone(&self) -> Rating

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Rating

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Rating

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Rating

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

where __S: Serializer,

Serialize this value into the given Serde serializer.