bibframe_ruby 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 656c3e0e3d78aa14eca5596e153c7aada8a5a89fb6645bed67ed0aba0b9a49b8
-  data.tar.gz: 64dead66a959b38cbba57831c898a00807039266af64bcb09f4a2928c1a27fda
+  metadata.gz: c56b203ce79a9b28d23e6cdb460b640ae3a45e57e6d58ca63f62a99cb5db017a
+  data.tar.gz: 62d1d77bb4085fbaf41dff1364defbb18490a9e81931696ee49fba7f2f760a4e
 SHA512:
-  metadata.gz: '0957c3c819f85e626b24225efd65bdee191b884b91bcb9147e7b21bb1de25eee54076fa1017e6911af1d192f6c6f0fc231a8e55795aa3bb610443dab8658cdf0'
-  data.tar.gz: d8f596aa28c8873cfa68d24340f350bbdb0846b7e210c23fe1c92c59049ed026dcf34ffe0f736fea7e7715f422750ff42caf08d85f973716a24126d00fc8ee96
+  metadata.gz: 3cf43245857c53ac5c7635456da9d6c4741ff8a3e7b3ae68474ca85b3d82ee6a258af49b553c7560c3e9f3d116b3b584ac3b7ab4d9d48cb1c1a1a080a6cc79b1
+  data.tar.gz: 66537e8a3d3d08098a09f4626834e63d8605a5afd4a7adb6dd3fef76e55b5c25588c54a38238829373bc6c88586e73aec6b262f39cb7e3bab604ab70949c8b8f

data/README.md

@@ -226,11 +226,29 @@ agent.is_a?(BibframeRuby::Resource)
 # => true
 ```
 
+### Serializing to RDF
+
+Serialize a graph or individual resource back to JSON-LD or Turtle:
+
+```ruby
+# Serialize the entire graph to JSON-LD (default)
+puts graph.to_rdf
+
+# Serialize to Turtle
+puts graph.to_rdf(format: :turtle)
+
+# Serialize a single resource (includes its nested blank nodes)
+puts work.to_rdf
+puts work.to_rdf(format: :turtle)
+```
+
+Output includes BIBFRAME-aware prefixes (`bf:`, `bflc:`, `rdfs:`, etc.) for readable output.
+
 ## Model Reference
 
 | Class | Accessors |
 |-------|-----------|
-| `Resource` | `id`, `types`, `properties`, `[]`, `[]=` |
+| `Resource` | `id`, `types`, `properties`, `[]`, `[]=`, `to_rdf` |
 | `Work` | `title`, `contributions`, `instances`, `language`, `subjects`, `genre_forms`, `summary`, `classifications`, `relations` |
 | `Instance` | `title`, `work`, `identifiers`, `extent`, `carrier`, `media`, `provision_activity`, `edition_statement`, `dimensions`, `publication_statement`, `items` |
 | `Hub` | `title`, `contributions`, `language`, `identifiers`, `relations`, `label` |

data/lib/bibframe_ruby/graph.rb

@@ -1,28 +1,59 @@
 # frozen_string_literal: true
 
+require "json"
+
 # 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
+    attr_reader :works, :instances, :items, :hubs, :resources, :rdf_graph
+
+    WRITER_MAP = {
+      jsonld: JSON::LD::Writer,
+      turtle: RDF::Turtle::Writer
+    }.freeze
+
+    PREFIXES = {
+      bf: "http://id.loc.gov/ontologies/bibframe/",
+      bflc: "http://id.loc.gov/ontologies/bflc/",
+      rdfs: "http://www.w3.org/2000/01/rdf-schema#",
+      rdf: "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
+      xsd: "http://www.w3.org/2001/XMLSchema#"
+    }.freeze
 
-    def initialize(works:, instances:, items:, resources:, hubs: [])
+    def initialize(works:, instances:, items:, resources:, hubs: [], rdf_graph: nil)
       @works = works
       @instances = instances
       @items = items
       @hubs = hubs
       @resources = resources
+      @rdf_graph = rdf_graph
+    end
+
+    def to_rdf(format: :jsonld)
+      writer_class = WRITER_MAP.fetch(format) do
+        raise BibframeRuby::Error, "Unsupported serialization format: #{format}"
+      end
+
+      writer_class.buffer(prefixes: PREFIXES.dup) { |w| @rdf_graph.each_statement { |s| w << s } }
     end
 
     def self.from_rdf(rdf_graph)
       result = GraphBuilder.new(rdf_graph).build
-      new(
+
+      graph = new(
         works: result[:works],
         instances: result[:instances],
         items: result[:items],
         hubs: result[:hubs],
-        resources: result[:resources].values
+        resources: result[:resources].values,
+        rdf_graph: rdf_graph
       )
+
+      # Set back-references so resources can serialize themselves
+      result[:resources].each_value { |r| r.rdf_graph = rdf_graph }
+
+      graph
     end
   end
 end

data/lib/bibframe_ruby/resource.rb

@@ -1,16 +1,19 @@
 # frozen_string_literal: true
 
+require "set"
+
 # 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
+    attr_accessor :properties, :rdf_graph
 
     def initialize(id: nil, types: [], properties: {})
       @id = id
       @types = types
       @properties = properties
+      @rdf_graph = nil
     end
 
     def [](key)
@@ -20,5 +23,32 @@ module BibframeRuby
     def []=(key, value)
       @properties[key.to_s] = value
     end
+
+    def to_rdf(format: :jsonld)
+      raise BibframeRuby::Error, "Unsupported serialization format: #{format}" unless Graph::WRITER_MAP.key?(format)
+      raise BibframeRuby::Error, "No RDF graph available for serialization" unless @rdf_graph && @id
+
+      sub_graph = extract_sub_graph
+      Graph::WRITER_MAP[format].buffer(prefixes: Graph::PREFIXES.dup) { |w| sub_graph.each_statement { |s| w << s } }
+    end
+
+    private
+
+    def extract_sub_graph
+      sub_graph = RDF::Graph.new
+      visited = Set.new
+      collect_triples(RDF::URI(@id), visited, sub_graph)
+      sub_graph
+    end
+
+    def collect_triples(subject, visited, sub_graph)
+      return if visited.include?(subject)
+
+      visited << subject
+      @rdf_graph.query({subject: subject}).each do |stmt|
+        sub_graph << stmt
+        collect_triples(stmt.object, visited, sub_graph) if stmt.object.is_a?(RDF::Node)
+      end
+    end
   end
 end

data/lib/bibframe_ruby/version.rb

@@ -2,5 +2,5 @@
 
 # BibframeRuby::VERSION: Gem version constant
 module BibframeRuby
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bibframe_ruby
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Aaron Collier