govspeak 8.4.1 → 8.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1fee9ba67d010cc01d04d929c4995d48be18802a9cc263eb766e4fb5dd64ea04
-  data.tar.gz: 62206016e1f736157da903662d696438da0406e497d53c6dc0a2574a0cc3555c
+  metadata.gz: 23ac40c67eb46b8265549568542bc48bb0cb96fe47c8b217a1e6135789ab2134
+  data.tar.gz: 26d7a270ab0163d056c0fefff53548727019128456deab21409ee3b3ae6e01eb
 SHA512:
-  metadata.gz: 3aacba8ee80a9e26f59042d100d74611aef458e90fcdd9b0f5070eb780f25b19a7c28d549ad147afe0af66c802394b134430d5a0d568c2bfd051ef4e2b3582b2
-  data.tar.gz: 1fd96e90cb895b1e48f5b678ea63258ac092058aadaff415400785be8ed2654b8dda08975e70e9e7beba8ff5d2bd564d90cca41331e3f00b6d0d0803b8e25140
+  metadata.gz: e637261f8a573479a054e8cdcba539ed296c4c9a1d70c263ff4caea059faf80992806332922259da0d52983013a4c302a11bed5421b12534f6d1de6b105d9620
+  data.tar.gz: fa04e11f539f372793d6420f9dcdc81964d244530f3d9e397f0587ca22fac9e66e41b85d79cd224c88f187946bddeb04f9afdfe223328240c353b060bb45fba2

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+### 8.5.0
+
+* Support embeds in Govspeak
+
 ## 8.4.1
 * Do not pin version of govuk_publishing_components
 

data/README.md

@@ -608,6 +608,34 @@ will output
 </div>
 ```
 
+### Content blocks
+
+Authors can embed different types of [supported content](https://github.com/alphagov/govspeak/blob/main/lib/govspeak/embedded_content.rb#L3) created by the Content Block Manager
+
+```
+{{embed:content_block_email_address:d308f561-e5ee-45b5-90b2-3ac36a23fad9}}
+```
+
+with options provided
+
+```
+{
+  embeds: [
+    {
+      content_id: "d308f561-e5ee-45b5-90b2-3ac36a23fad9",
+      title: "Government Digital Service",
+      details: { email_address: "test@example.com" },
+    }
+  ]
+}
+```
+
+will output
+
+```html
+<span class="embed_content_block_email_address" id="embed_d308f561-e5ee-45b5-90b2-3ac36a23fad9">test@example.com</span>
+```
+
 ### Button
 
 An accessible way to add button links into content, that can also allow cross domain tracking with [Google Analytics](https://support.google.com/analytics/answer/7372977?hl=en)

data/lib/govspeak/embed_extractor.rb

@@ -0,0 +1,17 @@
+module Govspeak
+  class EmbedExtractor
+    def initialize(document)
+      @document = document
+    end
+
+    def content_references
+      @content_references ||= @document.scan(EmbeddedContent::EMBED_REGEX).map { |match|
+        EmbeddedContent.new(document_type: match[1], content_id: match[2], embed_code: match[0])
+      }.uniq
+    end
+
+    def content_ids
+      @content_ids ||= content_references.map(&:content_id)
+    end
+  end
+end

data/lib/govspeak/embedded_content.rb

@@ -0,0 +1,15 @@
+module Govspeak
+  class EmbeddedContent
+    SUPPORTED_DOCUMENT_TYPES = %w[contact content_block_email_address].freeze
+    UUID_REGEX = /([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})/
+    EMBED_REGEX = /({{embed:(#{SUPPORTED_DOCUMENT_TYPES.join('|')}):#{UUID_REGEX}}})/
+
+    attr_reader :document_type, :content_id, :embed_code
+
+    def initialize(document_type:, content_id:, embed_code:)
+      @document_type = document_type
+      @content_id = content_id
+      @embed_code = embed_code
+    end
+  end
+end

data/lib/govspeak/presenters/embed_presenter.rb

@@ -0,0 +1,32 @@
+require "action_view"
+require "htmlentities"
+
+module Govspeak
+  class EmbedPresenter
+    include ActionView::Helpers::TagHelper
+
+    attr_reader :embed
+
+    def initialize(embed)
+      @embed = ActiveSupport::HashWithIndifferentAccess.new(embed)
+    end
+
+    def content_id
+      embed[:content_id]
+    end
+
+    def document_type
+      embed[:document_type]
+    end
+
+    def render
+      body = if document_type == "content_block_email_address"
+               embed.dig(:details, :email_address)
+             else
+               embed[:title]
+             end
+
+      content_tag(:span, body, class: "embed embed-#{document_type}", id: "embed_#{content_id}")
+    end
+  end
+end

data/lib/govspeak/version.rb

@@ -1,3 +1,3 @@
 module Govspeak
-  VERSION = "8.4.1".freeze
+  VERSION = "8.5.0".freeze
 end

data/lib/govspeak.rb

@@ -14,11 +14,14 @@ require "govspeak/structured_header_extractor"
 require "govspeak/html_validator"
 require "govspeak/html_sanitizer"
 require "govspeak/blockquote_extra_quote_remover"
+require "govspeak/embed_extractor"
+require "govspeak/embedded_content"
 require "govspeak/post_processor"
 require "govspeak/link_extractor"
 require "govspeak/template_renderer"
 require "govspeak/presenters/attachment_presenter"
 require "govspeak/presenters/contact_presenter"
+require "govspeak/presenters/embed_presenter"
 require "govspeak/presenters/h_card_presenter"
 require "govspeak/presenters/image_presenter"
 require "govspeak/presenters/attachment_image_presenter"
@@ -37,7 +40,7 @@ module Govspeak
     @extensions = []
 
     attr_accessor :images
-    attr_reader :attachments, :contacts, :links, :locale
+    attr_reader :attachments, :contacts, :links, :locale, :embeds
 
     def self.to_html(source, options = {})
       new(source, options).to_html
@@ -57,6 +60,7 @@ module Govspeak
       @attachments = Array.wrap(options.delete(:attachments))
       @links = Array.wrap(options.delete(:links))
       @contacts = Array.wrap(options.delete(:contacts))
+      @embeds = Array.wrap(options.delete(:embeds))
       @locale = options.fetch(:locale, "en")
       @options = { input: PARSER_CLASS_NAME,
                    sanitize: true,
@@ -255,6 +259,13 @@ module Govspeak
       render_image(AttachmentImagePresenter.new(attachment))
     end
 
+    extension("embeds", Govspeak::EmbeddedContent::EMBED_REGEX) do |_embed_code, _document_type, content_id|
+      embed = embeds.detect { |e| e[:content_id] == content_id }
+      next "" unless embed
+
+      EmbedPresenter.new(embed).render
+    end
+
     # As of version 1.12.0 of Kramdown the block elements (div & figcaption)
     # inside this html block will have it's < > converted into HTML Entities
     # when ever this code is used inside block level elements.

data/test/embed_extractor_test.rb

@@ -0,0 +1,59 @@
+require "test_helper"
+
+class EmbedExtractorTest < Minitest::Test
+  extend Minitest::Spec::DSL
+
+  describe "EmbedExtractor" do
+    subject { Govspeak::EmbedExtractor.new(document) }
+
+    describe "when there is no embedded content" do
+      let(:document) { "foo" }
+
+      describe "#content_references" do
+        it "returns an empty array" do
+          assert_equal [], subject.content_references
+        end
+      end
+
+      describe "#content_ids" do
+        it "returns an empty array" do
+          assert_equal [], subject.content_ids
+        end
+      end
+    end
+
+    describe "when there is embedded content" do
+      let(:contact_uuid) { SecureRandom.uuid }
+      let(:content_block_email_address_uuid) { SecureRandom.uuid }
+
+      let(:document) do
+        """
+        {{embed:contact:#{contact_uuid}}}
+        {{embed:content_block_email_address:#{content_block_email_address_uuid}}}
+      """
+      end
+
+      describe "#content_references" do
+        it "returns all references" do
+          result = subject.content_references
+
+          assert_equal 2, result.count
+
+          assert_equal "contact", result[0].document_type
+          assert_equal contact_uuid, result[0].content_id
+          assert_equal "{{embed:contact:#{contact_uuid}}}", result[0].embed_code
+
+          assert_equal "content_block_email_address", result[1].document_type
+          assert_equal content_block_email_address_uuid, result[1].content_id
+          assert_equal "{{embed:content_block_email_address:#{content_block_email_address_uuid}}}", result[1].embed_code
+        end
+      end
+
+      describe "#content_ids" do
+        it "returns all uuids as an array" do
+          assert_equal [contact_uuid, content_block_email_address_uuid], subject.content_ids
+        end
+      end
+    end
+  end
+end

data/test/govspeak_embeds_test.rb

@@ -0,0 +1,84 @@
+require "test_helper"
+
+class GovspeakEmbedsTest < Minitest::Test
+  extend Minitest::Spec::DSL
+
+  def compress_html(html)
+    html.gsub(/[\n\r]+\s*/, "")
+  end
+
+  let(:content_id) { SecureRandom.uuid }
+
+  it "renders an email address when present in options[:embeds]" do
+    embed = {
+      content_id:,
+      document_type: "content_block_email_address",
+      title: "foo",
+      details: {
+        email_address: "foo@example.com",
+      },
+    }
+    govspeak = "{{embed:content_block_email_address:#{content_id}}}"
+
+    rendered = Govspeak::Document.new(govspeak, embeds: [embed]).to_html
+
+    expected = "<p><span class=\"embed embed-content_block_email_address\" id=\"embed_#{content_id}\">#{embed[:details][:email_address]}</span></p>"
+
+    assert_equal compress_html(expected), compress_html(rendered)
+  end
+
+  it "renders the title when the document type is a contact" do
+    embed = {
+      content_id:,
+      document_type: "contact",
+      title: "foo",
+    }
+    govspeak = "{{embed:contact:#{content_id}}}"
+
+    rendered = Govspeak::Document.new(govspeak, embeds: [embed]).to_html
+
+    expected = "<p><span class=\"embed embed-contact\" id=\"embed_#{content_id}\">#{embed[:title]}</span></p>"
+
+    assert_equal compress_html(expected), compress_html(rendered)
+  end
+
+  it "ignores missing embeds" do
+    govspeak = "{{embed:contact:#{content_id}}}"
+
+    rendered = Govspeak::Document.new(govspeak, embeds: []).to_html
+
+    assert_equal compress_html(""), compress_html(rendered)
+  end
+
+  it "supports multiple embeds" do
+    embeds = [
+      {
+        content_id: SecureRandom.uuid,
+        document_type: "contact",
+        title: "foo",
+      },
+      {
+        content_id: SecureRandom.uuid,
+        document_type: "content_block_email_address",
+        title: "foo",
+        details: {
+          email_address: "foo@example.com",
+        },
+      },
+    ]
+
+    govspeak = %(Here is a contact: {{embed:contact:#{embeds[0][:content_id]}}}
+
+Here is an email address: {{embed:content_block_email_address:#{embeds[1][:content_id]}}}
+    )
+
+    rendered = Govspeak::Document.new(govspeak, embeds:).to_html
+
+    expected = """
+      <p>Here is a contact: <span class=\"embed embed-contact\" id=\"embed_#{embeds[0][:content_id]}\">#{embeds[0][:title]}</span></p>
+      <p>Here is an email address: <span class=\"embed embed-content_block_email_address\" id=\"embed_#{embeds[1][:content_id]}\">#{embeds[1][:details][:email_address]}</span></p>
+    """
+
+    assert_equal compress_html(expected), compress_html(rendered)
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: govspeak
 version: !ruby/object:Gem::Version
-  version: 8.4.1
+  version: 8.5.0
 platform: ruby
 authors:
 - GOV.UK Dev
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-10-10 00:00:00.000000000 Z
+date: 2024-10-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionview
@@ -250,6 +250,8 @@ files:
 - config/address_formats.yml
 - lib/govspeak.rb
 - lib/govspeak/blockquote_extra_quote_remover.rb
+- lib/govspeak/embed_extractor.rb
+- lib/govspeak/embedded_content.rb
 - lib/govspeak/header_extractor.rb
 - lib/govspeak/html_sanitizer.rb
 - lib/govspeak/html_validator.rb
@@ -258,6 +260,7 @@ files:
 - lib/govspeak/presenters/attachment_image_presenter.rb
 - lib/govspeak/presenters/attachment_presenter.rb
 - lib/govspeak/presenters/contact_presenter.rb
+- lib/govspeak/presenters/embed_presenter.rb
 - lib/govspeak/presenters/h_card_presenter.rb
 - lib/govspeak/presenters/image_presenter.rb
 - lib/govspeak/structured_header_extractor.rb
@@ -306,12 +309,14 @@ files:
 - locales/zh-tw.yml
 - locales/zh.yml
 - test/blockquote_extra_quote_remover_test.rb
+- test/embed_extractor_test.rb
 - test/govspeak_attachment_link_test.rb
 - test/govspeak_attachment_test.rb
 - test/govspeak_attachments_image_test.rb
 - test/govspeak_attachments_inline_test.rb
 - test/govspeak_button_test.rb
 - test/govspeak_contacts_test.rb
+- test/govspeak_embeds_test.rb
 - test/govspeak_extract_contact_content_ids_test.rb
 - test/govspeak_footnote_test.rb
 - test/govspeak_images_bang_test.rb
@@ -344,18 +349,20 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.21
+rubygems_version: 3.5.22
 signing_key: 
 specification_version: 4
 summary: Markup language for single domain
 test_files:
 - test/blockquote_extra_quote_remover_test.rb
+- test/embed_extractor_test.rb
 - test/govspeak_attachment_link_test.rb
 - test/govspeak_attachment_test.rb
 - test/govspeak_attachments_image_test.rb
 - test/govspeak_attachments_inline_test.rb
 - test/govspeak_button_test.rb
 - test/govspeak_contacts_test.rb
+- test/govspeak_embeds_test.rb
 - test/govspeak_extract_contact_content_ids_test.rb
 - test/govspeak_footnote_test.rb
 - test/govspeak_images_bang_test.rb