schema_dot_org 1.7.1 → 2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 125273e4c13ee100e668d7aad12d40379c51773968c50013fe21845fc2d60cb6
-  data.tar.gz: e27714ef970a5320827c7250e504050c97d58a5d8a2acea7aa589a81797a4729
+  metadata.gz: 643f2d209ee7cac02447c46cc8f5c14682163dd171db5d3c1b5fdf84382a3eab
+  data.tar.gz: cab0857ac26be75638701893e328db0a93840a368b46df5e5e6a106ccb98f3be
 SHA512:
-  metadata.gz: 7bb7ef8ca7d109793ebec2c79de1931855f7cff07f5751c5d7d6b7bc1a09ac4d431aa254c834f356e968ea4aae3f259765cf33e734701b836f69240cb7da6cb8
-  data.tar.gz: 6894a06c5bad02000c1de3e2d4aa4171c18f76d417d82ce52b783bcb7ee90d315742d1b879b88a3f728515877b704b980b87e25b962bf85b706ee7f958e6344e
+  metadata.gz: 69e7822b9097e10d3a4d51053f32982fddde76ffcccd3f611474d08c6ef890dc31a16cd3bcf14d6420b592ff80fff756b8737f733a0e57c1ffcc0be925772025
+  data.tar.gz: 65e88820be2cdedb39aee20ca85bc14e1866b64a2737323076bba3d18d39184cc37b192edfbc65ba5ba1b194de0f9339fece13fb1e7fdd7d72e755bf3442e800

data/Gemfile.lock

@@ -1,67 +1,65 @@
 PATH
   remote: .
   specs:
-    schema_dot_org (1.7.0)
-      sorbet-runtime (>= 0.5.5890)
-      validated_object (~> 2.1)
+    schema_dot_org (2.0)
+      validated_object (~> 2.2)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activemodel (6.1.4)
-      activesupport (= 6.1.4)
-    activesupport (6.1.4)
+    activemodel (7.1.1)
+      activesupport (= 7.1.1)
+    activesupport (7.1.1)
+      base64
+      bigdecimal
       concurrent-ruby (~> 1.0, >= 1.0.2)
+      connection_pool (>= 2.2.5)
+      drb
       i18n (>= 1.6, < 2)
       minitest (>= 5.1)
+      mutex_m
       tzinfo (~> 2.0)
-      zeitwerk (~> 2.3)
-    concurrent-ruby (1.1.9)
-    diff-lcs (1.4.4)
-    i18n (1.8.10)
+    base64 (0.1.1)
+    bigdecimal (3.1.4)
+    concurrent-ruby (1.2.2)
+    connection_pool (2.4.1)
+    diff-lcs (1.5.0)
+    drb (2.1.1)
+      ruby2_keywords
+    i18n (1.14.1)
       concurrent-ruby (~> 1.0)
-    minitest (5.14.4)
-    rake (13.0.5)
-    rspec (3.10.0)
-      rspec-core (~> 3.10.0)
-      rspec-expectations (~> 3.10.0)
-      rspec-mocks (~> 3.10.0)
-    rspec-core (3.10.1)
-      rspec-support (~> 3.10.0)
-    rspec-expectations (3.10.1)
+    minitest (5.20.0)
+    mutex_m (0.1.2)
+    rake (13.0.6)
+    rspec (3.12.0)
+      rspec-core (~> 3.12.0)
+      rspec-expectations (~> 3.12.0)
+      rspec-mocks (~> 3.12.0)
+    rspec-core (3.12.2)
+      rspec-support (~> 3.12.0)
+    rspec-expectations (3.12.3)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.10.0)
-    rspec-mocks (3.10.2)
+      rspec-support (~> 3.12.0)
+    rspec-mocks (3.12.6)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.10.0)
-    rspec-support (3.10.2)
-    sorbet (0.5.6485)
-      sorbet-static (= 0.5.6485)
-    sorbet-runtime (0.5.6485)
-    sorbet-static (0.5.6485-universal-darwin-14)
-    sorbet-static (0.5.6485-universal-darwin-15)
-    sorbet-static (0.5.6485-universal-darwin-16)
-    sorbet-static (0.5.6485-universal-darwin-17)
-    sorbet-static (0.5.6485-universal-darwin-18)
-    sorbet-static (0.5.6485-universal-darwin-19)
-    sorbet-static (0.5.6485-universal-darwin-20)
-    sorbet-static (0.5.6485-x86_64-linux)
-    tzinfo (2.0.4)
+      rspec-support (~> 3.12.0)
+    rspec-support (3.12.1)
+    ruby2_keywords (0.0.5)
+    sorbet-runtime (0.5.10993)
+    tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
-    validated_object (2.1.0)
+    validated_object (2.2.0)
       activemodel (>= 3.2.21)
       sorbet-runtime (>= 0.5.5890)
-    zeitwerk (2.4.2)
 
 PLATFORMS
-  ruby
+  arm64-darwin-22
 
 DEPENDENCIES
-  bundler (~> 2)
-  rake (>= 12.3.3)
-  rspec (~> 3.0)
+  bundler (~> 2.4)
+  rake (~> 13.0)
+  rspec (~> 3.12)
   schema_dot_org!
-  sorbet (>= 0.5.5890)
 
 BUNDLED WITH
-   2.2.15
+   2.4.20

data/README.md

@@ -2,7 +2,7 @@
 
 # SchemaDotOrg
 
-Let's create [Structured Data](https://developers.google.com/search/docs/guides/intro-structured-data) with correct **syntax** and **semantics**,
+Create [Structured Data](https://developers.google.com/search/docs/guides/intro-structured-data) with correct **syntax** and **semantics**,
 every single time. Good structured data [helps enhance a website's search result appearance](https://developers.google.com/search/docs/guides/enhance-site).
 
 > Google Search works hard to understand the content of a page. You can help us by providing explicit clues about the meaning of a page . . .

data/bin/tapioca

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'tapioca' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require "pathname"
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+bundle_binstub = File.expand_path("../bundle", __FILE__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300) =~ /This file was generated by Bundler/
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("tapioca", "tapioca")

data/lib/schema_dot_org/aggregate_offer.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require 'date'
+require 'schema_dot_org'
+require 'schema_dot_org/offer'
+
+# Model the Schema.org `Thing > Place`.  See https://schema.org/Offer
+#
+module SchemaDotOrg
+  class AggregateOffer < SchemaType
+    attr_accessor :priceCurrency,
+                  :highPrice,
+                  :lowPrice,
+                  :offerCount,
+                  :offers
+
+    validates :lowPrice,       type: Numeric
+    validates :highPrice,      type: Numeric, allow_nil: true
+    validates :offerCount,     type: String, allow_nil: true
+    validates :offers,         type: Array, allow_nil: true
+
+    def _to_json_struct
+      {
+        "priceCurrency" => priceCurrency,
+        "lowPrice" => lowPrice,
+        "highPrice" => highPrice,
+        "offerCount" => offerCount,
+        "offers" => offers.map(&:to_json_struct)
+      }
+    end
+
+    def offers
+      @offers || []
+    end
+  end
+end

data/lib/schema_dot_org/contact_point.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require 'schema_dot_org'
+
+
+module SchemaDotOrg
+  # Model the Schema.org `ContactPoint`.  See http://schema.org/ContactPoint
+  class ContactPoint < SchemaType
+    attr_accessor :telephone,
+                  :contact_type,
+                  :contact_option,
+                  :area_served,
+                  :available_language
+
+    validates :telephone,           type: String, presence: true
+    validates :contact_type,        type: String, presence: true
+    validates :contact_option,      type: String, allow_nil: true
+    validates :area_served,         type: Array, allow_nil: true
+    validates :available_language,  type: Array, allow_nil: true
+
+    def _to_json_struct
+      {
+        'telephone' => telephone,
+        'contactType' => contact_type,
+        'contactOption' => contact_option,
+        'areaServed' => area_served,
+        'availableLanguage' => available_language
+      }
+    end
+  end
+end

data/lib/schema_dot_org/item_list.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require 'schema_dot_org'
+
+module SchemaDotOrg
+  # Model the Schema.org `ItemList`.  See https://schema.org/ItemList
+  class ItemList < SchemaType
+    attr_accessor :itemListOrder,
+                  :numberOfItems,
+                  :url,
+                  :image,
+                  :itemListElement
+
+    
+    validates :itemListElement,   type: Array,    presence: true
+    validates :itemListOrder,     type: String,   allow_nil: true
+    validates :numberOfItems,     type: Integer,  allow_nil: true
+
+    validates :url,               type: String,   allow_nil: true
+    validates :image,             type: String,   allow_nil: true
+
+
+    def _to_json_struct
+      {
+        'itemListOrder' => itemListOrder,
+        'numberOfItems' => numberOfItems,
+        'url' => url,
+        'image' => image,
+        'itemListElement' => itemListElement.map(&:to_json_struct)
+      }
+    end
+
+    def itemListElement
+      @itemListElement || []
+    end
+  end
+end

data/lib/schema_dot_org/list_item.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require 'schema_dot_org'
+require 'schema_dot_org/product'
+
+
+module SchemaDotOrg
+  # Model the Schema.org `ItemListElement`.  See https://schema.org/ItemListElement
+  class ListItem < SchemaType
+    attr_accessor :position, :item,
+                  :url, :name, :image
+
+    validates :position,      type: Integer, presence: true
+    validates :url,           type: String, allow_nil: true
+    validates :name,          type: String, allow_nil: true
+    validates :image,         type: String, allow_nil: true
+
+    validates :item,         type: Product, allow_nil: true
+
+    def _to_json_struct
+      {
+        'position' => position,
+        'url' => url,
+        'name' => name,
+        'image' => image,
+        'item' => object_to_json_struct(item)
+      }
+    end
+  end
+end

data/lib/schema_dot_org/offer.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require 'date'
+require 'schema_dot_org'
+
+# Model the Schema.org `Thing > Place`.  See https://schema.org/Offer
+#
+module SchemaDotOrg
+  class Offer < SchemaType
+    attr_accessor :priceCurrency,
+                  :price,
+                  :availability,
+                  :url
+
+    validates :priceCurrency,       type: String
+    validates :price,               type: Numeric
+    validates :availability,        type: String, allow_nil: true
+    validates :url,                 type: String, allow_nil: true
+
+    def _to_json_struct
+      {
+        "price" => price,
+        "priceCurrency" => priceCurrency,
+        "availability" => availability,
+        "url" => url
+      }
+    end
+  end
+end

data/lib/schema_dot_org/organization.rb

@@ -1,10 +1,11 @@
-# typed: ignore
 # frozen_string_literal: true
 
 require 'date'
 require 'schema_dot_org'
 require 'schema_dot_org/person'
 require 'schema_dot_org/place'
+require 'schema_dot_org/contact_point'
+
 
 module SchemaDotOrg
   class Organization < SchemaType
@@ -15,28 +16,35 @@ module SchemaDotOrg
                   :logo,
                   :name,
                   :url,
-                  :same_as
+                  :same_as,
+                  :contact_points
 
-    validates :email,             type: String
-    validates :founder,           type: SchemaDotOrg::Person
-    validates :founding_date,     type: Date
-    validates :founding_location, type: SchemaDotOrg::Place
+    validates :email,             type: String, allow_nil: true
+    validates :founder,           type: SchemaDotOrg::Person, allow_nil: true
+    validates :founding_date,     type: Date, allow_nil: true
+    validates :founding_location, type: SchemaDotOrg::Place, allow_nil: true
     validates :logo,              type: String
     validates :name,              type: String
     validates :url,               type: String
     validates :same_as,           type: Array, allow_nil: true
+    validates :contact_points,    type: Array, allow_nil: true
 
     def _to_json_struct
       {
-        'name' => name,
-        'email' => email,
-        'url' => url,
-        'logo' => logo,
-        'founder' => founder.to_json_struct,
-        'foundingDate' => founding_date.to_s,
-        'foundingLocation' => founding_location.to_json_struct,
-        'sameAs' => same_as
+        "name" => name,
+        "email" => email,
+        "url" => url,
+        "logo" => logo,
+        "founder" => object_to_json_struct(founder),
+        "foundingDate" => founding_date.to_s,
+        "foundingLocation" => object_to_json_struct(founding_location),
+        "sameAs" => same_as,
+        "contactPoint" => contact_points.map(&:to_json_struct)
       }
     end
+
+    def contact_points
+      @contact_points || []
+    end
   end
 end

data/lib/schema_dot_org/person.rb

@@ -1,17 +1,22 @@
-# typed: ignore
 # frozen_string_literal: true
 
-require 'schema_dot_org'
 
 module SchemaDotOrg
   # Model the Schema.org `Person`.  See http://schema.org/Person
   class Person < SchemaType
-    attr_accessor :name
-    validates :name, type: String, presence: true
+    attr_accessor :name,
+                  :url,
+                  :same_as
+
+    validates :name,    type: String, presence: true
+    validates :url,     type: String, allow_nil: true
+    validates :same_as, type: Array, allow_nil: true
 
     def _to_json_struct
       {
-        'name' => name
+        'name' => name,
+        'url' => url,
+        'same_as' => same_as
       }
     end
   end

data/lib/schema_dot_org/place.rb

@@ -1,7 +1,5 @@
-# typed: ignore
 # frozen_string_literal: true
 
-require 'schema_dot_org'
 
 module SchemaDotOrg
   # Model the Schema.org `Thing > Place`.  See http://schema.org/Place

data/lib/schema_dot_org/product.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require 'date'
+require 'schema_dot_org'
+require 'schema_dot_org/aggregate_offer'
+
+# Model the Schema.org `Thing > Place`.  See https://schema.org/Product
+#
+module SchemaDotOrg
+  class Product < SchemaType
+    attr_accessor :name,
+                  :url,
+                  :description,
+                  :image,
+                  :offers
+
+    validates :name,              type: String
+    validates :url,               type: String
+    validates :description,       type: String, allow_nil: true
+    validates :image,             type: Array, allow_nil: true
+    validates :offers,            type: SchemaDotOrg::AggregateOffer
+
+    def _to_json_struct
+      {
+        "name" => name,
+        "url" => url,
+        "description" => description,
+        "image" => image,
+        "offers" => offers.to_json_struct
+      }
+    end
+
+    def image
+      @image || []
+    end
+  end
+end

data/lib/schema_dot_org/schema_type.rb

@@ -0,0 +1,67 @@
+require 'json'
+require 'validated_object'
+
+module SchemaDotOrg
+  class SchemaType < ValidatedObject::Base
+    ROOT_ATTR = { "@context" => "http://schema.org" }.freeze
+    UNQUALIFIED_CLASS_NAME_REGEX = /([^:]+)$/
+
+
+    def to_s
+      json_string = to_json_ld(pretty: (!rails_production? && !ENV['SCHEMA_DOT_ORG_MINIFIED_JSON']))
+
+      # Mark as safe if we're in Rails
+      if json_string.respond_to?(:html_safe)
+        json_string.html_safe
+      else
+        json_string
+      end
+    end
+
+
+    def to_json_ld(pretty: false)
+      "<script type=\"application/ld+json\">\n" + to_json(pretty: pretty, as_root: true) + "\n</script>"
+    end
+
+
+    def to_json(pretty: false, as_root: false)
+      structure = as_root ? ROOT_ATTR.merge(to_json_struct) : to_json_struct
+
+      if pretty
+        JSON.pretty_generate(structure)
+      else
+        structure.to_json
+      end
+    end
+
+
+    # Use the class name to create the "@type" attribute.
+    # @return a hash structure representing json.
+    def to_json_struct
+      { "@type" => un_namespaced_classname }.merge(_to_json_struct.reject { |_, v| v.blank? })
+    end
+
+
+    def _to_json_struct
+      raise "For subclasses to implement"
+    end
+
+
+    # @return the classname without the module namespace.
+    def un_namespaced_classname
+      self.class.name =~ UNQUALIFIED_CLASS_NAME_REGEX
+      Regexp.last_match(1)
+    end
+
+    def object_to_json_struct(object)
+      return nil unless object
+      object.to_json_struct
+    end
+
+    private
+
+    def rails_production?
+      defined?(Rails) && Rails.env.production?
+    end
+  end
+end

data/lib/schema_dot_org/search_action.rb

@@ -1,7 +1,5 @@
-# typed: ignore
 # frozen_string_literal: true
 
-require 'schema_dot_org'
 
 module SchemaDotOrg
   # Model the Schema.org `Thing > SearchAction`.  See http://schema.org/SearchAction

data/lib/schema_dot_org/web_site.rb

@@ -1,8 +1,5 @@
-# typed: ignore
 # frozen_string_literal: true
 
-require 'schema_dot_org'
-require 'schema_dot_org/search_action'
 
 module SchemaDotOrg
   # Model the Schema.org `Thing > CreativeWork > WebSite`.
@@ -15,9 +12,9 @@ module SchemaDotOrg
 
     def _to_json_struct
       {
-        'name' => name,
-        'url' => url,
-        'potentialAction' => potential_action&.to_json_struct
+        'name' => self.name,
+        'url' =>  self.url,
+        'potentialAction' => object_to_json_struct(potential_action)
       }
     end
   end

data/lib/schema_dot_org.rb

@@ -1,62 +1,25 @@
-# typed: ignore
 # frozen_string_literal: true
-
-require 'json'
-require 'validated_object'
+require 'schema_dot_org/schema_type'
+require 'schema_dot_org/search_action'
+require 'schema_dot_org/web_site'
+require 'schema_dot_org/organization'
+require 'schema_dot_org/product'
+require 'schema_dot_org/item_list'
+require 'schema_dot_org/list_item'
+require 'schema_dot_org/person'
+require 'schema_dot_org/place'
+require 'schema_dot_org/aggregate_offer'
+require 'schema_dot_org/offer'
+require 'schema_dot_org/contact_point'
 
 module SchemaDotOrg
-  #
-  # Base class for schema types. Refactors out common code.
-  #
-  class SchemaType < ValidatedObject::Base
-    ROOT_ATTR = { '@context' => 'http://schema.org' }.freeze
-    UNQUALIFIED_CLASS_NAME_REGEX = /([^:]+)$/.freeze
-
-    def to_s
-      json_string = to_json_ld(pretty: (!rails_production? && !ENV['SCHEMA_DOT_ORG_MINIFIED_JSON']))
-
-      # Mark as safe if we're in Rails
-      if json_string.respond_to?(:html_safe)
-        json_string.html_safe
-      else
-        json_string
-      end
-    end
-
-    def to_json_ld(pretty: false)
-      "<script type=\"application/ld+json\">\n" + to_json(pretty: pretty, as_root: true) + "\n</script>"
-    end
-
-    def to_json(pretty: false, as_root: false)
-      structure = as_root ? ROOT_ATTR.merge(to_json_struct) : to_json_struct
-
-      if pretty
-        JSON.pretty_generate(structure)
-      else
-        structure.to_json
-      end
-    end
-
-    # Use the class name to create the "@type" attribute.
-    # @return a hash structure representing json.
-    def to_json_struct
-      { '@type' => un_namespaced_classname }.merge(_to_json_struct.compact)
-    end
+end
 
-    def _to_json_struct
-      raise 'For subclasses to implement'
-    end
 
-    # @return the classname without the module namespace.
-    def un_namespaced_classname
-      self.class.name =~ UNQUALIFIED_CLASS_NAME_REGEX
-      Regexp.last_match(1)
-    end
+require 'schema_dot_org/person'
+require 'schema_dot_org/place'
 
-    private
+require 'schema_dot_org/organization'
 
-    def rails_production?
-      defined?(Rails) && Rails.env.production?
-    end
-  end
-end
+require 'schema_dot_org/search_action'
+require 'schema_dot_org/web_site'