gitlab-org--gitlab-foss/app/finders
..
admin
alert_management
analytics/cycle_analytics
autocomplete
boards
bulk_imports
ci
clusters
concerns
crm
database
deploy_tokens
design_management
environments
groups
incident_management
issuable_finder
issuables
issues_finder
merge_request
merge_requests
merge_requests_finder
metrics
namespaces
packages
projects
releases
repositories
security
terraform
work_items
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
events_finder.rb
feature_flags_finder.rb
feature_flags_user_lists_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_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
lfs_pointers_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_group_notification_settings_finder.rb
user_groups_counter.rb
user_recent_events_finder.rb
users_finder.rb
users_star_projects_finder.rb

README.md

Finders

These types of classes are responsible for retrieving collection items based on different conditions. They prevent lookup methods in models like this:

class Project < ApplicationRecord
  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)

The GitLab approach is to use a Finder:

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

It will help keep models thinner.