schema_dot_org 2.5.0 → 2.5.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eba4af5a8f17ea83c93f00956aeb53733a629a2a7dff60a20774f52b4682c5a2
-  data.tar.gz: a7f134544c69e830613e9004ac8bee7e8944637270f0f39c569d91cbd2fe1cef
+  metadata.gz: acd0a2dabb408489cf628e16e4eaee549a84e62cd44493ee9e052707036ed059
+  data.tar.gz: a39970f8606e31d91d3a0dc9bba358964d8b8ea368855a347d9466227bb4c0d2
 SHA512:
-  metadata.gz: f840e728482eca79bca2035002fb6f1cd47fb5b41e54ec823ea17dfd6ad2988f9c51d7b82414004a39d3637ae56c80509bf2425cf4373854d00a469e35daa284
-  data.tar.gz: a06b1d8b8da895c7713ded7a913d6ee069ff7205ae3f4f3fe13b25bf6f6c7ee2af98fac885d761889b1a09a136f31e37c68bd4295c8ee324917558c6a6c40cca
+  metadata.gz: 394de4b9c3cee09e40c831ee6654c14cf3b73d262c50927e2fb13b1c7e121c7b97f2f740895786ab00ab4ff1d7c01bfd132234bf48149420f81ac365c4749a79
+  data.tar.gz: 0aa3cb2bc48156361491d51419659b4504ad8b1016440763ffb8756b4936ca2375fb3f68255c389424ff1534afd39e8336397a894bbb91aff612eb7184330336

data/CHANGELOG.md

@@ -0,0 +1,11 @@
+## 2.5.2
+
+* Improved code comments
+
+## 2.5.1
+
+* New Type: PostalAddress
+* Add PostalAddress to Organization.address
+* Add PostalAddress to Place.address
+* Add support for type unions
+* Add support for typed arrays

data/CLAUDE.md

@@ -0,0 +1,91 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Overview
+
+This is a Ruby gem that generates structured data (JSON-LD) for Schema.org types. It provides strongly-typed Ruby classes that validate their attributes and output valid Schema.org markup for SEO and search enhancement.
+
+## Development Commands
+
+### Testing
+- `bundle exec rake spec` or `bundle exec rspec` - Run all RSpec tests
+- `bundle exec rspec spec/schema_dot_org/[type]_spec.rb` - Run tests for a specific Schema.org type
+- `bundle exec rake` - Run default task (runs tests)
+
+### Gem Management  
+- `gem build schema_dot_org.gemspec` - Build the gem locally
+- `gem install ./schema_dot_org-[version].gem` - Install built gem locally
+- `bundle install` - Install dependencies
+
+### Interactive Development
+- `bundle exec pry` - Start Pry REPL with gem loaded for interactive testing
+
+## Architecture
+
+### Core Components
+
+**SchemaType Base Class** (`lib/schema_dot_org.rb`):
+- Abstract base class for all Schema.org types
+- Handles JSON-LD generation with `to_json_ld()` and `to_s()` methods
+- Converts snake_case Ruby attributes to camelCase JSON-LD
+- Provides validation through ValidatedObject gem integration
+- Automatically adds `@context` and `@type` fields
+
+**Schema.org Type Classes** (`lib/schema_dot_org/*.rb`):
+- Each file represents one Schema.org type (Organization, Person, BreadcrumbList, etc.)
+- Classes inherit from SchemaType and use `validated_attr` for type-safe attributes
+- Follow pattern: `validated_attr :attribute_name, type: [Type], allow_nil: true/false`
+
+**URL Validation** (`lib/schema_dot_org/url_validator.rb`):
+- Validates URLs used in structured data
+- Used by convenience methods like `make_breadcrumbs`
+
+### Design Patterns
+
+**Validation-First Approach**: 
+- All attributes are validated at object creation time
+- Invalid data causes immediate ArgumentError/NoMethodError rather than silent failures
+- Uses ActiveRecord-style validations via ValidatedObject gem
+
+**Declarative Attribute Definition**:
+```ruby
+class Product < SchemaType
+  validated_attr :name,        type: String
+  validated_attr :description, type: String, allow_nil: true
+  validated_attr :offers,      type: SchemaDotOrg::AggregateOffer
+end
+```
+
+**Nested Schema Types**:
+- Schema types can reference other schema types as attributes
+- Automatic JSON-LD nesting handled by base class
+- Example: Organization can have Person founder, Place founding_location
+
+### Key Files Structure
+
+- `lib/schema_dot_org.rb` - Main module, base SchemaType class, convenience methods
+- `lib/schema_dot_org/[type].rb` - Individual Schema.org type implementations  
+- `spec/schema_dot_org/[type]_spec.rb` - RSpec tests for each type
+- `spec/spec_helper.rb` - RSpec configuration with doctest2 integration
+
+### Testing Patterns
+
+- Each Schema.org type has corresponding RSpec test file
+- Tests validate both successful creation and error conditions
+- Tests verify correct JSON-LD output format
+- Uses doctest2-rspec for testing code examples in comments
+
+## Adding New Schema.org Types
+
+1. Create new file `lib/schema_dot_org/new_type.rb`
+2. Define class inheriting from SchemaType with validated_attr declarations
+3. Add require statement to main `lib/schema_dot_org.rb` file
+4. Create corresponding test file `spec/schema_dot_org/new_type_spec.rb`
+5. Follow existing patterns for validation and JSON-LD output testing
+
+## Dependencies
+
+- **validated_object (~> 2.3)** - Provides ActiveRecord-style validations
+- **rspec (~> 3.12)** - Testing framework
+- **doctest2-rspec (~> 0.9.2)** - Tests code examples in documentation

data/Gemfile.lock

@@ -1,65 +1,67 @@
 PATH
   remote: .
   specs:
-    schema_dot_org (2.5.0)
-      validated_object (~> 2.3)
+    schema_dot_org (2.5.1)
+      validated_object (~> 2.3.4)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activemodel (7.1.1)
-      activesupport (= 7.1.1)
-    activesupport (7.1.1)
+    activemodel (8.0.2.1)
+      activesupport (= 8.0.2.1)
+    activesupport (8.0.2.1)
       base64
+      benchmark (>= 0.3)
       bigdecimal
-      concurrent-ruby (~> 1.0, >= 1.0.2)
+      concurrent-ruby (~> 1.0, >= 1.3.1)
       connection_pool (>= 2.2.5)
       drb
       i18n (>= 1.6, < 2)
+      logger (>= 1.4.2)
       minitest (>= 5.1)
-      mutex_m
-      tzinfo (~> 2.0)
-    base64 (0.1.1)
-    bigdecimal (3.1.4)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+      uri (>= 0.13.1)
+    base64 (0.3.0)
+    benchmark (0.4.1)
+    bigdecimal (3.2.2)
     coderay (1.1.3)
-    concurrent-ruby (1.2.2)
-    connection_pool (2.4.1)
-    diff-lcs (1.5.0)
+    concurrent-ruby (1.3.5)
+    connection_pool (2.5.3)
+    diff-lcs (1.6.2)
     doctest2-core (0.9.3)
     doctest2-rspec (0.9.2)
       doctest2-core (~> 0.9.0)
       rspec (~> 3.0)
-    drb (2.1.1)
-      ruby2_keywords
-    i18n (1.14.1)
+    drb (2.2.3)
+    i18n (1.14.7)
       concurrent-ruby (~> 1.0)
+    logger (1.7.0)
     method_source (1.1.0)
-    minitest (5.20.0)
-    mutex_m (0.1.2)
+    minitest (5.25.5)
     pry (0.15.2)
       coderay (~> 1.1)
       method_source (~> 1.0)
-    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)
+    rake (13.3.0)
+    rspec (3.13.1)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.5)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.12.0)
-    rspec-mocks (3.12.6)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.5)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.12.0)
-    rspec-support (3.12.1)
-    ruby2_keywords (0.0.5)
-    sorbet-runtime (0.5.11072)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.5)
+    securerandom (0.4.1)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
-    validated_object (2.3.0)
+    uri (1.0.3)
+    validated_object (2.3.4)
       activemodel (>= 3.2.21)
-      sorbet-runtime (>= 0.5.5890)
 
 PLATFORMS
   arm64-darwin-24

data/README.md

@@ -8,7 +8,6 @@
   - [Examples](#examples)
     - [BreadcrumbList](#breadcrumblist)
     - [WebSite](#website)
-    - [Organization](#organization)
   - [Installation](#installation)
   - [Development](#development)
   - [Contributing](#contributing)
@@ -141,6 +140,7 @@ See each type's RSpec for an example of how to use it.
 | Organization           | [Schema.org](https://schema.org/Organization)           | [RSpec](https://github.com/public-law/schema-dot-org/blob/master/spec/schema_dot_org/organization_spec.rb)             | [Source](https://github.com/public-law/schema-dot-org/blob/master/lib/schema_dot_org/organization.rb)             |
 | Person                 | [Schema.org](https://schema.org/Person)                 | [RSpec](https://github.com/public-law/schema-dot-org/blob/master/spec/schema_dot_org/person_spec.rb)                   | [Source](https://github.com/public-law/schema-dot-org/blob/master/lib/schema_dot_org/person.rb)                   |
 | Place                  | [Schema.org](https://schema.org/Place)                  | [RSpec](https://github.com/public-law/schema-dot-org/blob/master/spec/schema_dot_org/place_spec.rb)                    | [Source](https://github.com/public-law/schema-dot-org/blob/master/lib/schema_dot_org/place.rb)                    |
+| PostalAddress          | [Schema.org](https://schema.org/PostalAddress)          | [RSpec](https://github.com/public-law/schema-dot-org/blob/master/spec/schema_dot_org/postal_address_spec.rb)           | [Source](https://github.com/public-law/schema-dot-org/blob/master/lib/schema_dot_org/postal_address.rb)           |
 | Product                | [Schema.org](https://schema.org/Product)                | [RSpec](https://github.com/public-law/schema-dot-org/blob/master/spec/schema_dot_org/product_spec.rb)                  | [Source](https://github.com/public-law/schema-dot-org/blob/master/lib/schema_dot_org/product.rb)                  |
 | SearchAction           | [Schema.org](https://schema.org/SearchAction)           | [RSpec](https://github.com/public-law/schema-dot-org/blob/master/spec/schema_dot_org/search_action_spec.rb)            | [Source](https://github.com/public-law/schema-dot-org/blob/master/lib/schema_dot_org/search_action.rb)            |
 | WebSite                | [Schema.org](https://schema.org/WebSite)                | [RSpec](https://github.com/public-law/schema-dot-org/blob/master/spec/schema_dot_org/web_site_spec.rb)                 | [Source](https://github.com/public-law/schema-dot-org/blob/master/lib/schema_dot_org/web_site.rb)                 |
@@ -226,26 +226,6 @@ WebSite.new(
 )
 ```
 
-### Organization
-
-Example:
-
-```ruby
-Organization.new(
-  name:             'Public.Law',
-  founder:           Person.new(name: 'Robb Shecter'),
-  founding_date:     Date.new(2009, 3, 6),
-  founding_location: Place.new(address: 'Portland, OR'),
-  email:            'say_hi@public.law',
-  url:              'https://www.public.law',
-  logo:             'https://www.public.law/favicon-196x196.png',
-  same_as: [
-    'https://twitter.com/law_is_code',
-    'https://www.facebook.com/PublicDotLaw'
-  ]
-)
-```
-
 
 ## Installation
 

data/lib/schema_dot_org/aggregate_offer.rb

@@ -1,9 +1,10 @@
 # frozen_string_literal: true
 
-#
-# Model the Schema.org `Thing > Intangible > Offer > AggregateOffer`.  See https://schema.org/Offer
-#
+
 module SchemaDotOrg
+  ##
+  # Model the Schema.org `Thing > Intangible > Offer > AggregateOffer`.  See https://schema.org/Offer
+  #
   class AggregateOffer < SchemaType
     attr_reader :priceCurrency
 

data/lib/schema_dot_org/breadcrumb_list.rb

@@ -1,16 +1,16 @@
 # frozen_string_literal: true
 
 
-#
-# Model the Google / Schema.org `BreadcrumbList`.
-#
-# The intent is to primarily support Google's BreadcrumbList. Properties
-# from Schema.org are welcome if desired.
-#
-# See https://developers.google.com/search/docs/appearance/structured-data/breadcrumb
-# and https://schema.org/BreadcrumbList
-#
 module SchemaDotOrg
+  ##
+  # Model the Google / Schema.org `BreadcrumbList`.
+  #
+  # The intent is to primarily support Google's BreadcrumbList. Properties
+  # from Schema.org are welcome if desired.
+  #
+  # See https://developers.google.com/search/docs/appearance/structured-data/breadcrumb
+  # and https://schema.org/BreadcrumbList
+  #
   class BreadcrumbList < SchemaType
     validated_attr :itemListElement, type: Array, presence: true
   end

data/lib/schema_dot_org/college_or_university.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
 
-#
-# https://schema.org/CollegeOrUniversity
-#
 module SchemaDotOrg
+  ##
+  # https://schema.org/CollegeOrUniversity
+  #
   class CollegeOrUniversity < SchemaType
     validated_attr :name, type: String, presence: true
     validated_attr :url,  type: String, allow_nil: true

data/lib/schema_dot_org/comment.rb

@@ -1,14 +1,13 @@
-
 # frozen_string_literal: true
 
 require 'date'
 require_relative 'person'
 
-#
-# Model the Schema.org `Thing > CreativeWork > Comment`.
-# See https://schema.org/Comment
-#
 module SchemaDotOrg
+  ##
+  # Model the Schema.org `Thing > CreativeWork > Comment`.
+  # See https://schema.org/Comment
+  #
   class Comment < SchemaType
     validated_attr :author,        type: Person, presence: true
     validated_attr :datePublished, type: Date,   presence: true

data/lib/schema_dot_org/contact_point.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
 
-#
-# Model the Schema.org `ContactPoint`.  See http://schema.org/ContactPoint
-#
 module SchemaDotOrg
+  ##
+  # Model the Schema.org `ContactPoint`.  See http://schema.org/ContactPoint
+  #
   class ContactPoint < SchemaType
     validated_attr :area_served,         type: Array,   allow_nil: true
     validated_attr :available_language,  type: Array,   allow_nil: true

data/lib/schema_dot_org/discussion_forum_posting.rb

@@ -2,17 +2,16 @@
 
 require 'date'
 require_relative 'person'
+require_relative 'organization'
 
-#
-# Model the Schema.org `Thing > CreativeWork > Article > SocialMediaPosting > DiscussionForumPosting`.
-# See https://schema.org/DiscussionForumPosting
-#
 module SchemaDotOrg
+  ##
+  # Model the Schema.org `Thing > CreativeWork > Article > SocialMediaPosting > DiscussionForumPosting`.
+  # See https://schema.org/DiscussionForumPosting
+  #
   class DiscussionForumPosting < SchemaType
-    # TODO: Allow for type Person or Organization
-    validated_attr :author,        type: Person, presence: true
-    # TODO: Allow for type Date or DateTime
-    validated_attr :datePublished, type: Date,   presence: true
+    validated_attr :author,        type: union(Person, Organization), presence: true
+    validated_attr :datePublished, type: union(Date, Time),           presence: true
 
     validated_attr :comment,              type: Array,   allow_nil: true
     validated_attr :commentCount,         type: Integer, allow_nil: true

data/lib/schema_dot_org/interaction_counter.rb

@@ -1,10 +1,11 @@
 # frozen_string_literal: true
 
-#
-# Model the Schema.org `Thing > Intangible > StructuredValue > InteractionCounter`.
-# See https://schema.org/InteractionCounter
-#
+
 module SchemaDotOrg
+  ##
+  # Model the Schema.org `Thing > Intangible > StructuredValue > InteractionCounter`.
+  # See https://schema.org/InteractionCounter
+  #
   class InteractionCounter < SchemaType
     validated_attr :userInteractionCount, type: Integer, presence: true
     validated_attr :interactionType,      type: String,  presence: true

data/lib/schema_dot_org/item_list.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
 
-#
-# Model the Schema.org `ItemList`.  See https://schema.org/ItemList
-#
 module SchemaDotOrg
+  ##
+  # Model the Schema.org `ItemList`.  See https://schema.org/ItemList
+  #
   class ItemList < SchemaType
     validated_attr :itemListElement,   type: Array,    presence: true
     validated_attr :itemListOrder,     type: String,   allow_nil: true

data/lib/schema_dot_org/language.rb

@@ -1,10 +1,11 @@
 # frozen_string_literal: true
 
-#
-# Model the Schema.org `Thing > Intangible > Language`.
-# See https://schema.org/Language
-#
+
 module SchemaDotOrg
+  ##
+  # Model the Schema.org `Thing > Intangible > Language`.
+  # See https://schema.org/Language
+  #
   class Language < SchemaType
     validated_attr :alternateName, type: String, allow_nil: true
     validated_attr :name,          type: String, presence: true

data/lib/schema_dot_org/list_item.rb

@@ -3,10 +3,10 @@
 
 require_relative 'product'
 
-#
-# Model the Schema.org `ItemListElement`.  See https://schema.org/ItemListElement
-#
 module SchemaDotOrg
+  ##
+  # Model the Schema.org `ItemListElement`.  See https://schema.org/ItemListElement
+  #
   class ListItem < SchemaType
     validated_attr :image,     type: String,                allow_nil: true
     validated_attr :item,      type: Object,                allow_nil: true  # Allow String or SchemaType

data/lib/schema_dot_org/offer.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
 
-#
-# Model the Schema.org `Thing > Intangible > Offer`.  See https://schema.org/Offer
-#
 module SchemaDotOrg
+  ##
+  # Model the Schema.org `Thing > Intangible > Offer`.  See https://schema.org/Offer
+  #
   class Offer < SchemaType
     validated_attr :priceCurrency, type: String
     validated_attr :price,         type: Numeric

data/lib/schema_dot_org/organization.rb

@@ -4,12 +4,15 @@ require 'date'
 
 require_relative 'person'
 require_relative 'place'
+require_relative 'postal_address'
 
-# Google allows `url` to be a string:
-# https://developers.google.com/search/docs/appearance/structured-data/logo
 
 module SchemaDotOrg
+  ##
+  # See https://schema.org/Organization
+  #
   class Organization < SchemaType
+    validated_attr :address,           type: SchemaDotOrg::PostalAddress, allow_nil: true
     validated_attr :contact_points,    type: Array, allow_nil: true
     validated_attr :email,             type: String, allow_nil: true
     validated_attr :founder,           type: SchemaDotOrg::Person, allow_nil: true
@@ -21,6 +24,9 @@ module SchemaDotOrg
     validated_attr :same_as,           type: Array, allow_nil: true
     validated_attr :slogan,            type: String, allow_nil: true
     validated_attr :telephone,         type: String, allow_nil: true
+
+    # Google allows `url` to be a string:
+    # https://developers.google.com/search/docs/appearance/structured-data/logo
     validated_attr :url,               type: String
   end
 end

data/lib/schema_dot_org/person.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
 
-#
-# Model the Schema.org **Person**.  See http://schema.org/Person
-#
 module SchemaDotOrg
+  ##
+  # Model the Schema.org **Person**.  See http://schema.org/Person
+  #
   class Person < SchemaType
     validated_attr :award,            type: String, allow_nil: true
     validated_attr :alumni_of,        type: SchemaDotOrg::CollegeOrUniversity, allow_nil: true

data/lib/schema_dot_org/place.rb

@@ -1,11 +1,13 @@
 # frozen_string_literal: true
 
+require_relative 'postal_address'
+
 
-#
-# Model the Schema.org `Thing > Place`.  See http://schema.org/Place
-#
 module SchemaDotOrg
+  ##
+  # Model the Schema.org `Thing > Place`.  See http://schema.org/Place
+  #
   class Place < SchemaType
-    validated_attr :address, type: String, presence: true
+    validated_attr :address, type: union(String, SchemaDotOrg::PostalAddress), presence: true
   end
 end

data/lib/schema_dot_org/postal_address.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+
+module SchemaDotOrg
+  ##
+  # Model the Schema.org `Thing > Intangible > StructuredValue > ContactPoint > PostalAddress`.
+  # See https://schema.org/PostalAddress
+  #
+  class PostalAddress < SchemaType
+
+    # AddressCountry: The country. Recommended to be in 2-letter ISO 3166-1 alpha-2
+    # format, for example "US". For backward compatibility, a 3-letter ISO 3166-1 alpha-3
+    # country code such as "SGP" or a full country name such as "Singapore" can also be
+    # used.
+    validated_attr :addressCountry,  type: String, allow_nil: true
+
+    # AddressLocality: The locality in which the street address is,
+    # and which is in the region. For example, Mountain View.
+    validated_attr :addressLocality, type: String, allow_nil: true
+
+    # AddressRegion: The region in which the locality is, and which is in the country.
+    # For example, California or another appropriate first-level Administrative division.
+    validated_attr :addressRegion,   type: String, allow_nil: true
+
+    # ExtendedAddress: An address extension such as an apartment number, C/O or
+    # alternative name.
+    validated_attr :extendedAddress, type: String, allow_nil: true
+
+    # PostalCode: The postal code. For example, 94043.
+    validated_attr :postalCode,      type: String, allow_nil: true
+
+    # StreetAddress: The street address. For example, 1600 Amphitheatre Parkway.
+    validated_attr :streetAddress,   type: String, allow_nil: true
+  end
+end

data/lib/schema_dot_org/product.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
 
-#
-# Model the Schema.org `Thing > Product`.  See https://schema.org/Product
-#
 module SchemaDotOrg
+  ##
+  # Model the Schema.org `Thing > Product`.  See https://schema.org/Product
+  #
   class Product < SchemaType
     validated_attr :description,  type: String, allow_nil: true
     validated_attr :image,        type: Array,  allow_nil: true

data/lib/schema_dot_org/search_action.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
 
-#
-# Model the Schema.org `Thing > SearchAction`.  See http://schema.org/SearchAction
-#
 module SchemaDotOrg
+  ##
+  # Model the Schema.org `Thing > SearchAction`.  See http://schema.org/SearchAction
+  #
   class SearchAction < SchemaDotOrg::SchemaType
     validated_attr :query_input, type: String, presence: true
     validated_attr :target,      type: String, presence: true

data/lib/schema_dot_org/web_site.rb

@@ -1,11 +1,11 @@
 # frozen_string_literal: true
 
 
-#
-# Model the Schema.org `Thing > CreativeWork > WebSite`.
-# @See http://schema.org/WebSite
-#
 module SchemaDotOrg
+  ##
+  # Model the Schema.org `Thing > CreativeWork > WebSite`.
+  # @See http://schema.org/WebSite
+  #
   class WebSite < SchemaType
     validated_attr :name,             type: String, presence: true
     validated_attr :potential_action, type: SchemaDotOrg::SearchAction, allow_nil: true

data/lib/schema_dot_org.rb

@@ -1,8 +1,12 @@
 # frozen_string_literal: true
+
 require 'json'
 require 'validated_object'
 
 
+##
+# The main module for the schema-dot-org gem.
+#
 module SchemaDotOrg
   ##
   # Make a BreadcrumbList from an array of links. This is a convenience
@@ -159,6 +163,7 @@ require 'schema_dot_org/list_item'
 require 'schema_dot_org/organization'
 require 'schema_dot_org/person'
 require 'schema_dot_org/place'
+require 'schema_dot_org/postal_address'
 require 'schema_dot_org/product'
 require 'schema_dot_org/offer'
 require 'schema_dot_org/search_action'

data/schema_dot_org.gemspec

@@ -5,9 +5,9 @@ lib = File.expand_path('lib', __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
 Gem::Specification.new do |spec|
-  spec.required_ruby_version = '>= 3.0'
+  spec.required_ruby_version = '>= 3.1'
   spec.name          = 'schema_dot_org'
-  spec.version       = '2.5.0'
+  spec.version       = '2.5.2'
   spec.authors       = ['Robert Shecter']
   spec.email         = ['robert@public.law']
 
@@ -25,7 +25,7 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.add_dependency 'validated_object', '~> 2.3'
+  spec.add_dependency 'validated_object', '~> 2.3.4'
 
   spec.add_development_dependency "bundler", "~> 2.4"
   spec.add_development_dependency "rake", "~> 13.0"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: schema_dot_org
 version: !ruby/object:Gem::Version
-  version: 2.5.0
+  version: 2.5.2
 platform: ruby
 authors:
 - Robert Shecter
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.3'
+        version: 2.3.4
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.3'
+        version: 2.3.4
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -103,6 +103,8 @@ files:
 - ".gitignore"
 - ".rspec"
 - ".travis.yml"
+- CHANGELOG.md
+- CLAUDE.md
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
@@ -126,6 +128,7 @@ files:
 - lib/schema_dot_org/organization.rb
 - lib/schema_dot_org/person.rb
 - lib/schema_dot_org/place.rb
+- lib/schema_dot_org/postal_address.rb
 - lib/schema_dot_org/product.rb
 - lib/schema_dot_org/search_action.rb
 - lib/schema_dot_org/url_validator.rb
@@ -143,14 +146,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.0'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.7.1
 specification_version: 4
 summary: JSON-LD generator for Schema.org vocabulary
 test_files: []