mirror of
https://github.com/LemmyNet/lemmy.git
synced 2024-12-13 22:22:10 +00:00
cdc1cf3bf7
* Adding community description in addition to sidebar, like site. - Also made changes to lemmy's group apub to be similar to its site, which uses content for the sidebar, and summary for the short description. - Fixes #5078 * Fixing tests. * Remove comment. * Fix name for description checker.
245 lines
7.6 KiB
Rust
245 lines
7.6 KiB
Rust
use lemmy_db_schema::{
|
|
newtypes::{CommunityId, LanguageId, PersonId},
|
|
source::site::Site,
|
|
CommunityVisibility,
|
|
ListingType,
|
|
};
|
|
use lemmy_db_views_actor::structs::{
|
|
CommunityModeratorView,
|
|
CommunitySortType,
|
|
CommunityView,
|
|
PersonView,
|
|
};
|
|
use serde::{Deserialize, Serialize};
|
|
use serde_with::skip_serializing_none;
|
|
#[cfg(feature = "full")]
|
|
use ts_rs::TS;
|
|
|
|
#[skip_serializing_none]
|
|
#[derive(Debug, Serialize, Deserialize, Clone, Default, PartialEq, Eq, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// Get a community. Must provide either an id, or a name.
|
|
pub struct GetCommunity {
|
|
pub id: Option<CommunityId>,
|
|
/// Example: star_trek , or star_trek@xyz.tld
|
|
pub name: Option<String>,
|
|
}
|
|
|
|
#[skip_serializing_none]
|
|
#[derive(Debug, Serialize, Deserialize, Clone)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// The community response.
|
|
pub struct GetCommunityResponse {
|
|
pub community_view: CommunityView,
|
|
pub site: Option<Site>,
|
|
pub moderators: Vec<CommunityModeratorView>,
|
|
pub discussion_languages: Vec<LanguageId>,
|
|
}
|
|
|
|
#[skip_serializing_none]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
#[derive(Debug, Serialize, Deserialize, Clone, Default, PartialEq, Eq, Hash)]
|
|
/// Create a community.
|
|
pub struct CreateCommunity {
|
|
/// The unique name.
|
|
pub name: String,
|
|
/// A longer title.
|
|
pub title: String,
|
|
/// A sidebar for the community in markdown.
|
|
pub sidebar: Option<String>,
|
|
/// A shorter, one line description of your community.
|
|
pub description: Option<String>,
|
|
/// An icon URL.
|
|
pub icon: Option<String>,
|
|
/// A banner URL.
|
|
pub banner: Option<String>,
|
|
/// Whether its an NSFW community.
|
|
pub nsfw: Option<bool>,
|
|
/// Whether to restrict posting only to moderators.
|
|
pub posting_restricted_to_mods: Option<bool>,
|
|
pub discussion_languages: Option<Vec<LanguageId>>,
|
|
pub visibility: Option<CommunityVisibility>,
|
|
}
|
|
|
|
#[derive(Debug, Serialize, Deserialize, Clone)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// A simple community response.
|
|
pub struct CommunityResponse {
|
|
pub community_view: CommunityView,
|
|
pub discussion_languages: Vec<LanguageId>,
|
|
}
|
|
|
|
#[skip_serializing_none]
|
|
#[derive(Debug, Serialize, Deserialize, Clone, Default, PartialEq, Eq, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// Fetches a list of communities.
|
|
pub struct ListCommunities {
|
|
pub type_: Option<ListingType>,
|
|
pub sort: Option<CommunitySortType>,
|
|
pub show_nsfw: Option<bool>,
|
|
pub page: Option<i64>,
|
|
pub limit: Option<i64>,
|
|
}
|
|
|
|
#[derive(Debug, Serialize, Deserialize, Clone)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// The response for listing communities.
|
|
pub struct ListCommunitiesResponse {
|
|
pub communities: Vec<CommunityView>,
|
|
}
|
|
|
|
#[skip_serializing_none]
|
|
#[derive(Debug, Serialize, Deserialize, Clone, Default, PartialEq, Eq, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// Ban a user from a community.
|
|
pub struct BanFromCommunity {
|
|
pub community_id: CommunityId,
|
|
pub person_id: PersonId,
|
|
pub ban: bool,
|
|
/// Optionally remove or restore all their data. Useful for new troll accounts.
|
|
/// If ban is true, then this means remove. If ban is false, it means restore.
|
|
pub remove_or_restore_data: Option<bool>,
|
|
pub reason: Option<String>,
|
|
/// A time that the ban will expire, in unix epoch seconds.
|
|
///
|
|
/// An i64 unix timestamp is used for a simpler API client implementation.
|
|
pub expires: Option<i64>,
|
|
}
|
|
|
|
#[derive(Debug, Serialize, Deserialize, Clone)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// The response for banning a user from a community.
|
|
pub struct BanFromCommunityResponse {
|
|
pub person_view: PersonView,
|
|
pub banned: bool,
|
|
}
|
|
|
|
#[derive(Debug, Serialize, Deserialize, Clone, Default, PartialEq, Eq, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// Add a moderator to a community.
|
|
pub struct AddModToCommunity {
|
|
pub community_id: CommunityId,
|
|
pub person_id: PersonId,
|
|
pub added: bool,
|
|
}
|
|
|
|
#[derive(Debug, Serialize, Deserialize, Clone)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// The response of adding a moderator to a community.
|
|
pub struct AddModToCommunityResponse {
|
|
pub moderators: Vec<CommunityModeratorView>,
|
|
}
|
|
|
|
#[skip_serializing_none]
|
|
#[derive(Debug, Serialize, Deserialize, Clone, Default, PartialEq, Eq, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// Edit a community.
|
|
pub struct EditCommunity {
|
|
pub community_id: CommunityId,
|
|
/// A longer title.
|
|
pub title: Option<String>,
|
|
/// A sidebar for the community in markdown.
|
|
pub sidebar: Option<String>,
|
|
/// A shorter, one line description of your community.
|
|
pub description: Option<String>,
|
|
/// An icon URL.
|
|
pub icon: Option<String>,
|
|
/// A banner URL.
|
|
pub banner: Option<String>,
|
|
/// Whether its an NSFW community.
|
|
pub nsfw: Option<bool>,
|
|
/// Whether to restrict posting only to moderators.
|
|
pub posting_restricted_to_mods: Option<bool>,
|
|
pub discussion_languages: Option<Vec<LanguageId>>,
|
|
pub visibility: Option<CommunityVisibility>,
|
|
}
|
|
|
|
#[skip_serializing_none]
|
|
#[derive(Debug, Serialize, Deserialize, Clone, Default, PartialEq, Eq, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// Hide a community from the main view.
|
|
pub struct HideCommunity {
|
|
pub community_id: CommunityId,
|
|
pub hidden: bool,
|
|
pub reason: Option<String>,
|
|
}
|
|
|
|
#[skip_serializing_none]
|
|
#[derive(Debug, Serialize, Deserialize, Clone, Default, PartialEq, Eq, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// Delete your own community.
|
|
pub struct DeleteCommunity {
|
|
pub community_id: CommunityId,
|
|
pub deleted: bool,
|
|
}
|
|
|
|
#[skip_serializing_none]
|
|
#[derive(Debug, Serialize, Deserialize, Clone, Default, PartialEq, Eq, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// Remove a community (only doable by moderators).
|
|
pub struct RemoveCommunity {
|
|
pub community_id: CommunityId,
|
|
pub removed: bool,
|
|
pub reason: Option<String>,
|
|
}
|
|
|
|
#[derive(Debug, Serialize, Deserialize, Clone, Default, PartialEq, Eq, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// Follow / subscribe to a community.
|
|
pub struct FollowCommunity {
|
|
pub community_id: CommunityId,
|
|
pub follow: bool,
|
|
}
|
|
|
|
#[derive(Debug, Serialize, Deserialize, Clone, Default, PartialEq, Eq, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// Block a community.
|
|
pub struct BlockCommunity {
|
|
pub community_id: CommunityId,
|
|
pub block: bool,
|
|
}
|
|
|
|
#[skip_serializing_none]
|
|
#[derive(Debug, Serialize, Deserialize, Clone)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// The block community response.
|
|
pub struct BlockCommunityResponse {
|
|
pub community_view: CommunityView,
|
|
pub blocked: bool,
|
|
}
|
|
|
|
#[derive(Debug, Serialize, Deserialize, Clone, Default, PartialEq, Eq, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// Transfer a community to a new owner.
|
|
pub struct TransferCommunity {
|
|
pub community_id: CommunityId,
|
|
pub person_id: PersonId,
|
|
}
|
|
|
|
#[skip_serializing_none]
|
|
#[derive(Debug, Serialize, Deserialize, Clone, Default, PartialEq, Eq, Hash)]
|
|
#[cfg_attr(feature = "full", derive(TS))]
|
|
#[cfg_attr(feature = "full", ts(export))]
|
|
/// Fetches a random community
|
|
pub struct GetRandomCommunity {
|
|
pub type_: Option<ListingType>,
|
|
}
|