src/lib.rs

@@ -190,7 +190,7 @@ impl Sbot {
         }
     }
 
-    /* GET NAME */
+    /* GET ABOUT MESSAGES */
 
     /// Return latest name assignment from `about` msgs (the name in this case is for the public key
     /// associated with the local sbot instance).
@@ -221,6 +221,35 @@ impl Sbot {
         }
     }
 
+    /// Return latest description assignment from `about` msgs
+    /// (the description associated with the public key of the local sbot instance).
+    ///
+    /// Calls `sbotcli bytype --limit 10 --reverse about`. On success: parses the `stdout` to extract the
+    /// `description` and returns it. On error: returns the `stderr` output with a description.
+    ///
+    pub fn get_description(&self) -> Result<Option<String>, SbotCliError> {
+        let output = Command::new(&self.sbotcli_path)
+            .arg("bytype")
+            .arg("--limit")
+            .arg("10")
+            .arg("--reverse")
+            .arg("about")
+            .output()?;
+        if output.status.success() {
+            let stdout = String::from_utf8(output.stdout)?;
+            let description = utils::regex_finder(r#""description": "(.*)""#, &stdout)?;
+            Ok(description)
+        } else {
+            let stderr = std::str::from_utf8(&output.stderr)?;
+            // TODO: create a more generic error variant
+            Err(SbotCliError::GetAboutMsgs(format!(
+                "Error fetching about messages: {}",
+                stderr
+            )))
+        }
+    }
+
+
     /* INVITES */
 
     /// Accept an invite code (trigger a mutual follow with the peer who generated the invite).
@@ -347,7 +376,8 @@ impl Sbot {
     /// # Arguments
     ///
     /// * `name` - A string slice representing a profile name (bio)
-    /// * `id` - A string slice representing an id (profile reference / public key)
+    /// * `id` - A string slice representing the id (profile reference / public key)
+    /// of the profile being named
     ///
     pub fn publish_name(&self, id: &str, name: &str) -> Result<String, SbotCliError> {
         let output = Command::new(&self.sbotcli_path)
@@ -371,6 +401,41 @@ impl Sbot {
         }
     }
 
+
+    /// Publish an about message with a name for one's own profile,
+    /// using whoami to find your own id.
+    ///
+    /// Calls `sbotcli publish about --name [name] [self_id]`.
+    /// passing the id of the currently running sbot as self_id.
+    /// On success: trims the trailing whitespace from `stdout` and returns the message reference.
+    /// On error: returns the `stderr` output with a description.
+    ///
+    /// # Arguments
+    ///
+    /// * `name` - A string slice of the new name you would like to self-identify with
+    ///
+    pub fn publish_own_name(&self, name: &str) -> Result<String, SbotCliError> {
+        let self_id = &self.whoami()?;
+        self.publish_name(name, self_id)
+    }
+
+    /// Publish an about message with a description for one's own profile,
+    /// using whoami to find your own id.
+    ///
+    /// Calls `sbotcli publish about --description [description] [self_id]`.
+    /// passing the id of the currently running sbot as self_id.
+    /// On success: trims the trailing whitespace from `stdout` and returns the message reference.
+    /// On error: returns the `stderr` output with a description.
+    ///
+    /// # Arguments
+    ///
+    /// * `description` - A string slice of the description you would like to use
+    ///
+    pub fn publish_own_description(&self, description: &str) -> Result<String, SbotCliError> {
+        let self_id = &self.whoami()?;
+        self.publish_description(description, self_id)
+    }
+
     /// Publish a post (public message).
     ///
     /// Calls `sbotcli publish post [text]". On success: trims the trailing whitespace from `stdout` and returns the message reference. On error: returns the `stderr` output with a description.
@@ -439,7 +504,7 @@ impl Sbot {
     /// Calls `sbotcli call whoami`. On success: parses the `stdout` to extract the ID and returns it.
     /// On error: returns the `stderr` output with a description.
     ///
-    pub fn whoami(&self) -> Result<Option<String>, SbotCliError> {
+    pub fn whoami(&self) -> Result<String, SbotCliError> {
         let output = Command::new(&self.sbotcli_path)
             .arg("call")
             .arg("whoami")
@@ -447,8 +512,16 @@ impl Sbot {
         if output.status.success() {
             let stdout = String::from_utf8(output.stdout)?;
             let id = utils::regex_finder(r#""id": "(.*)"\n"#, &stdout)?;
-
-            Ok(id)
+            match  id {
+                // if the regex matches, then return the result
+                Some(id) => {
+                    Ok(id)
+                },
+                // if the regex does not match, then return an error
+                None => {
+                    Err(SbotCliError::WhoAmI("Error calling whoami: failed to capture the id value using regex".to_string()))
+                }
+            }
         } else {
             let stderr = std::str::from_utf8(&output.stderr)?;
             Err(SbotCliError::WhoAmI(format!(