ResearchObject · fbacall · Jun 24, 2026 · Jun 23, 2026 · Jun 23, 2026
diff --git a/README.md b/README.md
@@ -2,10 +2,10 @@
 
 ![Tests](https://github.com/ResearchObject/ro-crate-ruby/actions/workflows/tests.yml/badge.svg)
 
-This is a WIP gem for creating, manipulating and reading RO-Crates (conforming to version 1.2 of the specification). RO-Crates produced by older versions (1.0, 1.1) of the spec can still be read.
+This is a WIP gem for creating, manipulating and reading RO-Crates (conforming to version 1.3 of the specification). RO-Crates produced by older versions (1.0, 1.1, 1.2) of the spec can still be read.
 
 * RO-Crate - https://www.researchobject.org/ro-crate/
-* RO-Crate spec (1.2) - https://www.researchobject.org/ro-crate/specification/1.2/
+* RO-Crate spec (1.3) - https://www.researchobject.org/ro-crate/specification/1.3/
 
 ## Installation
 

diff --git a/lib/ro_crate/model/metadata.rb b/lib/ro_crate/model/metadata.rb
@@ -6,8 +6,8 @@ class Metadata < File
     IDENTIFIER_1_0 = 'ro-crate-metadata.jsonld'.freeze # 1.0 spec identifier
     RO_CRATE_BASE = 'https://w3id.org/ro/crate/'
 
-    SUPPORTED_VERSIONS = %w[1.0 1.0-DRAFT 1.1 1.1-DRAFT 1.2 1.2-DRAFT].freeze
-    DEFAULT_VERSION = '1.2'.freeze
+    SUPPORTED_VERSIONS = %w[1.0 1.0-DRAFT 1.1 1.1-DRAFT 1.2 1.2-DRAFT 1.3].freeze
+    DEFAULT_VERSION = '1.3'.freeze
 
     CONTEXT = "#{RO_CRATE_BASE}#{DEFAULT_VERSION}/context".freeze
     SPEC = "#{RO_CRATE_BASE}#{DEFAULT_VERSION}".freeze

diff --git a/test/crate_test.rb b/test/crate_test.rb
@@ -378,12 +378,12 @@ class CrateTest < Test::Unit::TestCase
     assert crate.get('#joehouse')
   end
 
-  test 'defaults to RO-Crate spec 1.2' do
+  test 'defaults to RO-Crate spec 1.3' do
     crate = ROCrate::Crate.new
-    assert_equal '1.2', crate.metadata.version
-    assert_equal 'https://w3id.org/ro/crate/1.2/context', crate.metadata.context
-    assert_equal 'https://w3id.org/ro/crate/1.2', crate.metadata.spec_url
-    assert_equal({ '@id' => 'https://w3id.org/ro/crate/1.2' }, crate.metadata.properties['conformsTo'])
+    assert_equal '1.3', crate.metadata.version
+    assert_equal 'https://w3id.org/ro/crate/1.3/context', crate.metadata.context
+    assert_equal 'https://w3id.org/ro/crate/1.3', crate.metadata.spec_url
+    assert_equal({ '@id' => 'https://w3id.org/ro/crate/1.3' }, crate.metadata.properties['conformsTo'])
   end
 
   test 'can write older spec version' do

diff --git a/test/fixtures/crate-spec1.2/file with spaces.txt b/test/fixtures/crate-spec1.2/file with spaces.txt
@@ -0,0 +1 @@
+I have spaces in my name
diff --git a/test/fixtures/crate-spec1.2/ro-crate-metadata.json b/test/fixtures/crate-spec1.2/ro-crate-metadata.json
@@ -0,0 +1,42 @@
+{
+  "@context": "https://w3id.org/ro/crate/1.2/context",
+  "@graph": [
+    {
+      "@id": "ro-crate-metadata.json",
+      "@type": "CreativeWork",
+      "about": {
+        "@id": "./"
+      },
+      "conformsTo": {
+        "@id": "https://w3id.org/ro/crate/1.2"
+      }
+    },
+    {
+      "@id": "ro-crate-preview.html",
+      "@type": "CreativeWork",
+      "about": {
+        "@id": "./"
+      }
+    },
+    {
+      "@id": "./",
+      "@type": "Dataset",
+      "hasPart": [
+        {
+          "@id": "http://example.com/external_ref.txt"
+        },
+        {
+          "@id": "file%20with%20spaces.txt"
+        }
+      ]
+    },
+    {
+      "@id": "http://example.com/external_ref.txt",
+      "@type": "File"
+    },
+    {
+      "@id": "file%20with%20spaces.txt",
+      "@type": "File"
+    }
+  ]
+}
diff --git a/test/fixtures/crate-spec1.2/ro-crate-preview.html b/test/fixtures/crate-spec1.2/ro-crate-preview.html
@@ -0,0 +1,82 @@
+
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <title>New RO-Crate</title>
+  <script type="application/ld+json">{
+  "@context": "https://w3id.org/ro/crate/1.2/context",
+  "@graph": [
+    {
+      "@id": "ro-crate-metadata.json",
+      "@type": "CreativeWork",
+      "about": {
+        "@id": "./"
+      },
+      "conformsTo": {
+        "@id": "https://w3id.org/ro/crate/1.2"
+      }
+    },
+    {
+      "@id": "ro-crate-preview.html",
+      "@type": "CreativeWork",
+      "about": {
+        "@id": "./"
+      }
+    },
+    {
+      "@id": "./",
+      "@type": "Dataset",
+      "hasPart": [
+        {
+          "@id": "http://example.com/external_ref.txt"
+        },
+        {
+          "@id": "file%20with%20spaces.txt"
+        }
+      ]
+    },
+    {
+      "@id": "http://example.com/external_ref.txt",
+      "@type": "File"
+    },
+    {
+      "@id": "file%20with%20spaces.txt",
+      "@type": "File"
+    }
+  ]
+}</script>
+  <meta name="generator" content="https://github.com/ResearchObject/ro-crate-ruby">
+  <meta name="keywords" content="RO-Crate">
+  <meta charset="utf-8">
+</head>
+<body>
+  <h1>New RO-Crate</h1>
+
+  <p>
+
+  </p>
+  <dl>
+
+
+
+
+  </dl>
+
+  <h2>Contents</h2>
+  <ul>
+
+      <li>
+        <strong><a href="http://example.com/external_ref.txt" target="_blank">http://example.com/external_ref.txt</a></strong>
+
+
+      </li>
+
+      <li>
+        <strong>file%20with%20spaces.txt</strong>
+
+
+      </li>
+
+  </ul>
+</body>
+</html>
diff --git a/test/fixtures/crate-spec1.3/file with spaces.txt b/test/fixtures/crate-spec1.3/file with spaces.txt
@@ -0,0 +1 @@
+I have spaces in my name
diff --git a/test/fixtures/crate-spec1.3/ro-crate-metadata.json b/test/fixtures/crate-spec1.3/ro-crate-metadata.json
@@ -0,0 +1,42 @@
+{
+  "@context": "https://w3id.org/ro/crate/1.3/context",
+  "@graph": [
+    {
+      "@id": "ro-crate-metadata.json",
+      "@type": "CreativeWork",
+      "about": {
+        "@id": "./"
+      },
+      "conformsTo": {
+        "@id": "https://w3id.org/ro/crate/1.3"
+      }
+    },
+    {
+      "@id": "ro-crate-preview.html",
+      "@type": "CreativeWork",
+      "about": {
+        "@id": "./"
+      }
+    },
+    {
+      "@id": "./",
+      "@type": "Dataset",
+      "hasPart": [
+        {
+          "@id": "http://example.com/external_ref.txt"
+        },
+        {
+          "@id": "file%20with%20spaces.txt"
+        }
+      ]
+    },
+    {
+      "@id": "http://example.com/external_ref.txt",
+      "@type": "File"
+    },
+    {
+      "@id": "file%20with%20spaces.txt",
+      "@type": "File"
+    }
+  ]
+}
diff --git a/test/fixtures/crate-spec1.3/ro-crate-preview.html b/test/fixtures/crate-spec1.3/ro-crate-preview.html
@@ -0,0 +1,82 @@
+
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <title>New RO-Crate</title>
+  <script type="application/ld+json">{
+  "@context": "https://w3id.org/ro/crate/1.3/context",
+  "@graph": [
+    {
+      "@id": "ro-crate-metadata.json",
+      "@type": "CreativeWork",
+      "about": {
+        "@id": "./"
+      },
+      "conformsTo": {
+        "@id": "https://w3id.org/ro/crate/1.3"
+      }
+    },
+    {
+      "@id": "ro-crate-preview.html",
+      "@type": "CreativeWork",
+      "about": {
+        "@id": "./"
+      }
+    },
+    {
+      "@id": "./",
+      "@type": "Dataset",
+      "hasPart": [
+        {
+          "@id": "http://example.com/external_ref.txt"
+        },
+        {
+          "@id": "file%20with%20spaces.txt"
+        }
+      ]
+    },
+    {
+      "@id": "http://example.com/external_ref.txt",
+      "@type": "File"
+    },
+    {
+      "@id": "file%20with%20spaces.txt",
+      "@type": "File"
+    }
+  ]
+}</script>
+  <meta name="generator" content="https://github.com/ResearchObject/ro-crate-ruby">
+  <meta name="keywords" content="RO-Crate">
+  <meta charset="utf-8">
+</head>
+<body>
+  <h1>New RO-Crate</h1>
+
+  <p>
+
+  </p>
+  <dl>
+
+
+
+
+  </dl>
+
+  <h2>Contents</h2>
+  <ul>
+
+      <li>
+        <strong><a href="http://example.com/external_ref.txt" target="_blank">http://example.com/external_ref.txt</a></strong>
+
+
+      </li>
+
+      <li>
+        <strong>file%20with%20spaces.txt</strong>
+
+
+      </li>
+
+  </ul>
+</body>
+</html>
diff --git a/test/reader_test.rb b/test/reader_test.rb
@@ -188,6 +188,48 @@ class ReaderTest < Test::Unit::TestCase
     assert crate.preview.source.source.is_a?(ROCrate::PreviewGenerator)
   end
 
+  test 'can read a 1.2 spec crate' do
+    stub_request(:get, "http://example.com/external_ref.txt").to_return(status: 200, body: 'file contents')
+
+    crate = ROCrate::Reader.read_directory(fixture_file('crate-spec1.2').path)
+    file = crate.dereference('file with spaces.txt')
+    assert file
+    assert file.is_a?(ROCrate::File)
+    refute file.remote?
+    assert file.source.is_a?(ROCrate::Entry)
+    assert_equal 'file%20with%20spaces.txt', file.id
+
+    ext_file = crate.dereference('http://example.com/external_ref.txt')
+    assert ext_file
+    assert ext_file.is_a?(ROCrate::File)
+    assert ext_file.remote?
+    assert ext_file.source.is_a?(ROCrate::RemoteEntry)
+    assert_equal 'http://example.com/external_ref.txt', ext_file.id
+    assert_equal 'file contents', ext_file.source.read
+    assert crate.preview.source.source.is_a?(Pathname)
+  end
+
+  test 'can read a 1.3 spec crate' do
+    stub_request(:get, "http://example.com/external_ref.txt").to_return(status: 200, body: 'file contents')
+
+    crate = ROCrate::Reader.read_directory(fixture_file('crate-spec1.3').path)
+    file = crate.dereference('file with spaces.txt')
+    assert file
+    assert file.is_a?(ROCrate::File)
+    refute file.remote?
+    assert file.source.is_a?(ROCrate::Entry)
+    assert_equal 'file%20with%20spaces.txt', file.id
+
+    ext_file = crate.dereference('http://example.com/external_ref.txt')
+    assert ext_file
+    assert ext_file.is_a?(ROCrate::File)
+    assert ext_file.remote?
+    assert ext_file.source.is_a?(ROCrate::RemoteEntry)
+    assert_equal 'http://example.com/external_ref.txt', ext_file.id
+    assert_equal 'file contents', ext_file.source.read
+    assert crate.preview.source.source.is_a?(Pathname)
+  end
+
   test 'reading from directory with unlisted files' do
     crate = ROCrate::Reader.read_directory(fixture_file('sparse_directory_crate').path)