from .models import UserArticleState def with_user_state(articles, user): """Annotates an iterable of Article instances with is_read/is_starred/ is_saved_for_later booleans for the given user, in two queries total regardless of how many articles there are (no N+1). Accepts either a queryset or a plain list (search backends return plain lists already ordered by relevance), materializing it either way. """ articles = list(articles) if not articles: return articles states = { state.article_id: state for state in UserArticleState.objects.filter( user=user, article_id__in=[a.pk for a in articles] ) } for article in articles: state = states.get(article.pk) article.is_read = state.is_read if state else False article.is_starred = state.is_starred if state else False article.is_saved_for_later = state.is_saved_for_later if state else False return articles