gitlab-org--gitlab-foss/app/finders
2021-03-16 18:11:53 +00:00
..
admin
alert_management
autocomplete
boards Add latest changes from gitlab-org/gitlab@master 2021-03-05 09:09:07 +00:00
ci
clusters
concerns Add latest changes from gitlab-org/gitlab@master 2021-03-16 12:11:31 +00:00
design_management
issuable_finder
issuables
issues_finder
merge_request
merge_requests
merge_requests_finder
metrics
namespaces Add latest changes from gitlab-org/gitlab@master 2021-03-08 15:08:54 +00:00
packages Add latest changes from gitlab-org/gitlab@master 2021-03-12 06:09:23 +00:00
projects Add latest changes from gitlab-org/gitlab@master 2021-03-06 00:09:02 +00:00
releases
repositories Add latest changes from gitlab-org/gitlab@master 2021-03-11 12:09:28 +00:00
security
terraform
abuse_reports_finder.rb
access_requests_finder.rb
applications_finder.rb Add latest changes from gitlab-org/gitlab@master 2021-03-16 18:11:53 +00:00
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
environment_names_finder.rb
environments_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
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
README.md
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
users_with_pending_todos_finder.rb

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.