Class: Release

Inherits:
ApplicationRecord show all
Includes:
CacheMarkdownField, EachBatch, FromUnion, Gitlab::Utils::StrongMemoize, Importable, Presentable
Defined in:
app/models/release.rb

Constant Summary collapse

MAX_NUMBER_TO_DISPLAY = 
3

Constants included from CacheMarkdownField

CacheMarkdownField::INVALIDATED_BY

Constants inherited from ApplicationRecord

ApplicationRecord::MAX_PLUCK

Constants included from ResetOnUnionError

ResetOnUnionError::MAX_RESET_PERIOD

Instance Attribute Summary

Attributes included from Importable

#imported, #importing

Attributes included from CacheMarkdownField

#skip_markdown_cache_validation

Class Method Summary collapse

Instance Method Summary collapse

Methods included from CacheMarkdownField

#attribute_invalidated?, #banzai_render_context, #cached_html_for, #cached_html_up_to_date?, #can_cache_field?, #invalidated_markdown_cache?, #latest_cached_markdown_version, #local_version, #mentionable_attributes_changed?, #mentioned_filtered_user_ids_for, #parent_user, #refresh_markdown_cache, #refresh_markdown_cache!, #rendered_field_content, #skip_project_check?, #store_mentions!, #updated_cached_html_for

Methods included from Presentable

#present

Methods inherited from ApplicationRecord

cached_column_list, #create_or_load_association, declarative_enum, default_select_columns, id_in, id_not_in, iid_in, pluck_primary_key, primary_key_in, #readable_by?, safe_ensure_unique, safe_find_or_create_by, safe_find_or_create_by!, #to_ability_name, underscore, where_exists, where_not_exists, with_fast_read_statement_timeout, without_order

Methods included from SensitiveSerializableHash

#serializable_hash

Class Method Details

.latest(order_by: 'released_at') ⇒ Object

In the future, we should support ‘order_by=semver`; see gitlab.com/gitlab-org/gitlab/-/issues/352945



64
65
66
 
# File 'app/models/release.rb', line 64

def latest(order_by: 'released_at')
  sort_by_attribute("#{order_by}_desc").first
end

.latest_for_projects(projects, order_by: 'released_at') ⇒ Object

This query uses LATERAL JOIN to find the latest release for each project. To avoid joining the ‘projects` table, we build an in-memory table using the project ids. Example: SELECT … FROM (VALUES (PROJECT_ID_1),(PROJECT_ID_2)) projects (id) INNER JOIN LATERAL (…)



74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
 
# File 'app/models/release.rb', line 74

def latest_for_projects(projects, order_by: 'released_at')
  return Release.none if projects.empty?

  projects_table = Project.arel_table
  releases_table = Release.arel_table

  join_query = Release
    .where(projects_table[:id].eq(releases_table[:project_id]))
    .sort_by_attribute("#{order_by}_desc")
    .limit(1)

  project_ids_list = projects.map { |project| "(#{project.id})" }.join(',')

  Release
    .from("(VALUES #{project_ids_list}) projects (id)")
    .joins("INNER JOIN LATERAL (#{join_query.to_sql}) #{Release.table_name} ON TRUE")
end

Instance Method Details

#assets_count(except: []) ⇒ Object 



107
108
109
110
111
112
 
# File 'app/models/release.rb', line 107

def assets_count(except: [])
  links_count = links.size
  sources_count = except.include?(:sources) ? 0 : sources.size

  links_count + sources_count
end

#commit ⇒ Object 



97
98
99
100
101
 
# File 'app/models/release.rb', line 97

def commit
  strong_memoize(:commit) do
    repository.commit(actual_sha)
  end
end

#execute_hooks(action) ⇒ Object 



140
141
142
143
 
# File 'app/models/release.rb', line 140

def execute_hooks(action)
  hook_data = to_hook_data(action)
  project.execute_hooks(hook_data, :release_hooks)
end

#historical_release? ⇒ Boolean

Returns:

  • (Boolean) 


124
125
126
 
# File 'app/models/release.rb', line 124

def historical_release?
  released_at.present? && released_at.to_i < created_at.to_i
end

#milestone_titles ⇒ Object 



132
133
134
 
# File 'app/models/release.rb', line 132

def milestone_titles
  self.milestones.order_by_dates_and_title.map { |m| m.title }.join(', ')
end

#name ⇒ Object 



128
129
130
 
# File 'app/models/release.rb', line 128

def name
  self.read_attribute(:name) || tag
end

#sources ⇒ Object 



114
115
116
117
118
 
# File 'app/models/release.rb', line 114

def sources
  strong_memoize(:sources) do
    Releases::Source.all(project, tag)
  end
end

#tag_missing? ⇒ Boolean

Returns:

  • (Boolean) 


103
104
105
 
# File 'app/models/release.rb', line 103

def tag_missing?
  actual_tag.nil?
end

#to_hook_data(action) ⇒ Object 



136
137
138
 
# File 'app/models/release.rb', line 136

def to_hook_data(action)
  Gitlab::HookData::ReleaseBuilder.new(self).build(action)
end

#to_param ⇒ Object 



93
94
95
 
# File 'app/models/release.rb', line 93

def to_param
  tag
end

#upcoming_release? ⇒ Boolean

Returns:

  • (Boolean) 


120
121
122
 
# File 'app/models/release.rb', line 120

def upcoming_release?
  released_at.present? && released_at.to_i > Time.zone.now.to_i
end