Struct DiscourseClient 

pub struct DiscourseClient { /* private fields */ }

HTTP client for the Discourse API.

Implementations

impl DiscourseClient

pub fn create_backup(&self) -> Result<()>

Trigger a backup on the Discourse instance.

pub fn list_backups(&self) -> Result<Value>

List backups available on the Discourse instance.

pub fn restore_backup(&self, backup_path: &str) -> Result<()>

Restore a backup by filename/path.

impl DiscourseClient

pub fn fetch_category(&self, category_id: u64) -> Result<CategoryResponse>

Fetch a category by ID (topics list included).

pub fn fetch_categories(&self) -> Result<Vec<CategoryInfo>>

Fetch all categories.

pub fn create_category(&self, category: &CategoryInfo) -> Result<u64>

Create a category with basic fields copied from a source category.

impl DiscourseClient

pub fn new(config: &DiscourseConfig) -> Result<Self>

Create a new Discourse API client.

pub fn baseurl(&self) -> &str

Return the configured base URL.

pub fn fetch_site_title(&self) -> Result<String>

Fetch the Discourse site title.

pub fn fetch_version_info(&self) -> Result<VersionInfo>

Fetch the current Discourse version and commit hash.

pub fn fetch_version(&self) -> Result<Option<String>>

Fetch the current Discourse version (best-effort).

impl DiscourseClient

pub fn upload_emoji(&self, emoji_path: &Path, emoji_name: &str) -> Result<()>

Upload a custom emoji. Retries on 429 via the shared client helper.

pub fn list_custom_emojis(&self) -> Result<Vec<CustomEmoji>>

List custom emojis.

impl DiscourseClient

pub fn fetch_groups(&self) -> Result<Vec<GroupSummary>>

Fetch all groups.

pub fn fetch_group_detail( &self, group_id: u64, group_name: Option<&str>, ) -> Result<GroupDetail>

Fetch group details by ID (fallbacks to name lookup if needed).

pub fn fetch_group_members( &self, group_id: u64, group_name: Option<&str>, ) -> Result<Vec<GroupMember>>

pub fn create_group(&self, group: &GroupDetail) -> Result<u64>

Create a group with detailed settings copied from a source group.

pub fn add_group_members_by_username( &self, group_id: u64, usernames: &[String], notify_users: bool, ) -> Result<AddMembersOutcome>

Add members to a group by username (PUT /groups/:id/members.json).

pub fn remove_group_members_by_username( &self, group_id: u64, usernames: &[String], ) -> Result<()>

Remove members from a group by username (DELETE /groups/:id/members.json).

pub fn fetch_user_groups(&self, username: &str) -> Result<Vec<GroupSummary>>

Return the list of groups a user belongs to, by username.

pub fn add_group_members_by_email( &self, group_id: u64, emails: &[String], notify_users: bool, ) -> Result<AddMembersOutcome>

Add members to a group by email (PUT /groups/:id/members.json).

Returns a tuple of (added_usernames, not_found_emails) parsed loosely from the response; both lists may be empty on success if the response doesn’t surface them.

impl DiscourseClient

pub fn list_color_schemes(&self) -> Result<Value>

List color schemes (palettes) available on the Discourse instance.

pub fn fetch_color_scheme(&self, scheme_id: u64) -> Result<Value>

Fetch a color scheme (palette) by ID.

pub fn create_color_scheme( &self, name: &str, colors: &BTreeMap<String, String>, ) -> Result<u64>

Create a new color scheme (palette).

pub fn update_color_scheme( &self, scheme_id: u64, name: Option<&str>, colors: &BTreeMap<String, String>, ) -> Result<()>

Update an existing color scheme (palette).

impl DiscourseClient

pub fn list_plugins(&self) -> Result<Value>

List installed plugins on the Discourse instance.

impl DiscourseClient

pub fn search_topics(&self, query: &str) -> Result<Vec<SearchHit>>

Search for topics. The query is passed through to Discourse verbatim (so callers can use category:, status:, @user, etc. filters).

impl DiscourseClient

pub fn update_site_setting(&self, setting: &str, value: &str) -> Result<()>

Update a site setting by name (admin only).

pub fn list_site_settings(&self) -> Result<Value>

Fetch all site settings (admin only). Returns raw JSON value.

pub fn fetch_site_setting(&self, setting: &str) -> Result<String>

Fetch a single site setting by name (admin only). Returns the value as a string, or an error if not found.

impl DiscourseClient

pub fn list_tags(&self) -> Result<Vec<TagInfo>>

List every tag visible to the authenticated user.

pub fn fetch_topic_tags(&self, topic_id: u64) -> Result<Vec<String>>

Fetch the current tag list for a topic.

pub fn set_topic_tags( &self, topic_id: u64, tags: &[String], ) -> Result<Vec<String>>

Replace the full tag list on a topic. Returns the resulting tag set.

impl DiscourseClient

pub fn list_themes(&self) -> Result<Value>

List installed themes on the Discourse instance.

pub fn fetch_theme(&self, theme_id: u64) -> Result<Value>

Fetch a single theme by ID.

pub fn create_theme(&self, theme: &Value) -> Result<u64>

Create a new theme and return its ID.

pub fn delete_theme(&self, theme_id: u64) -> Result<()>

Delete a theme by ID.

pub fn update_theme(&self, theme_id: u64, theme: &Value) -> Result<()>

Update an existing theme.

impl DiscourseClient

pub fn fetch_topic( &self, topic_id: u64, include_raw: bool, ) -> Result<TopicResponse>

Fetch a topic by ID.

pub fn fetch_post_raw(&self, post_id: u64) -> Result<Option<String>>

Fetch a post by ID and return its raw content.

pub fn fetch_post(&self, post_id: u64) -> Result<PostInfo>

Fetch a post’s metadata (id, topic_id, post_number, raw).

pub fn delete_post(&self, post_id: u64) -> Result<()>

Soft-delete a post by ID (DELETE /posts/:id.json).

pub fn move_posts( &self, source_topic_id: u64, post_ids: &[u64], dest_topic_id: u64, ) -> Result<String>

Move one or more posts from their current topic to another topic.

source_topic_id is the topic the posts currently live in. post_ids are the post IDs to move. dest_topic_id is where they land. Returns the new URL of the moved posts’ topic.

pub fn update_post(&self, post_id: u64, raw: &str) -> Result<()>

Update a post by ID.

pub fn create_topic( &self, category_id: u64, title: &str, raw: &str, ) -> Result<u64>

Create a new topic in a category.

pub fn create_post(&self, topic_id: u64, raw: &str) -> Result<u64>

Create a reply post in a topic.

impl DiscourseClient

pub fn upload_file( &self, file_path: &Path, upload_type: &str, ) -> Result<UploadInfo>

Upload a file. upload_type is Discourse’s type field — typical values: composer (default; for embedding in posts), avatar, profile_background, card_background, custom_emoji.

Trait Implementations

impl Clone for DiscourseClient

fn clone(&self) -> DiscourseClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.