crates/db_views/src/comment_view.rs

   1 use diesel::{result::Error, *};
   2 use lemmy_db_queries::{
   3   aggregates::comment_aggregates::CommentAggregates,
   4   functions::hot_rank,
   5   fuzzy_search,
   6   limit_and_offset,
   7   ListingType,
   8   MaybeOptional,
   9   SortType,
  10   ToSafe,
  11   ViewToVec,
  12 };
  13 use lemmy_db_schema::{
  14   schema::{
  15     comment,
  16     comment_aggregates,
  17     comment_alias_1,
  18     comment_like,
  19     comment_saved,
  20     community,
  21     community_follower,
  22     community_person_ban,
  23     person,
  24     person_alias_1,
  25     post,
  26   },
  27   source::{
  28     comment::{Comment, CommentAlias1, CommentSaved},
  29     community::{Community, CommunityFollower, CommunityPersonBan, CommunitySafe},
  30     person::{Person, PersonAlias1, PersonSafe, PersonSafeAlias1},
  31     post::Post,
  32   },
  33   CommentId,
  34   CommunityId,
  35   DbUrl,
  36   PersonId,
  37   PostId,
  38 };
  39 use serde::Serialize;
  40
  41 #[derive(Debug, PartialEq, Serialize, Clone)]
  42 pub struct CommentView {
  43   pub comment: Comment,
  44   pub creator: PersonSafe,
  45   pub recipient: Option<PersonSafeAlias1>, // Left joins to comment and person
  46   pub post: Post,
  47   pub community: CommunitySafe,
  48   pub counts: CommentAggregates,
  49   pub creator_banned_from_community: bool, // Left Join to CommunityPersonBan
  50   pub subscribed: bool,                    // Left join to CommunityFollower
  51   pub saved: bool,                         // Left join to CommentSaved
  52   pub my_vote: Option<i16>,                // Left join to CommentLike
  53 }
  54
  55 type CommentViewTuple = (
  56   Comment,
  57   PersonSafe,
  58   Option<CommentAlias1>,
  59   Option<PersonSafeAlias1>,
  60   Post,
  61   CommunitySafe,
  62   CommentAggregates,
  63   Option<CommunityPersonBan>,
  64   Option<CommunityFollower>,
  65   Option<CommentSaved>,
  66   Option<i16>,
  67 );
  68
  69 impl CommentView {
  70   pub fn read(
  71     conn: &PgConnection,
  72     comment_id: CommentId,
  73     my_person_id: Option<PersonId>,
  74   ) -> Result<Self, Error> {
  75     // The left join below will return None in this case
  76     let person_id_join = my_person_id.unwrap_or(PersonId(-1));
  77
  78     let (
  79       comment,
  80       creator,
  81       _parent_comment,
  82       recipient,
  83       post,
  84       community,
  85       counts,
  86       creator_banned_from_community,
  87       subscribed,
  88       saved,
  89       comment_like,
  90     ) = comment::table
  91       .find(comment_id)
  92       .inner_join(person::table)
  93       // recipient here
  94       .left_join(comment_alias_1::table.on(comment_alias_1::id.nullable().eq(comment::parent_id)))
  95       .left_join(person_alias_1::table.on(person_alias_1::id.eq(comment_alias_1::creator_id)))
  96       .inner_join(post::table)
  97       .inner_join(community::table.on(post::community_id.eq(community::id)))
  98       .inner_join(comment_aggregates::table)
  99       .left_join(
 100         community_person_ban::table.on(
 101           community::id
 102             .eq(community_person_ban::community_id)
 103             .and(community_person_ban::person_id.eq(comment::creator_id)),
 104         ),
 105       )
 106       .left_join(
 107         community_follower::table.on(
 108           post::community_id
 109             .eq(community_follower::community_id)
 110             .and(community_follower::person_id.eq(person_id_join)),
 111         ),
 112       )
 113       .left_join(
 114         comment_saved::table.on(
 115           comment::id
 116             .eq(comment_saved::comment_id)
 117             .and(comment_saved::person_id.eq(person_id_join)),
 118         ),
 119       )
 120       .left_join(
 121         comment_like::table.on(
 122           comment::id
 123             .eq(comment_like::comment_id)
 124             .and(comment_like::person_id.eq(person_id_join)),
 125         ),
 126       )
 127       .select((
 128         comment::all_columns,
 129         Person::safe_columns_tuple(),
 130         comment_alias_1::all_columns.nullable(),
 131         PersonAlias1::safe_columns_tuple().nullable(),
 132         post::all_columns,
 133         Community::safe_columns_tuple(),
 134         comment_aggregates::all_columns,
 135         community_person_ban::all_columns.nullable(),
 136         community_follower::all_columns.nullable(),
 137         comment_saved::all_columns.nullable(),
 138         comment_like::score.nullable(),
 139       ))
 140       .first::<CommentViewTuple>(conn)?;
 141
 142     // If a person is given, then my_vote, if None, should be 0, not null
 143     // Necessary to differentiate between other person's votes
 144     let my_vote = if my_person_id.is_some() && comment_like.is_none() {
 145       Some(0)
 146     } else {
 147       comment_like
 148     };
 149
 150     Ok(CommentView {
 151       comment,
 152       recipient,
 153       post,
 154       creator,
 155       community,
 156       counts,
 157       creator_banned_from_community: creator_banned_from_community.is_some(),
 158       subscribed: subscribed.is_some(),
 159       saved: saved.is_some(),
 160       my_vote,
 161     })
 162   }
 163
 164   /// Gets the recipient person id.
 165   /// If there is no parent comment, its the post creator
 166   pub fn get_recipient_id(&self) -> PersonId {
 167     match &self.recipient {
 168       Some(parent_commenter) => parent_commenter.id,
 169       None => self.post.creator_id,
 170     }
 171   }
 172 }
 173
 174 pub struct CommentQueryBuilder<'a> {
 175   conn: &'a PgConnection,
 176   listing_type: Option<ListingType>,
 177   sort: Option<SortType>,
 178   community_id: Option<CommunityId>,
 179   community_actor_id: Option<DbUrl>,
 180   post_id: Option<PostId>,
 181   creator_id: Option<PersonId>,
 182   recipient_id: Option<PersonId>,
 183   my_person_id: Option<PersonId>,
 184   search_term: Option<String>,
 185   saved_only: Option<bool>,
 186   unread_only: Option<bool>,
 187   show_bot_accounts: Option<bool>,
 188   page: Option<i64>,
 189   limit: Option<i64>,
 190 }
 191
 192 impl<'a> CommentQueryBuilder<'a> {
 193   pub fn create(conn: &'a PgConnection) -> Self {
 194     CommentQueryBuilder {
 195       conn,
 196       listing_type: None,
 197       sort: None,
 198       community_id: None,
 199       community_actor_id: None,
 200       post_id: None,
 201       creator_id: None,
 202       recipient_id: None,
 203       my_person_id: None,
 204       search_term: None,
 205       saved_only: None,
 206       unread_only: None,
 207       show_bot_accounts: None,
 208       page: None,
 209       limit: None,
 210     }
 211   }
 212
 213   pub fn listing_type<T: MaybeOptional<ListingType>>(mut self, listing_type: T) -> Self {
 214     self.listing_type = listing_type.get_optional();
 215     self
 216   }
 217
 218   pub fn sort<T: MaybeOptional<SortType>>(mut self, sort: T) -> Self {
 219     self.sort = sort.get_optional();
 220     self
 221   }
 222
 223   pub fn post_id<T: MaybeOptional<PostId>>(mut self, post_id: T) -> Self {
 224     self.post_id = post_id.get_optional();
 225     self
 226   }
 227
 228   pub fn creator_id<T: MaybeOptional<PersonId>>(mut self, creator_id: T) -> Self {
 229     self.creator_id = creator_id.get_optional();
 230     self
 231   }
 232
 233   pub fn recipient_id<T: MaybeOptional<PersonId>>(mut self, recipient_id: T) -> Self {
 234     self.recipient_id = recipient_id.get_optional();
 235     self
 236   }
 237
 238   pub fn community_id<T: MaybeOptional<CommunityId>>(mut self, community_id: T) -> Self {
 239     self.community_id = community_id.get_optional();
 240     self
 241   }
 242
 243   pub fn my_person_id<T: MaybeOptional<PersonId>>(mut self, my_person_id: T) -> Self {
 244     self.my_person_id = my_person_id.get_optional();
 245     self
 246   }
 247
 248   pub fn community_actor_id<T: MaybeOptional<DbUrl>>(mut self, community_actor_id: T) -> Self {
 249     self.community_actor_id = community_actor_id.get_optional();
 250     self
 251   }
 252
 253   pub fn search_term<T: MaybeOptional<String>>(mut self, search_term: T) -> Self {
 254     self.search_term = search_term.get_optional();
 255     self
 256   }
 257
 258   pub fn saved_only<T: MaybeOptional<bool>>(mut self, saved_only: T) -> Self {
 259     self.saved_only = saved_only.get_optional();
 260     self
 261   }
 262
 263   pub fn unread_only<T: MaybeOptional<bool>>(mut self, unread_only: T) -> Self {
 264     self.unread_only = unread_only.get_optional();
 265     self
 266   }
 267
 268   pub fn show_bot_accounts<T: MaybeOptional<bool>>(mut self, show_bot_accounts: T) -> Self {
 269     self.show_bot_accounts = show_bot_accounts.get_optional();
 270     self
 271   }
 272
 273   pub fn page<T: MaybeOptional<i64>>(mut self, page: T) -> Self {
 274     self.page = page.get_optional();
 275     self
 276   }
 277
 278   pub fn limit<T: MaybeOptional<i64>>(mut self, limit: T) -> Self {
 279     self.limit = limit.get_optional();
 280     self
 281   }
 282
 283   pub fn list(self) -> Result<Vec<CommentView>, Error> {
 284     use diesel::dsl::*;
 285
 286     // The left join below will return None in this case
 287     let person_id_join = self.my_person_id.unwrap_or(PersonId(-1));
 288
 289     let mut query = comment::table
 290       .inner_join(person::table)
 291       // recipient here
 292       .left_join(comment_alias_1::table.on(comment_alias_1::id.nullable().eq(comment::parent_id)))
 293       .left_join(person_alias_1::table.on(person_alias_1::id.eq(comment_alias_1::creator_id)))
 294       .inner_join(post::table)
 295       .inner_join(community::table.on(post::community_id.eq(community::id)))
 296       .inner_join(comment_aggregates::table)
 297       .left_join(
 298         community_person_ban::table.on(
 299           community::id
 300             .eq(community_person_ban::community_id)
 301             .and(community_person_ban::person_id.eq(comment::creator_id)),
 302         ),
 303       )
 304       .left_join(
 305         community_follower::table.on(
 306           post::community_id
 307             .eq(community_follower::community_id)
 308             .and(community_follower::person_id.eq(person_id_join)),
 309         ),
 310       )
 311       .left_join(
 312         comment_saved::table.on(
 313           comment::id
 314             .eq(comment_saved::comment_id)
 315             .and(comment_saved::person_id.eq(person_id_join)),
 316         ),
 317       )
 318       .left_join(
 319         comment_like::table.on(
 320           comment::id
 321             .eq(comment_like::comment_id)
 322             .and(comment_like::person_id.eq(person_id_join)),
 323         ),
 324       )
 325       .select((
 326         comment::all_columns,
 327         Person::safe_columns_tuple(),
 328         comment_alias_1::all_columns.nullable(),
 329         PersonAlias1::safe_columns_tuple().nullable(),
 330         post::all_columns,
 331         Community::safe_columns_tuple(),
 332         comment_aggregates::all_columns,
 333         community_person_ban::all_columns.nullable(),
 334         community_follower::all_columns.nullable(),
 335         comment_saved::all_columns.nullable(),
 336         comment_like::score.nullable(),
 337       ))
 338       .into_boxed();
 339
 340     // The replies
 341     if let Some(recipient_id) = self.recipient_id {
 342       query = query
 343         // TODO needs lots of testing
 344         .filter(person_alias_1::id.eq(recipient_id)) // Gets the comment replies
 345         .or_filter(
 346           comment::parent_id
 347             .is_null()
 348             .and(post::creator_id.eq(recipient_id)),
 349         ) // Gets the top level replies
 350         .filter(comment::deleted.eq(false))
 351         .filter(comment::removed.eq(false));
 352     }
 353
 354     if self.unread_only.unwrap_or(false) {
 355       query = query.filter(comment::read.eq(false));
 356     }
 357
 358     if let Some(creator_id) = self.creator_id {
 359       query = query.filter(comment::creator_id.eq(creator_id));
 360     };
 361
 362     if let Some(community_id) = self.community_id {
 363       query = query.filter(post::community_id.eq(community_id));
 364     }
 365
 366     if let Some(community_actor_id) = self.community_actor_id {
 367       query = query.filter(community::actor_id.eq(community_actor_id))
 368     }
 369
 370     if let Some(post_id) = self.post_id {
 371       query = query.filter(comment::post_id.eq(post_id));
 372     };
 373
 374     if let Some(search_term) = self.search_term {
 375       query = query.filter(comment::content.ilike(fuzzy_search(&search_term)));
 376     };
 377
 378     if let Some(listing_type) = self.listing_type {
 379       query = match listing_type {
 380         ListingType::Subscribed => query.filter(community_follower::person_id.is_not_null()), // TODO could be this: and(community_follower::person_id.eq(person_id_join)),
 381         ListingType::Local => query.filter(community::local.eq(true)),
 382         _ => query,
 383       };
 384     }
 385
 386     if self.saved_only.unwrap_or(false) {
 387       query = query.filter(comment_saved::id.is_not_null());
 388     }
 389
 390     if !self.show_bot_accounts.unwrap_or(true) {
 391       query = query.filter(person::bot_account.eq(false));
 392     };
 393
 394     query = match self.sort.unwrap_or(SortType::New) {
 395       SortType::Hot | SortType::Active => query
 396         .order_by(hot_rank(comment_aggregates::score, comment_aggregates::published).desc())
 397         .then_order_by(comment_aggregates::published.desc()),
 398       SortType::New | SortType::MostComments | SortType::NewComments => {
 399         query.order_by(comment::published.desc())
 400       }
 401       SortType::TopAll => query.order_by(comment_aggregates::score.desc()),
 402       SortType::TopYear => query
 403         .filter(comment::published.gt(now - 1.years()))
 404         .order_by(comment_aggregates::score.desc()),
 405       SortType::TopMonth => query
 406         .filter(comment::published.gt(now - 1.months()))
 407         .order_by(comment_aggregates::score.desc()),
 408       SortType::TopWeek => query
 409         .filter(comment::published.gt(now - 1.weeks()))
 410         .order_by(comment_aggregates::score.desc()),
 411       SortType::TopDay => query
 412         .filter(comment::published.gt(now - 1.days()))
 413         .order_by(comment_aggregates::score.desc()),
 414     };
 415
 416     let (limit, offset) = limit_and_offset(self.page, self.limit);
 417
 418     // Note: deleted and removed comments are done on the front side
 419     let res = query
 420       .limit(limit)
 421       .offset(offset)
 422       .load::<CommentViewTuple>(self.conn)?;
 423
 424     Ok(CommentView::from_tuple_to_vec(res))
 425   }
 426 }
 427
 428 impl ViewToVec for CommentView {
 429   type DbTuple = CommentViewTuple;
 430   fn from_tuple_to_vec(items: Vec<Self::DbTuple>) -> Vec<Self> {
 431     items
 432       .iter()
 433       .map(|a| Self {
 434         comment: a.0.to_owned(),
 435         creator: a.1.to_owned(),
 436         recipient: a.3.to_owned(),
 437         post: a.4.to_owned(),
 438         community: a.5.to_owned(),
 439         counts: a.6.to_owned(),
 440         creator_banned_from_community: a.7.is_some(),
 441         subscribed: a.8.is_some(),
 442         saved: a.9.is_some(),
 443         my_vote: a.10,
 444       })
 445       .collect::<Vec<Self>>()
 446   }
 447 }
 448
 449 #[cfg(test)]
 450 mod tests {
 451   use crate::comment_view::*;
 452   use lemmy_db_queries::{
 453     aggregates::comment_aggregates::CommentAggregates,
 454     establish_unpooled_connection,
 455     Crud,
 456     Likeable,
 457   };
 458   use lemmy_db_schema::source::{comment::*, community::*, person::*, post::*};
 459   use serial_test::serial;
 460
 461   #[test]
 462   #[serial]
 463   fn test_crud() {
 464     let conn = establish_unpooled_connection();
 465
 466     let new_person = PersonForm {
 467       name: "timmy".into(),
 468       ..PersonForm::default()
 469     };
 470
 471     let inserted_person = Person::create(&conn, &new_person).unwrap();
 472
 473     let new_community = CommunityForm {
 474       name: "test community 5".to_string(),
 475       title: "nada".to_owned(),
 476       ..CommunityForm::default()
 477     };
 478
 479     let inserted_community = Community::create(&conn, &new_community).unwrap();
 480
 481     let new_post = PostForm {
 482       name: "A test post 2".into(),
 483       creator_id: inserted_person.id,
 484       community_id: inserted_community.id,
 485       ..PostForm::default()
 486     };
 487
 488     let inserted_post = Post::create(&conn, &new_post).unwrap();
 489
 490     let comment_form = CommentForm {
 491       content: "A test comment 32".into(),
 492       creator_id: inserted_person.id,
 493       post_id: inserted_post.id,
 494       ..CommentForm::default()
 495     };
 496
 497     let inserted_comment = Comment::create(&conn, &comment_form).unwrap();
 498
 499     let comment_like_form = CommentLikeForm {
 500       comment_id: inserted_comment.id,
 501       post_id: inserted_post.id,
 502       person_id: inserted_person.id,
 503       score: 1,
 504     };
 505
 506     let _inserted_comment_like = CommentLike::like(&conn, &comment_like_form).unwrap();
 507
 508     let agg = CommentAggregates::read(&conn, inserted_comment.id).unwrap();
 509
 510     let expected_comment_view_no_person = CommentView {
 511       creator_banned_from_community: false,
 512       my_vote: None,
 513       subscribed: false,
 514       saved: false,
 515       comment: Comment {
 516         id: inserted_comment.id,
 517         content: "A test comment 32".into(),
 518         creator_id: inserted_person.id,
 519         post_id: inserted_post.id,
 520         parent_id: None,
 521         removed: false,
 522         deleted: false,
 523         read: false,
 524         published: inserted_comment.published,
 525         ap_id: inserted_comment.ap_id,
 526         updated: None,
 527         local: true,
 528       },
 529       creator: PersonSafe {
 530         id: inserted_person.id,
 531         name: "timmy".into(),
 532         display_name: None,
 533         published: inserted_person.published,
 534         avatar: None,
 535         actor_id: inserted_person.actor_id.to_owned(),
 536         local: true,
 537         banned: false,
 538         deleted: false,
 539         admin: false,
 540         bot_account: false,
 541         bio: None,
 542         banner: None,
 543         updated: None,
 544         inbox_url: inserted_person.inbox_url.to_owned(),
 545         shared_inbox_url: None,
 546         matrix_user_id: None,
 547       },
 548       recipient: None,
 549       post: Post {
 550         id: inserted_post.id,
 551         name: inserted_post.name.to_owned(),
 552         creator_id: inserted_person.id,
 553         url: None,
 554         body: None,
 555         published: inserted_post.published,
 556         updated: None,
 557         community_id: inserted_community.id,
 558         removed: false,
 559         deleted: false,
 560         locked: false,
 561         stickied: false,
 562         nsfw: false,
 563         embed_title: None,
 564         embed_description: None,
 565         embed_html: None,
 566         thumbnail_url: None,
 567         ap_id: inserted_post.ap_id.to_owned(),
 568         local: true,
 569       },
 570       community: CommunitySafe {
 571         id: inserted_community.id,
 572         name: "test community 5".to_string(),
 573         icon: None,
 574         removed: false,
 575         deleted: false,
 576         nsfw: false,
 577         actor_id: inserted_community.actor_id.to_owned(),
 578         local: true,
 579         title: "nada".to_owned(),
 580         description: None,
 581         updated: None,
 582         banner: None,
 583         published: inserted_community.published,
 584       },
 585       counts: CommentAggregates {
 586         id: agg.id,
 587         comment_id: inserted_comment.id,
 588         score: 1,
 589         upvotes: 1,
 590         downvotes: 0,
 591         published: agg.published,
 592       },
 593     };
 594
 595     let mut expected_comment_view_with_person = expected_comment_view_no_person.to_owned();
 596     expected_comment_view_with_person.my_vote = Some(1);
 597
 598     let read_comment_views_no_person = CommentQueryBuilder::create(&conn)
 599       .post_id(inserted_post.id)
 600       .list()
 601       .unwrap();
 602
 603     let read_comment_views_with_person = CommentQueryBuilder::create(&conn)
 604       .post_id(inserted_post.id)
 605       .my_person_id(inserted_person.id)
 606       .list()
 607       .unwrap();
 608
 609     let like_removed = CommentLike::remove(&conn, inserted_person.id, inserted_comment.id).unwrap();
 610     let num_deleted = Comment::delete(&conn, inserted_comment.id).unwrap();
 611     Post::delete(&conn, inserted_post.id).unwrap();
 612     Community::delete(&conn, inserted_community.id).unwrap();
 613     Person::delete(&conn, inserted_person.id).unwrap();
 614
 615     assert_eq!(
 616       expected_comment_view_no_person,
 617       read_comment_views_no_person[0]
 618     );
 619     assert_eq!(
 620       expected_comment_view_with_person,
 621       read_comment_views_with_person[0]
 622     );
 623     assert_eq!(1, num_deleted);
 624     assert_eq!(1, like_removed);
 625   }
 626 }