gitlab-ce/app/finders
GitLab Bot b49ea2b72f Add latest changes from gitlab-org/gitlab@master 2025-07-17 09:11:18 +00:00
..
achievements
admin
alert_management Add latest changes from gitlab-org/gitlab@master 2025-05-29 09:09:24 +00:00
analytics/cycle_analytics
autocomplete Add latest changes from gitlab-org/gitlab@master 2025-02-24 06:11:17 +00:00
banzai
boards
bulk_imports
ci Add latest changes from gitlab-org/gitlab@master 2025-07-17 09:11:18 +00:00
clusters Add latest changes from gitlab-org/gitlab@master 2025-07-15 09:07:59 +00:00
concerns Add latest changes from gitlab-org/gitlab@master 2025-06-13 03:14:15 +00:00
crm
data_transfer
database Add latest changes from gitlab-org/gitlab@master 2025-04-16 18:17:53 +00:00
deploy_keys
deploy_tokens
design_management
environments
groups Add latest changes from gitlab-org/gitlab@master 2025-05-08 06:11:11 +00:00
import
incident_management
issuable_finder
issuables Add latest changes from gitlab-org/gitlab@master 2025-07-10 21:07:54 +00:00
issues Add latest changes from gitlab-org/gitlab@master 2025-06-19 12:11:52 +00:00
issues_finder
members Add latest changes from gitlab-org/gitlab@master 2025-05-15 15:14:53 +00:00
merge_request
merge_requests Add latest changes from gitlab-org/gitlab@master 2025-03-26 12:11:45 +00:00
merge_requests_finder Add latest changes from gitlab-org/gitlab@master 2025-04-28 15:09:57 +00:00
namespaces Add latest changes from gitlab-org/gitlab@master 2025-07-02 18:11:50 +00:00
organizations
packages Add latest changes from gitlab-org/gitlab@master 2025-06-25 18:07:32 +00:00
pages
projects
releases Add latest changes from gitlab-org/gitlab@master 2025-03-27 21:09:48 +00:00
repositories
security Add latest changes from gitlab-org/gitlab@master 2025-04-01 03:07:09 +00:00
terraform
timelogs
users
vs_code/settings
web_hooks
work_items Add latest changes from gitlab-org/gitlab@master 2025-06-04 12:07:18 +00:00
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
git_refs_finder.rb
group_descendants_finder.rb Add latest changes from gitlab-org/gitlab@master 2025-06-17 06:07:21 +00:00
group_finder.rb
group_members_finder.rb Add latest changes from gitlab-org/gitlab@master 2025-05-09 15:11:36 +00:00
group_projects_finder.rb
groups_finder.rb Add latest changes from gitlab-org/gitlab@master 2025-07-07 18:10:01 +00:00
issuable_finder.rb Add latest changes from gitlab-org/gitlab@master 2025-07-10 21:07:54 +00:00
issues_finder.rb Add latest changes from gitlab-org/gitlab@master 2025-06-19 12:11:52 +00:00
joined_groups_finder.rb
keys_finder.rb Add latest changes from gitlab-org/gitlab@master 2025-03-27 21:09:48 +00:00
labels_finder.rb Add latest changes from gitlab-org/gitlab@master 2025-07-10 21:07:54 +00:00
lfs_pointers_finder.rb
license_template_finder.rb
members_finder.rb Add latest changes from gitlab-org/gitlab@master 2025-05-15 03:19:55 +00:00
merge_request_target_project_finder.rb
merge_requests_finder.rb Add latest changes from gitlab-org/gitlab@master 2025-06-30 21:14:16 +00:00
milestones_finder.rb
notes_finder.rb Add latest changes from gitlab-org/gitlab@master 2025-05-09 12:12:52 +00:00
pending_todos_finder.rb
personal_access_tokens_finder.rb Add latest changes from gitlab-org/gitlab@master 2025-06-16 21:07:17 +00:00
personal_projects_finder.rb Add latest changes from gitlab-org/gitlab@master 2025-05-19 21:10:30 +00:00
projects_finder.rb Add latest changes from gitlab-org/gitlab@master 2025-07-02 18:11:50 +00:00
protected_branches_finder.rb
releases_finder.rb
resource_milestone_event_finder.rb
resource_state_event_finder.rb
sentry_issue_finder.rb
snippets_finder.rb Add latest changes from gitlab-org/gitlab@master 2025-04-29 03:17:27 +00:00
starred_projects_finder.rb
tags_finder.rb
template_finder.rb
todos_finder.rb Add latest changes from gitlab-org/gitlab@master 2025-06-13 03:14:15 +00:00
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 Add latest changes from gitlab-org/gitlab@master 2025-04-02 12:12:34 +00:00
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.