bibframe_ruby 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fcbdeff768bfbc758d78355aa9f9de7e98a513cc0a0c63a43ac1e2b9b2c4e6bb
-  data.tar.gz: c2e8be5aed30fa4cb8a6bc88c5d0e70b267b3b2c3b73aa5a141fc76169696c74
+  metadata.gz: ee4d1179d85cde61e67c01da92b6fd036ec9a01ce0a53f26ed7f3aa4ca837140
+  data.tar.gz: f3181cde09408b09fba1444983d4eb42bd2c26e863e427cd88b092be1078162e
 SHA512:
-  metadata.gz: 1be2ad497cc3ba26bf0eca414bcdc27cf80aaebae69db92fb469462fec0f85cf2ad28aff7a7f3b00f993b31c408804cff391434b97de96387135c424bc2b34ad
-  data.tar.gz: a09548d0df9b71f46188ac47935dd1dc13e827259183ce716a8b9aac2e555a016c7a07f9cd9770c3c38957514718df3163162447d551c484ac53afcab1dfd56a
+  metadata.gz: 9a3a57a85e5f18c9e5a34d27b518f50ae82f64b4982183cf86c0e245bc710791e14c3ce542e94625a8da6a6ba605b8ea209feeaac813511f7d738bf08d1777d5
+  data.tar.gz: f0310d9973e81e15c5b564dca7433f38e5cded5932a1b95a80a79c0d6eb2e46960554a69d8d95c0d9844953107a718f71e0e5ce8f7e89116abb87cd3cf4c0a04

data/.rubocop_todo.yml

@@ -0,0 +1,55 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2026-09-09 02:40:46 UTC using RuboCop version 1.90.0.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 4
+# Configuration parameters: AllowedMethods, AllowedPatterns, CountRepeatedAttributes.
+Metrics/AbcSize:
+  Max: 40
+
+# Offense count: 1
+# Configuration parameters: CountComments, CountAsOne.
+Metrics/ClassLength:
+  Max: 216
+
+# Offense count: 3
+# Configuration parameters: AllowedMethods, AllowedPatterns.
+Metrics/CyclomaticComplexity:
+  Max: 13
+
+# Offense count: 5
+# Configuration parameters: CountComments, CountAsOne, AllowedMethods, AllowedPatterns.
+Metrics/MethodLength:
+  Max: 21
+
+# Offense count: 3
+# Configuration parameters: AllowedMethods, AllowedPatterns.
+Metrics/PerceivedComplexity:
+  Max: 14
+
+# Offense count: 2
+# Configuration parameters: CountAsOne.
+RSpec/ExampleLength:
+  Max: 13
+
+# Offense count: 2
+RSpec/MultipleDescribes:
+  Exclude:
+    - 'spec/bibframe_ruby/agent_spec.rb'
+    - 'spec/bibframe_ruby/parser_turtle_spec.rb'
+
+# Offense count: 1
+# Configuration parameters: AllowSubject.
+RSpec/MultipleMemoizedHelpers:
+  Max: 6
+
+# Offense count: 1
+# Configuration parameters: CustomTransform, IgnoreMethods, IgnoreMetadata, InflectorPath, EnforcedInflector.
+# SupportedInflectors: default, active_support
+RSpec/SpecFilePathFormat:
+  Exclude:
+    - 'spec/parse_uri_spec.rb'

data/lib/bibframe_ruby/graph.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
+# BibframeRuby::Graph: Container for parsed BIBFRAME resources with typed collection accessors
 module BibframeRuby
+  # Container returned by BibframeRuby.parse that holds all parsed resources with typed collection accessors.
   class Graph
     attr_reader :works, :instances, :items, :hubs, :resources
 

data/lib/bibframe_ruby/graph_builder.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
+# BibframeRuby::GraphBuilder: Hydrates RDF triples into typed Ruby model objects
 module BibframeRuby
+  # Walks an RDF::Graph to instantiate typed model objects, populate their properties, and link relationships.
   class GraphBuilder
     BF = "http://id.loc.gov/ontologies/bibframe/"
     BFLC = "http://id.loc.gov/ontologies/bflc/"
@@ -99,10 +101,10 @@ module BibframeRuby
 
       {
         resources: @resources,
-        works: @resources.values.select { |r| r.is_a?(Work) },
-        instances: @resources.values.select { |r| r.is_a?(Instance) },
-        items: @resources.values.select { |r| r.is_a?(Item) },
-        hubs: @resources.values.select { |r| r.is_a?(Hub) }
+        works: @resources.values.grep(Work),
+        instances: @resources.values.grep(Instance),
+        items: @resources.values.grep(Item),
+        hubs: @resources.values.grep(Hub)
       }
     end
 
@@ -180,11 +182,10 @@ module BibframeRuby
       case object
       when RDF::Node
         resolve_blank_node(object, grouped, prop_name)
-      when RDF::URI
-        object.to_s
       when RDF::Literal
         object.object.to_s
       else
+        # Works for RDF::URI and other unexpected object types
         object.to_s
       end
     end
@@ -219,7 +220,7 @@ module BibframeRuby
     end
 
     def link_work_instances
-      @resources.values.select { |r| r.is_a?(Work) }.each do |work|
+      @resources.values.grep(Work).each do |work|
         next unless work["instances"]
 
         work["instances"] = work["instances"].map do |ref|
@@ -228,7 +229,7 @@ module BibframeRuby
         end
       end
 
-      @resources.values.select { |r| r.is_a?(Instance) }.each do |instance|
+      @resources.values.grep(Instance).each do |instance|
         next unless instance["work"]
 
         uri = instance["work"].is_a?(String) ? instance["work"] : instance["work"].id
@@ -237,7 +238,7 @@ module BibframeRuby
     end
 
     def link_instance_items
-      @resources.values.select { |r| r.is_a?(Instance) }.each do |instance|
+      @resources.values.grep(Instance).each do |instance|
         next unless instance["items"]
 
         instance["items"] = instance["items"].map do |ref|
@@ -246,7 +247,7 @@ module BibframeRuby
         end
       end
 
-      @resources.values.select { |r| r.is_a?(Item) }.each do |item|
+      @resources.values.grep(Item).each do |item|
         next unless item["instance"]
 
         uri = item["instance"].is_a?(String) ? item["instance"] : item["instance"].id
@@ -256,7 +257,7 @@ module BibframeRuby
 
     def replace_uri_stubs
       # Replace any remaining string URI references in contribution agents
-      @resources.values.select { |r| r.is_a?(Contribution) }.each do |contrib|
+      @resources.values.grep(Contribution).each do |contrib|
         next unless contrib["agent"].is_a?(String)
 
         contrib["agent"] = @resources[contrib["agent"]] || stub_for(contrib["agent"])

data/lib/bibframe_ruby/models/agent.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
+# BibframeRuby::Agent: A BIBFRAME Agent resource
 module BibframeRuby
+  # Represents a BIBFRAME Agent — a person, organization, or other entity.
   class Agent < Resource
     def label
       self["label"]

data/lib/bibframe_ruby/models/contribution.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
+# BibframeRuby::Contribution: A BIBFRAME Contribution resource
 module BibframeRuby
+  # Represents a BIBFRAME Contribution — an agent's role in creating a resource.
   class Contribution < Resource
     def agent
       self["agent"]

data/lib/bibframe_ruby/models/hub.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
+# BibframeRuby::Hub: A BIBFRAME Hub resource
 module BibframeRuby
+  # Represents a BIBFRAME Hub — an abstract bridge resource connecting related Works.
   class Hub < Resource
     def title
       self["title"]

data/lib/bibframe_ruby/models/instance.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
+# BibframeRuby::Instance: A BIBFRAME Instance resource
 module BibframeRuby
+  # Represents a BIBFRAME Instance — a specific embodiment of a Work.
   class Instance < Resource
     def title
       self["title"]

data/lib/bibframe_ruby/models/item.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
+# BibframeRuby::Item: A BIBFRAME Item resource
 module BibframeRuby
+  # Represents a BIBFRAME Item — an individual copy of an Instance.
   class Item < Resource
     def instance
       self["instance"]

data/lib/bibframe_ruby/models/organization.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
+# BibframeRuby::Organization: A BIBFRAME Organization agent
 module BibframeRuby
+  # Represents a BIBFRAME Organization agent.
   class Organization < Agent
   end
 end

data/lib/bibframe_ruby/models/person.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
+# BibframeRuby::Person: A BIBFRAME Person agent
 module BibframeRuby
+  # Represents a BIBFRAME Person agent.
   class Person < Agent
   end
 end

data/lib/bibframe_ruby/models/subject.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
+# BibframeRuby::Subject: A BIBFRAME Subject resource
 module BibframeRuby
+  # Represents a BIBFRAME Subject — a topic or concept associated with a resource.
   class Subject < Resource
     def label
       self["label"]

data/lib/bibframe_ruby/models/title.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
+# BibframeRuby::Title: A BIBFRAME Title resource
 module BibframeRuby
+  # Represents a BIBFRAME Title with main title, subtitle, and non-sort number.
   class Title < Resource
     def main_title
       self["main_title"]

data/lib/bibframe_ruby/models/work.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
+# BibframeRuby::Work: A BIBFRAME Work resource
 module BibframeRuby
+  # Represents a BIBFRAME Work — the intellectual content of a bibliographic resource.
   class Work < Resource
     def title
       self["title"]

data/lib/bibframe_ruby/parser.rb

@@ -1,10 +1,12 @@
 # frozen_string_literal: true
 
-require "rdf"
 require "json/ld"
+require "rdf"
 require "rdf/turtle"
 
+# BibframeRuby::Parser: Converts serialized RDF input into an RDF graph
 module BibframeRuby
+  # Parses serialized RDF input (JSON-LD, Turtle) into an RDF::Graph using the appropriate reader.
   class Parser
     EXTENSION_MAP = {
       ".jsonld" => :jsonld,

data/lib/bibframe_ruby/resource.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
+# BibframeRuby::Resource: Base class for all BIBFRAME resource types
 module BibframeRuby
+  # Base class for all BIBFRAME resources. Provides URI identity, type tracking, and hash-style property access.
   class Resource
     attr_reader :id, :types
     attr_accessor :properties

data/lib/bibframe_ruby/version.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+# BibframeRuby::VERSION: Gem version constant
 module BibframeRuby
-  VERSION = "0.1.0"
+  VERSION = "0.1.2"
 end

data/lib/bibframe_ruby.rb

@@ -18,6 +18,7 @@ require_relative "bibframe_ruby/parser"
 require_relative "bibframe_ruby/graph_builder"
 require_relative "bibframe_ruby/graph"
 
+# BibframeRuby: Main entry point for parsing BIBFRAME data into Ruby objects
 module BibframeRuby
   class Error < StandardError; end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bibframe_ruby
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Aaron Collier
@@ -72,6 +72,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".rubocop_todo.yml"
 - README.md
 - Rakefile
 - lib/bibframe_ruby.rb
@@ -96,6 +97,7 @@ licenses: []
 metadata:
   homepage_uri: https://github.com/aaron-collier/bibframe_ruby
   source_code_uri: https://github.com/aaron-collier/bibframe_ruby
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib