chore: C-GETTER (sort of)

src/api/channels/reactions.rs

@@ -47,6 +47,7 @@ impl ReactionMeta {
     ///
     /// # Reference
     /// See <https://discord.com/developers/docs/resources/channel#get-reactions>
+    // Consider renaming this, maybe get_reaction_users or get_emoji_users
     pub async fn get(&self, emoji: &str, user: &mut ChorusUser) -> ChorusResult<Vec<PublicUser>> {
         let url = format!(
             "{}/channels/{}/messages/{}/reactions/{}",

src/api/guilds/guilds.rs

@@ -191,10 +191,13 @@ impl Guild {
         Ok(response)
     }
 
-    /// Returns a guild preview object for the given guild ID. If the user is not in the guild, the guild must be discoverable.
+    /// Fetches a guild preview object for the given guild ID. If the user is not in the guild, the guild must be discoverable.
     /// # Reference:
     ///
     /// See <https://discord-userdoccers.vercel.app/resources/guild#get-guild-preview>
+    // RAGC: These aren't just getters, they fetch something on the server.
+    // I am going to excuse these namings, since .preview() indicates we are just returning
+    // something we have already saved.
     pub async fn get_preview(
         guild_id: Snowflake,
         user: &mut ChorusUser,
@@ -216,7 +219,7 @@ impl Guild {
         Ok(response)
     }
 
-    /// Returns a list of guild member objects that are members of the guild.
+    /// Fetches a list of guild member objects that are members of the guild.
     ///
     /// # Reference
     /// See <https://discord-userdoccers.vercel.app/resources/guild#get-guild-members>
@@ -383,7 +386,7 @@ impl Guild {
             .await
     }
 
-    /// Returns a list of ban objects for the guild. Requires the `BAN_MEMBERS` permission.
+    /// Fetches a list of ban objects for the guild. Requires the `BAN_MEMBERS` permission.
     ///
     /// # Reference:
     /// See <https://discord-userdoccers.vercel.app/resources/guild#get-guild-bans>
@@ -413,7 +416,7 @@ impl Guild {
         request.deserialize_response::<Vec<GuildBan>>(user).await
     }
 
-    /// Returns a ban object for the given user. Requires the `BAN_MEMBERS` permission.
+    /// Fetches a ban object for the given user. Requires the `BAN_MEMBERS` permission.
     ///
     /// # Reference:
     /// See <https://discord-userdoccers.vercel.app/resources/guild#get-guild-ban>

src/api/users/guilds.rs

@@ -31,7 +31,7 @@ impl ChorusUser {
         .await
     }
 
-    /// Returns a list of user guild objects representing the guilds the current user is a member of.
+    /// Fetches a list of user guild objects representing the guilds the current user is a member of.
     /// This endpoint returns 200 guilds by default
     ///
     /// # Reference:

src/api/users/users.rs

@@ -11,7 +11,7 @@ use crate::{
 };
 
 impl ChorusUser {
-    /// Gets a user by id, or if the id is None, gets the current user.
+    /// Fetches a user by id, or if the id is None, gets the current user.
     ///
     /// # Notes
     /// This function is a wrapper around [`User::get`].
@@ -23,7 +23,7 @@ impl ChorusUser {
         User::get(self, id).await
     }
 
-    /// Gets the user's settings.
+    /// Fetches the user's settings.
     ///
     /// # Notes
     /// This functions is a wrapper around [`User::get_settings`].
@@ -82,7 +82,7 @@ impl ChorusUser {
 }
 
 impl User {
-    /// Gets a user by id, or if the id is None, gets the current user.
+    /// Fetches a user by id, or if the id is None, gets the current user.
     ///
     /// # Reference
     /// See <https://discord-userdoccers.vercel.app/resources/user#get-user> and
@@ -110,7 +110,7 @@ impl User {
         }
     }
 
-    /// Gets the user's settings.
+    /// Fetches the user's settings.
     ///
     /// # Reference
     /// See <https://luna.gitlab.io/discord-unofficial-docs/user_settings.html#get-users-me-settings>

src/ratelimiter.rs

@@ -342,7 +342,7 @@ impl ChorusRequest {
         }
     }
 
-    /// Gets the ratelimit configuration.
+    /// Fetches the ratelimit configuration.
     ///
     /// # Notes
     /// This is a spacebar only endpoint.

src/types/events/mod.rs

@@ -140,6 +140,8 @@ where
 
 pub(crate) trait JsonField: Clone {
     fn set_json(&mut self, json: String);
+    // RAGC: Perhaps this and get_source_url should be renamed, but that requires a new version of
+    // the macros crate aswell, and I don't know if it's worth it
     fn get_json(&self) -> String;
 }