2015-12-15 09:51:16 -05:00
|
|
|
module Banzai
|
|
|
|
module Renderer
|
2016-07-19 09:05:22 -04:00
|
|
|
extend self
|
|
|
|
|
2015-12-15 09:51:16 -05:00
|
|
|
# Convert a Markdown String into an HTML-safe String of HTML
|
|
|
|
#
|
|
|
|
# Note that while the returned HTML will have been sanitized of dangerous
|
|
|
|
# HTML, it may post a risk of information leakage if it's not also passed
|
|
|
|
# through `post_process`.
|
|
|
|
#
|
|
|
|
# Also note that the returned String is always HTML, not XHTML. Views
|
|
|
|
# requiring XHTML, such as Atom feeds, need to call `post_process` on the
|
|
|
|
# result, providing the appropriate `pipeline` option.
|
|
|
|
#
|
2016-07-05 11:21:13 -04:00
|
|
|
# text - Markdown String
|
2015-12-15 09:51:16 -05:00
|
|
|
# context - Hash of context options passed to our HTML Pipeline
|
|
|
|
#
|
|
|
|
# Returns an HTML-safe String
|
2016-07-19 09:05:22 -04:00
|
|
|
def render(text, context = {})
|
2015-12-15 09:51:16 -05:00
|
|
|
cache_key = context.delete(:cache_key)
|
|
|
|
cache_key = full_cache_key(cache_key, context[:pipeline])
|
|
|
|
|
2016-01-06 07:26:02 -05:00
|
|
|
if cache_key
|
2016-04-11 11:42:12 -04:00
|
|
|
Gitlab::Metrics.measure(:banzai_cached_render) do
|
|
|
|
Rails.cache.fetch(cache_key) do
|
|
|
|
cacheless_render(text, context)
|
|
|
|
end
|
2015-12-15 09:51:16 -05:00
|
|
|
end
|
2016-01-06 07:25:13 -05:00
|
|
|
else
|
|
|
|
cacheless_render(text, context)
|
2015-12-15 09:51:16 -05:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2016-07-05 11:21:13 -04:00
|
|
|
# Perform multiple render from an Array of Markdown String into an
|
|
|
|
# Array of HTML-safe String of HTML.
|
|
|
|
#
|
|
|
|
# As the rendered Markdown String can be already cached read all the data
|
|
|
|
# from the cache using Rails.cache.read_multi operation. If the Markdown String
|
|
|
|
# is not in the cache or it's not cacheable (no cache_key entry is provided in
|
|
|
|
# the context) the Markdown String is rendered and stored in the cache so the
|
|
|
|
# next render call gets the rendered HTML-safe String from the cache.
|
|
|
|
#
|
|
|
|
# For further explanation see #render method comments.
|
|
|
|
#
|
|
|
|
# texts_and_contexts - An Array of Hashes that contains the Markdown String (:text)
|
|
|
|
# an options passed to our HTML Pipeline (:context)
|
|
|
|
#
|
|
|
|
# If on the :context you specify a :cache_key entry will be used to retrieve it
|
|
|
|
# and cache the result of rendering the Markdown String.
|
|
|
|
#
|
|
|
|
# Returns an Array containing HTML-safe String instances.
|
|
|
|
#
|
|
|
|
# Example:
|
|
|
|
# texts_and_contexts
|
|
|
|
# => [{ text: '### Hello',
|
|
|
|
# context: { cache_key: [note, :note] } }]
|
2016-07-19 09:05:22 -04:00
|
|
|
def cache_collection_render(texts_and_contexts)
|
2016-07-05 11:21:13 -04:00
|
|
|
items_collection = texts_and_contexts.each_with_index do |item, index|
|
|
|
|
context = item[:context]
|
|
|
|
cache_key = full_cache_multi_key(context.delete(:cache_key), context[:pipeline])
|
|
|
|
|
|
|
|
item[:cache_key] = cache_key if cache_key
|
|
|
|
end
|
|
|
|
|
|
|
|
cacheable_items, non_cacheable_items = items_collection.partition { |item| item.key?(:cache_key) }
|
2016-07-13 03:23:55 -04:00
|
|
|
|
|
|
|
items_in_cache = []
|
|
|
|
items_not_in_cache = []
|
|
|
|
|
|
|
|
unless cacheable_items.empty?
|
|
|
|
items_in_cache = Rails.cache.read_multi(*cacheable_items.map { |item| item[:cache_key] })
|
|
|
|
items_not_in_cache = cacheable_items.reject do |item|
|
|
|
|
item[:rendered] = items_in_cache[item[:cache_key]]
|
|
|
|
items_in_cache.key?(item[:cache_key])
|
|
|
|
end
|
2016-07-05 11:21:13 -04:00
|
|
|
end
|
|
|
|
|
|
|
|
(items_not_in_cache + non_cacheable_items).each do |item|
|
|
|
|
item[:rendered] = render(item[:text], item[:context])
|
|
|
|
Rails.cache.write(item[:cache_key], item[:rendered]) if item[:cache_key]
|
|
|
|
end
|
|
|
|
|
|
|
|
items_collection.map { |item| item[:rendered] }
|
|
|
|
end
|
|
|
|
|
2016-07-19 09:05:22 -04:00
|
|
|
def render_result(text, context = {})
|
2016-06-21 11:07:17 -04:00
|
|
|
text = Pipeline[:pre_process].to_html(text, context) if text
|
2015-12-15 09:51:16 -05:00
|
|
|
|
2016-06-21 11:07:17 -04:00
|
|
|
Pipeline[context[:pipeline]].call(text, context)
|
2016-02-21 19:21:28 -05:00
|
|
|
end
|
|
|
|
|
2015-12-15 09:51:16 -05:00
|
|
|
# Perform post-processing on an HTML String
|
|
|
|
#
|
|
|
|
# This method is used to perform state-dependent changes to a String of
|
|
|
|
# HTML, such as removing references that the current user doesn't have
|
|
|
|
# permission to make (`RedactorFilter`).
|
|
|
|
#
|
|
|
|
# html - String to process
|
|
|
|
# context - Hash of options to customize output
|
|
|
|
# :pipeline - Symbol pipeline type
|
|
|
|
# :project - Project
|
|
|
|
# :user - User object
|
|
|
|
#
|
|
|
|
# Returns an HTML-safe String
|
2016-07-19 09:05:22 -04:00
|
|
|
def post_process(html, context)
|
2015-12-15 09:51:16 -05:00
|
|
|
context = Pipeline[context[:pipeline]].transform_context(context)
|
|
|
|
|
|
|
|
pipeline = Pipeline[:post_process]
|
|
|
|
if context[:xhtml]
|
|
|
|
pipeline.to_document(html, context).to_html(save_with: Nokogiri::XML::Node::SaveOptions::AS_XHTML)
|
|
|
|
else
|
|
|
|
pipeline.to_html(html, context)
|
|
|
|
end.html_safe
|
|
|
|
end
|
|
|
|
|
|
|
|
private
|
|
|
|
|
2016-07-19 09:05:22 -04:00
|
|
|
def cacheless_render(text, context = {})
|
2016-04-11 11:42:12 -04:00
|
|
|
Gitlab::Metrics.measure(:banzai_cacheless_render) do
|
|
|
|
result = render_result(text, context)
|
2015-12-15 09:51:16 -05:00
|
|
|
|
2016-04-11 11:42:12 -04:00
|
|
|
output = result[:output]
|
|
|
|
if output.respond_to?(:to_html)
|
|
|
|
output.to_html
|
|
|
|
else
|
|
|
|
output.to_s
|
|
|
|
end
|
2015-12-15 09:51:16 -05:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2016-07-19 09:05:22 -04:00
|
|
|
def full_cache_key(cache_key, pipeline_name)
|
2015-12-15 09:51:16 -05:00
|
|
|
return unless cache_key
|
|
|
|
["banzai", *cache_key, pipeline_name || :full]
|
|
|
|
end
|
2016-07-05 11:21:13 -04:00
|
|
|
|
|
|
|
# To map Rails.cache.read_multi results we need to know the Rails.cache.expanded_key.
|
|
|
|
# Other option will be to generate stringified keys on our side and don't delegate to Rails.cache.expanded_key
|
|
|
|
# method.
|
2016-07-19 09:05:22 -04:00
|
|
|
def full_cache_multi_key(cache_key, pipeline_name)
|
2016-07-05 11:21:13 -04:00
|
|
|
return unless cache_key
|
|
|
|
Rails.cache.send(:expanded_key, full_cache_key(cache_key, pipeline_name))
|
|
|
|
end
|
2015-12-15 09:51:16 -05:00
|
|
|
end
|
|
|
|
end
|