golgi-ssb
/
golgi
4
5
Fork 0
Code Issues 11 Pull Requests 1 Projects 1 Releases Wiki Activity

polish the message type docs

This commit is contained in:
glyph 2022-02-14 17:00:00 +02:00
parent 32bd924e7e
commit 8466510fee
1 changed files with 25 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
src/messages.rs
View File

@ -7,14 +7,17 @@ use std::fmt::Debug;
use crate::error::GolgiError; use crate::error::GolgiError;
/// This is an alias to TypedMessage in kuska, /// `SsbMessageContent` is a type alias for `TypedMessage` from the `kuska_ssb` library.
/// which is renamed as SsbMessageContent in golgi to fit the naming convention /// It is aliased in golgi to fit the naming convention of the other message
/// of the other types (SsbMessageKVT and SsbMessageValue) /// types: `SsbMessageKVT` and `SsbMessageValue`.
///
/// See the [kuska source code](https://github.com/Kuska-ssb/ssb/blob/master/src/api/dto/content.rs#L103) for the type definition of `TypedMessage`.
pub type SsbMessageContent = TypedMessage; pub type SsbMessageContent = TypedMessage;
/// Data type representing the `value` of a message object (`KVT`). More information concerning the /// The `value` of an SSB message (the `V` in `KVT`).
/// data model can be found ///
/// in the [`Metadata` documentation](https://spec.scuttlebutt.nz/feed/messages.html#metadata). /// More information concerning the data model can be found in the
/// [`Metadata` documentation](https://spec.scuttlebutt.nz/feed/messages.html#metadata).
#[derive(Serialize, Deserialize, Debug)] #[derive(Serialize, Deserialize, Debug)]
#[serde(deny_unknown_fields)] #[serde(deny_unknown_fields)]
#[allow(missing_docs)] #[allow(missing_docs)]
@ -28,7 +31,7 @@ pub struct SsbMessageValue {
pub signature: String, pub signature: String,
} }
// Enum representing the different possible message content types /// Message content types.
#[derive(Debug)] #[derive(Debug)]
#[allow(missing_docs)] #[allow(missing_docs)]
pub enum SsbMessageContentType { pub enum SsbMessageContentType {
@ -40,9 +43,13 @@ pub enum SsbMessageContentType {
} }
impl SsbMessageValue { impl SsbMessageValue {
/// Gets the type field of the message content as an enum, if found. /// Get the type field of the message content as an enum, if found.
/// if no type field is found or the type field is not a string, it returns an Err(GolgiError::ContentType) ///
/// if a type field is found but with an unknown string it returns an Ok(SsbMessageContentType::Unrecognized) /// If no `type` field is found or the `type` field is not a string,
/// it returns an `Err(GolgiError::ContentType)`.
///
/// If a `type` field is found but with an unknown string,
/// it returns an `Ok(SsbMessageContentType::Unrecognized)`.
pub fn get_message_type(&self) -> Result<SsbMessageContentType, GolgiError> { pub fn get_message_type(&self) -> Result<SsbMessageContentType, GolgiError> {
let msg_type = self let msg_type = self
.content .content
@ -61,8 +68,8 @@ impl SsbMessageValue {
Ok(enum_type) Ok(enum_type)
} }
/// Helper function which returns true if this message is of the given type, /// Helper function which returns `true` if this message is of the given type,
/// and false if the type does not match or is not found /// and `false` if the type does not match or is not found.
pub fn is_message_type(&self, _message_type: SsbMessageContentType) -> bool { pub fn is_message_type(&self, _message_type: SsbMessageContentType) -> bool {
let self_message_type = self.get_message_type(); let self_message_type = self.get_message_type();
match self_message_type { match self_message_type {
@ -73,8 +80,8 @@ impl SsbMessageValue {
} }
} }
/// Converts the content json value into an SsbMessageContent enum, /// Convert the content JSON value into an `SsbMessageContent` `enum`,
/// using the "type" field as a tag to select which variant of the enum /// using the `type` field as a tag to select which variant of the `enum`
/// to deserialize into. /// to deserialize into.
/// ///
/// See the [Serde docs on internally-tagged enum representations](https://serde.rs/enum-representations.html#internally-tagged) for further details. /// See the [Serde docs on internally-tagged enum representations](https://serde.rs/enum-representations.html#internally-tagged) for further details.
@ -84,9 +91,10 @@ impl SsbMessageValue {
} }
} }
/// Data type representing the `value` of a message object (`KVT`). More information concerning the /// An SSB message represented as a key-value-timestamp (`KVT`).
/// data model can be found ///
/// in the [`Metadata` documentation](https://spec.scuttlebutt.nz/feed/messages.html#metadata). /// More information concerning the data model can be found in the
/// [`Metadata` documentation](https://spec.scuttlebutt.nz/feed/messages.html#metadata).
#[derive(Serialize, Deserialize, Debug)] #[derive(Serialize, Deserialize, Debug)]
#[serde(deny_unknown_fields)] #[serde(deny_unknown_fields)]
#[allow(missing_docs)] #[allow(missing_docs)]