meta-tags 2.11.0 → 2.18.0

data/lib/meta_tags/renderer.rb

@@ -26,6 +26,7 @@ module MetaTags
       render_with_normalization(tags, :description)
       render_with_normalization(tags, :keywords)
       render_refresh(tags)
+      render_canonical_link(tags)
       render_noindex(tags)
       render_alternate(tags)
       render_open_search(tags)
@@ -97,7 +98,7 @@ module MetaTags
     # @param [Array<Tag>] tags a buffer object to store tag in.
     #
     def render_noindex(tags)
-      meta_tags.extract_noindex.each do |name, content|
+      meta_tags.extract_robots.each do |name, content|
         tags << Tag.new(:meta, name: name, content: content) if content.present?
       end
     end
@@ -150,7 +151,7 @@ module MetaTags
     # @param [Array<Tag>] tags a buffer object to store tag in.
     #
     def render_links(tags)
-      [ :amphtml, :canonical, :prev, :next, :image_src ].each do |tag_name|
+      [ :amphtml, :prev, :next, :image_src, :manifest ].each do |tag_name|
         href = meta_tags.extract(tag_name)
         if href.present?
           @normalized_meta_tags[tag_name] = href
@@ -159,6 +160,19 @@ module MetaTags
       end
     end
 
+    # Renders canonical link
+    #
+    # @param [Array<Tag>] tags a buffer object to store tag in.
+    #
+    def render_canonical_link(tags)
+      href = meta_tags.extract(:canonical) # extract, so its not used anywhere else
+      return if MetaTags.config.skip_canonical_links_on_noindex && meta_tags[:noindex]
+      return if href.blank?
+
+      @normalized_meta_tags[:canonical] = href
+      tags << Tag.new(:link, rel: :canonical, href: href)
+    end
+
     # Renders complex hash objects.
     #
     # @param [Array<Tag>] tags a buffer object to store tag in.
@@ -201,16 +215,17 @@ module MetaTags
     # @param [Hash, Array, String, Symbol] content text content or a symbol reference to
     # top-level meta tag.
     #
-    def process_tree(tags, property, content, **opts)
+    def process_tree(tags, property, content, itemprop: nil, **opts)
       method = case content
                when Hash
                  :process_hash
                when Array
                  :process_array
                else
+                 iprop = itemprop
                  :render_tag
                end
-      __send__(method, tags, property, content, **opts)
+      __send__(method, tags, property, content, itemprop: iprop, **opts)
     end
 
     # Recursive method to process a hash with meta tags
@@ -220,10 +235,21 @@ module MetaTags
     # @param [Hash] content nested meta tag attributes.
     #
     def process_hash(tags, property, content, **opts)
+      itemprop = content.delete(:itemprop)
       content.each do |key, value|
-        key = key.to_s == '_' ? property : "#{property}:#{key}"
-        value = normalized_meta_tags[value] if value.kind_of?(Symbol)
-        process_tree(tags, key, value, **opts)
+        if key.to_s == '_'
+          iprop = itemprop
+          key = property
+        else
+          key = "#{property}:#{key}"
+        end
+
+        normalized_value = if value.kind_of?(Symbol)
+                             normalized_meta_tags[value]
+                           else
+                             value
+                           end
+        process_tree(tags, key, normalized_value, **opts.merge(itemprop: iprop))
       end
     end
 
@@ -243,17 +269,18 @@ module MetaTags
     # @param [String, Symbol] name a Hash or a String to render as meta tag.
     # @param [String, Symbol] value text content or a symbol reference to
     # top-level meta tag.
+    # @param [String, Symbol] itemprop value of the itemprop attribute.
     #
-    def render_tag(tags, name, value, name_key: nil, value_key: :content)
+    def render_tag(tags, name, value, itemprop: nil)
       name_key ||= configured_name_key(name)
-      tags << Tag.new(:meta, name_key => name.to_s, value_key => value) if value.present?
+      tags << Tag.new(:meta, name_key => name.to_s, content: value, itemprop: itemprop) if value.present?
     end
 
     # Returns meta tag property name for a give meta tag based on the
     # configured list of property tags in MetaTags::Configuration#property_tags.
     #
-    # @param [String, Symbol] meta tag key.
-    # @return [String] meta tag attribute name ("property" or "name").
+    # @param [String, Symbol] name tag key.
+    # @return [Symbol] meta tag attribute name (:property or :name).
     #
     def configured_name_key(name)
       is_property_tag = MetaTags.config.property_tags.any? do |tag_name|

data/lib/meta_tags/tag.rb

@@ -11,7 +11,7 @@ module MetaTags
     # @param [Hash] attributes list of HTML tag attributes
     #
     def initialize(name, attributes = {})
-      @name = name
+      @name = name.to_s
       @attributes = attributes
     end
 

data/lib/meta_tags/text_normalizer.rb

@@ -3,34 +3,34 @@
 module MetaTags
   # Module contains helpers that normalize text meta tag values.
   module TextNormalizer
-    extend self # rubocop:disable Style/ModuleFunction
+    extend self
 
     # Normalize title value.
     #
     # @param [String] site_title site title.
-    # @param [String, Array<String>] title title string.
+    # @param [Array<String>] title title string.
     # @param [String] separator a string to join title parts with.
     # @param [true,false] reverse whether title should be reversed.
-    # @return [Array<String>] array of title parts with tags removed.
+    # @return [String] title with HTML tags removed.
     #
     def normalize_title(site_title, title, separator, reverse = false)
-      title = cleanup_strings(title)
-      title.reverse! if reverse
+      clean_title = cleanup_strings(title)
+      clean_title.reverse! if reverse
 
       site_title = cleanup_string(site_title)
       separator = cleanup_string(separator, strip: false)
 
       # Truncate title and site title
-      site_title, title = truncate_title(site_title, title, separator)
+      site_title, clean_title = truncate_title(site_title, clean_title, separator)
 
       if site_title.present?
         if reverse
-          title.push(site_title)
+          clean_title.push(site_title)
         else
-          title.unshift(site_title)
+          clean_title.unshift(site_title)
         end
       end
-      safe_join(title, separator)
+      safe_join(clean_title, separator)
     end
 
     # Normalize description value.
@@ -102,7 +102,7 @@ module MetaTags
 
     # Removes HTML tags and squashes down all the spaces.
     #
-    # @param [String] string input string.
+    # @param [String, nil] string input string.
     # @return [String] input string with no HTML tags and consequent white
     # space characters squashed into a single space.
     #
@@ -110,15 +110,17 @@ module MetaTags
       return '' if string.nil?
       raise ArgumentError, 'Expected a string or an object that implements #to_str' unless string.respond_to?(:to_str)
 
-      strip_tags(string.to_str).tap do |s|
-        s.gsub!(/\s+/, ' ')
-        s.strip! if strip
-      end
+      s = strip_tags(string.to_str)
+      s = s.dup if s.frozen?
+      s.gsub!(/\s+/, ' ')
+      s.strip! if strip
+
+      s
     end
 
     # Cleans multiple strings up.
     #
-    # @param [Array<String>] strings input strings.
+    # @param [String, Array<String>] strings input string(s).
     # @return [Array<String>] clean strings.
     # @see cleanup_string
     #
@@ -147,13 +149,13 @@ module MetaTags
       )
     end
 
-    # Truncates a string to a specific limit.
+    # Truncates an array of strings to a specific limit.
     #
     # @param [Array<String>] string_array input strings.
     # @param [Integer,nil] limit characters number to truncate to.
     # @param [String] separator separator that will be used to join array later.
     # @param [String] natural_separator natural separator to truncate at.
-    # @return [String] truncated string.
+    # @return [Array<String>] truncated array of strings.
     #
     def truncate_array(string_array, limit = nil, separator = '', natural_separator = ' ')
       return string_array if limit.nil? || limit <= 0
@@ -166,14 +168,14 @@ module MetaTags
 
         if string.length > limit_left
           result << truncate(string, limit_left, natural_separator)
-          break
+          break string_array
         end
 
         length += (result.any? ? separator.length : 0) + string.length
         result << string
 
         # No more strings will fit
-        break if length + separator.length >= limit
+        break string_array if length + separator.length >= limit
       end
 
       result
@@ -186,8 +188,11 @@ module MetaTags
     end
 
     def truncate_title(site_title, title, separator)
-      if MetaTags.config.title_limit.to_i > 0 # rubocop:disable Lint/NumberConversion
-        site_title_limited_length, title_limited_length = calculate_title_limits(site_title, title, separator)
+      global_limit = MetaTags.config.title_limit.to_i # rubocop:disable Lint/NumberConversion
+      if global_limit > 0
+        site_title_limited_length, title_limited_length = calculate_title_limits(
+          site_title, title, separator, global_limit,
+        )
 
         title = title_limited_length > 0 ? truncate_array(title, title_limited_length, separator) : []
         site_title = site_title_limited_length > 0 ? truncate(site_title, site_title_limited_length) : nil
@@ -196,14 +201,14 @@ module MetaTags
       [site_title, title]
     end
 
-    def calculate_title_limits(site_title, title, separator)
+    def calculate_title_limits(site_title, title, separator, global_limit)
       # What should we truncate first: site title or page title?
       main_title = MetaTags.config.truncate_site_title_first ? title : [site_title]
 
-      main_length = main_title.map(&:length).sum + (main_title.size - 1) * separator.length
-      main_limited_length = MetaTags.config.title_limit
+      main_length = main_title.map(&:length).sum + ((main_title.size - 1) * separator.length)
+      main_limited_length = global_limit
 
-      secondary_limited_length = MetaTags.config.title_limit - (main_length > 0 ? main_length + separator.length : 0)
+      secondary_limited_length = global_limit - (main_length > 0 ? main_length + separator.length : 0)
       secondary_limited_length = [0, secondary_limited_length].max
 
       if MetaTags.config.truncate_site_title_first

data/lib/meta_tags/version.rb

@@ -2,5 +2,6 @@
 
 module MetaTags
   # Gem version.
-  VERSION = '2.11.0'
+  VERSION = '2.18.0'
+  public_constant :VERSION
 end

data/lib/meta_tags/view_helper.rb

@@ -27,7 +27,7 @@ module MetaTags
     #
     # @see #display_meta_tags
     #
-    def set_meta_tags(meta_tags = {}) # rubocop:disable Naming/AccessorMethodName
+    def set_meta_tags(meta_tags = {})
       self.meta_tags.update(meta_tags)
     end
 
@@ -97,8 +97,8 @@ module MetaTags
 
     # Set the noindex meta tag
     #
-    # @param [Boolean, String] noindex a noindex value.
-    # @return [Boolean, String] passed value.
+    # @param [Boolean, String, Array<String>] noindex a noindex value.
+    # @return [Boolean, String, Array<String>] passed value.
     #
     # @example
     #   noindex true
@@ -113,8 +113,8 @@ module MetaTags
 
     # Set the nofollow meta tag
     #
-    # @param [Boolean, String] nofollow a nofollow value.
-    # @return [Boolean, String] passed value.
+    # @param [Boolean, String, Array<String>] nofollow a nofollow value.
+    # @return [Boolean, String, Array<String>] passed value.
     #
     # @example
     #   nofollow true
@@ -205,7 +205,5 @@ module MetaTags
     def display_title(defaults = {})
       @meta_tags.full_title(defaults)
     end
-
-    # safe_helper :display_meta_tags if defined?(:safe_helper)
   end
 end

data/lib/meta_tags.rb

@@ -1,8 +1,7 @@
 # frozen_string_literal: true
 
-require 'English'
-require 'action_controller'
-require 'action_view'
+require 'set'
+require 'active_support/core_ext/hash/indifferent_access'
 
 # MetaTags gem namespace.
 module MetaTags
@@ -36,5 +35,4 @@ require 'meta_tags/content_tag'
 require 'meta_tags/text_normalizer'
 require 'meta_tags/view_helper'
 
-ActionView::Base.include MetaTags::ViewHelper
-ActionController::Base.include MetaTags::ControllerHelper
+require 'meta_tags/railtie' if defined?(Rails)

data/meta-tags.gemspec

@@ -12,21 +12,32 @@ Gem::Specification.new do |spec|
 
   spec.summary       = "Collection of SEO helpers for Ruby on Rails."
   spec.description   = "Search Engine Optimization (SEO) plugin for Ruby on Rails applications."
-  spec.homepage      = "http://github.com/kpumuk/meta-tags"
+  spec.homepage      = "https://github.com/kpumuk/meta-tags"
   spec.license       = "MIT"
   spec.platform      = Gem::Platform::RUBY
+  spec.required_ruby_version = '>= 2.6.0'
 
   spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(\.|(bin|test|spec|features)/)}) }
   spec.bindir        = "exe"
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_dependency "actionpack", ">= 3.2.0", "< 5.3"
+  spec.add_dependency "actionpack", ">= 3.2.0", "< 7.1"
 
-  spec.add_development_dependency "rake", "~> 12.0"
-  spec.add_development_dependency "rspec", "~> 3.8.0"
+  spec.add_development_dependency "railties", ">= 3.2.0", "< 7.1"
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "rspec", "~> 3.11.0"
   spec.add_development_dependency "rspec-html-matchers", "~> 0.9.1"
 
   spec.cert_chain    = ["certs/kpumuk.pem"]
   spec.signing_key   = File.expand_path("~/.ssh/gem-kpumuk.pem") if $PROGRAM_NAME.end_with?('gem')
+
+  spec.metadata = {
+    "bug_tracker_uri"       => "https://github.com/kpumuk/meta-tags/issues/",
+    "changelog_uri"         => "https://github.com/kpumuk/meta-tags/blob/main/CHANGELOG.md",
+    "documentation_uri"     => "https://rubydoc.info/github/kpumuk/meta-tags/",
+    "homepage_uri"          => "https://github.com/kpumuk/meta-tags/",
+    "source_code_uri"       => "https://github.com/kpumuk/meta-tags/",
+    "rubygems_mfa_required" => "true",
+  }
 end

data/sig/lib/_internal/rails.rbs

@@ -0,0 +1,56 @@
+class ::Hash[unchecked out K, unchecked out V]
+  def with_indifferent_access: () -> ActiveSupport::HashWithIndifferentAccess[K, V]
+  def deep_merge!: (instance | ActiveSupport::HashWithIndifferentAccess[K, V] other) -> self
+end
+
+class ::Object
+  def presence: () -> self?
+  def blank?: () -> bool
+  def present?: () -> bool
+end
+
+class ::Loofah
+  module TextBehavior
+    def text: (?Hash[Symbol, untyped]? options) -> String
+  end
+
+  class DocumentFragment
+    include TextBehavior
+  end
+
+  def self.fragment: (String tags, ?String? encoding) -> DocumentFragment
+end
+
+class ::Rails
+end
+
+module ActionController
+  class Base
+    include _ActionControllerBase
+
+    def self.helpers: () -> _ActionViewBase
+  end
+end
+
+module ActiveSupport
+  class HashWithIndifferentAccess[unchecked out K, unchecked out V] < Hash[K, V]
+    def with_indifferent_access: () -> self
+    def deep_merge!: (instance | Hash[K, V] other) -> self
+  end
+end
+
+interface _ActionControllerBase
+  def render: (*untyped args) { () -> untyped } -> untyped
+end
+
+interface _ActionViewBase
+  def tag: (String name, ?Hash[String | Symbol, untyped] options, ?bool open) -> void
+
+  def content_tag: (String name, String content, ?Hash[String | Symbol, untyped] options, ?bool open) -> void
+
+  def safe_join: (Array[String], String) -> String
+
+  def truncate: (String text, ?Hash[Symbol, untyped] options) -> String
+
+  def strip_tags: (String html) -> String
+end

data/sig/lib/meta_tags/configuration.rbs

@@ -0,0 +1,19 @@
+module MetaTags
+  class Configuration
+    attr_accessor title_limit: Integer?
+    attr_accessor truncate_site_title_first: bool
+    attr_accessor description_limit: Integer
+    attr_accessor keywords_limit: Integer
+    attr_accessor keywords_separator: String
+    attr_accessor keywords_lowercase: bool
+    attr_accessor open_meta_tags: bool
+    attr_accessor minify_output: bool
+    attr_reader property_tags: Array[String | Symbol]
+    attr_accessor skip_canonical_links_on_noindex: bool
+
+    def initialize: () -> void
+    def default_property_tags: () -> Array[String | Symbol]
+    def open_meta_tags?: () -> bool
+    def reset_defaults!: () -> void
+  end
+end

data/sig/lib/meta_tags/content_tag.rbs

@@ -0,0 +1,5 @@
+module MetaTags
+  class ContentTag < Tag
+    def render: (_ActionViewBase view) -> untyped
+  end
+end

data/sig/lib/meta_tags/controller_helper.rbs

@@ -0,0 +1,13 @@
+module MetaTags
+  module ControllerHelper : _ActionControllerBase
+    @page_title: String?
+    @page_description: String?
+    @page_keywords: String? | Array[String]
+
+    def render: (*untyped args) { () -> untyped } -> untyped
+
+    def set_meta_tags: (ViewHelper::meta_tags | (_MetaTagish & Object) meta_tags) -> void
+
+    def meta_tags: () -> MetaTagsCollection
+  end
+end

data/sig/lib/meta_tags/meta_tags_collection.rbs

@@ -0,0 +1,41 @@
+module MetaTags
+  class MetaTagsCollection
+    attr_reader meta_tags: Hash[String | Symbol, untyped]
+
+    def initialize: () -> void
+
+    def []: (String | Symbol name) -> untyped
+
+    def []=: (String | Symbol name, untyped value) -> untyped
+
+    def update: (?::Hash[String | Symbol, untyped] | (_MetaTagish & Object) object) -> Hash[String | Symbol, untyped]
+
+    def with_defaults: (?::Hash[String | Symbol, untyped] defaults) { () -> untyped } -> untyped
+
+    def full_title: (?::Hash[String | Symbol, untyped] defaults) -> String
+
+    def page_title: (?::Hash[String | Symbol, untyped] defaults) -> String
+
+    def extract: (String | Symbol name) -> untyped
+
+    def delete: (*String | Symbol names) -> void
+
+    def extract_full_title: () -> String
+
+    def extract_title: () -> Array[String | (_Stringish & Object)]
+
+    def extract_separator: () -> String
+
+    def extract_robots: () -> Hash[String, String]
+
+    def normalize_open_graph: (Hash[String | Symbol, untyped] meta_tags) -> ActiveSupport::HashWithIndifferentAccess[String | Symbol, untyped]
+
+    def extract_separator_section: (String | Symbol name, String default) -> String
+
+    def extract_robots_attribute: (String | Symbol name) -> [String | Array[String | Symbol], String?]
+
+    def calculate_robots_attributes: (untyped result, untyped attributes) -> untyped
+
+    def apply_robots_value: (untyped result, untyped name, untyped value, untyped processed) -> (nil | untyped)
+  end
+end

data/sig/lib/meta_tags/renderer.rbs

@@ -0,0 +1,50 @@
+module MetaTags
+  class Renderer
+    type meta_key = String | Symbol
+    type meta_value = Hash[meta_key, meta_value] | Array[meta_value] | meta_content
+    type meta_content = String? | Symbol | Integer | bool | (_Timish & Object) | (_Stringish & Object)
+
+    attr_reader meta_tags: MetaTagsCollection
+    attr_reader normalized_meta_tags: Hash[Symbol, meta_value]
+
+    def initialize: (MetaTagsCollection meta_tags) -> void
+
+    def render: (_ActionViewBase view) -> String
+
+    def render_charset: (Array[Tag] tags) -> void
+
+    def render_title: (Array[Tag] tags) -> void
+
+    def render_icon: (Array[Tag] tags) -> void
+
+    def render_with_normalization: (Array[Tag] tags, Symbol name) -> void
+
+    def render_noindex: (Array[Tag] tags) -> void
+
+    def render_refresh: (Array[Tag] tags) -> void
+
+    def render_alternate: (Array[Tag] tags) -> void
+
+    def render_open_search: (Array[Tag] tags) -> void
+
+    def render_links: (Array[Tag] tags) -> void
+
+    def render_canonical_link: (Array[Tag] tags) -> void
+
+    def render_hashes: (Array[Tag] tags, **untyped opts) -> void
+
+    def render_hash: (Array[Tag] tags, untyped key, **untyped opts) -> void
+
+    def render_custom: (Array[Tag] tags) -> void
+
+    def process_tree: (Array[Tag] tags, meta_key property, meta_value content, ?itemprop: meta_key? itemprop, **untyped opts) -> void
+
+    def process_hash: (Array[Tag] tags, meta_key property, Hash[meta_key, meta_value] content, **untyped opts) -> void
+
+    def process_array: (Array[Tag] tags, meta_key property, Array[meta_value] content, **untyped opts) -> void
+
+    def render_tag: (Array[Tag] tags, meta_key name, meta_content value, ?itemprop: meta_key? itemprop) -> void
+
+    def configured_name_key: (meta_key name) -> Symbol
+  end
+end

data/sig/lib/meta_tags/tag.rbs

@@ -0,0 +1,12 @@
+module MetaTags
+  class Tag
+    attr_reader name: String
+    attr_reader attributes: Hash[String | Symbol, untyped]
+
+    def initialize: (String | Symbol name, ?Hash[String | Symbol, untyped] attributes) -> void
+
+    def render: (_ActionViewBase view) -> void
+
+    def prepare_attributes: (Hash[String | Symbol, untyped] attributes) -> Hash[String | Symbol, untyped]
+  end
+end

data/sig/lib/meta_tags/text_normalizer.rbs

@@ -0,0 +1,36 @@
+module MetaTags
+  module TextNormalizer
+    extend ::MetaTags::TextNormalizer
+
+    type keyword = String? | (_Stringish & Object)
+    type keywords = keyword | Array[keywords]
+
+    def normalize_title: (String? site_title, keywords title, String separator, ?bool reverse) -> String
+
+    def normalize_description: (keyword description) -> String
+
+    def normalize_keywords: (keywords keywords) -> String
+
+    def helpers: () -> _ActionViewBase
+
+    def strip_tags: (String string) -> String
+
+    def safe_join: (Array[String] array, ?String sep) -> String
+
+    def cleanup_string: (keyword string, ?strip: bool strip) -> String
+
+    def cleanup_strings: (keywords? strings, ?strip: bool strip) -> Array[String]
+
+    def truncate: (String string, ?Integer? limit, ?String natural_separator) -> String
+
+    def truncate_array: (Array[String] string_array, ?Integer? limit, ?String separator, ?String natural_separator) -> Array[String]
+
+    private
+
+    def calculate_limit_left: (Integer limit, Integer length, Array[String] result, String separator) -> untyped
+
+    def truncate_title: (String site_title, Array[String] title, String separator) -> ::Array[untyped]
+
+    def calculate_title_limits: (String site_title, Array[String] title, String separator, Integer global_limit) -> untyped
+  end
+end

data/sig/lib/meta_tags/version.rbs

@@ -0,0 +1,4 @@
+module MetaTags
+  # Gem version.
+  VERSION: ::String
+end

data/sig/lib/meta_tags/view_helper.rbs

@@ -0,0 +1,55 @@
+module MetaTags
+  module ViewHelper : Module, _ActionViewBase
+    # type meta_tags = {
+    #     site: String?,
+    #     title: Array[String] | String?,
+    #     description: String?,
+    #     keywords: Array[String] | String?,
+    #     charset: String,
+    #     prefix: String,
+    #     separator: String,
+    #     suffix: String,
+    #     lowercase: bool,
+    #     reverse: bool,
+    #     noindex: bool | String | Array[String],
+    #     index: bool | String | Array[String],
+    #     nofollow: bool | String | Array[String],
+    #     follow: bool | String | Array[String],
+    #     noarchive: bool | String | Array[String],
+    #     canonical: String,
+    #     prev: String,
+    #     next: String,
+    #     image_src: String,
+    #     alternate: String,
+    #     amphtml: String,
+    #     manifest: String,
+    #     og: Hash[Renderer::meta_key, Renderer::meta_value],
+    #     twitter: Hash[Renderer::meta_key, Renderer::meta_value],
+    #     open_search: Hash[Renderer::meta_key, Renderer::meta_value],
+    #     article: Hash[Renderer::meta_key, Renderer::meta_value],
+    #     al: Hash[Renderer::meta_key, Renderer::meta_value],
+    #     refresh: Integer | String | nil,
+    #   } & Hash[Renderer::meta_key, Renderer::meta_value]
+    type meta_tags = Hash[Renderer::meta_key, Renderer::meta_value]
+
+    def meta_tags: () -> MetaTagsCollection
+
+    def set_meta_tags: (?meta_tags | (_MetaTagish&Object) meta_tags) -> void
+
+    def title: (?String? title, ?::String? headline) -> String
+
+    def keywords: (Array[String] | String? keywords) -> (Array[String] | String?)
+
+    def description: (String? description) -> String?
+
+    def noindex: (?String | Array[String] | bool noindex) -> (String | bool | Array[String])
+
+    def nofollow: (?String | Array[String] | bool nofollow) -> (String | bool | Array[String])
+
+    def refresh: (String? | Integer? refresh) -> (String? | Integer?)
+
+    def display_meta_tags: (?meta_tags defaults) -> String
+
+    def display_title: (?meta_tags defaults) -> String
+  end
+end