gitlab-org--gitlab-foss/app/finders
..
admin
alert_management
autocomplete
boards
ci
clusters
concerns
design_management
issuable_finder
issues_finder
metrics
packages
projects
README.md
abuse_reports_finder.rb
access_requests_finder.rb
applications_finder.rb
award_emojis_finder.rb
branches_finder.rb
cluster_ancestors_finder.rb
clusters_finder.rb
container_repositories_finder.rb
context_commits_finder.rb
contributed_projects_finder.rb
deployments_finder.rb
environments_finder.rb
events_finder.rb
fork_projects_finder.rb
fork_targets_finder.rb
freeze_periods_finder.rb
git_refs_finder.rb
group_descendants_finder.rb
group_finder.rb
group_labels_finder.rb
group_members_finder.rb
group_projects_finder.rb
groups_finder.rb
issuable_finder.rb
issues_finder.rb
joined_groups_finder.rb
keys_finder.rb
labels_finder.rb
license_template_finder.rb
members_finder.rb
merge_request_target_project_finder.rb
merge_requests_finder.rb
milestones_finder.rb
notes_finder.rb
pending_todos_finder.rb
personal_access_tokens_finder.rb
personal_projects_finder.rb
projects_finder.rb
prometheus_metrics_finder.rb
protected_branches_finder.rb
releases_finder.rb
resource_milestone_event_finder.rb
resource_state_event_finder.rb
sentry_issue_finder.rb
serverless_domain_finder.rb
snippets_finder.rb
starred_projects_finder.rb
tags_finder.rb
template_finder.rb
todos_finder.rb
union_finder.rb
uploader_finder.rb
user_finder.rb
user_recent_events_finder.rb
users_finder.rb
users_star_projects_finder.rb
users_with_pending_todos_finder.rb

README.md

Finders

This type of classes responsible for collection items based on different conditions. To prevent lookup methods in models like this:

class Project
  def issues_for_user_filtered_by(user, filter)
    # A lot of logic not related to project model itself
  end
end

issues = project.issues_for_user_filtered_by(user, params)

Better use this:

issues = IssuesFinder.new(project, user, filter).execute

It will help keep models thiner.