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.

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.

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 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_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 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.

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.