ro-crate 0.4.0 → 0.4.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1a00cfaaae356d223c2104408fc10f894aa53271f982924b3c73c9661169b69f
-  data.tar.gz: c26895cf57e0d1e4b31243a2f79031f5121ce0c7c598cb1862f6eb1e146fa2cc
+  metadata.gz: 78897fbce0fd01688c27516dceba600ed7cd984668fd16abde32a1713c0ba40f
+  data.tar.gz: 3194d882e4b7f6cd347d652d5da38cb2fe02cfb18e36d84f50e012193a538a69
 SHA512:
-  metadata.gz: c16426ceee5c8660c145ea9bf4de09cc58bff30d726992628616c9795c8bd54b102f524f6a28514660322e1465d2fe3f0071ea2894000ccfc30ed88a99d9ad86
-  data.tar.gz: fc8f8a3654ef0de78864a808cb797622189ee50becba25c1f0d1c095355655320c218c14d09a21f7baf87da34a1ec8bdcc93d50bd1f69ecc8dccc13708c090d6
+  metadata.gz: ddc2f5ffe217717299f2e5d76313b2a124fabfbc7b1e1800db18ca36d2f79c716ef249c6fcb8a6a8bfd4e0c5bba3b8a30d6ae3498ef8fd0068d7df08985c72f5
+  data.tar.gz: 802bf935d2e911ce771e962d6faaf0821f682049424cf5ac893ec780b8fc89d22f844156a83dd38adbe045a31faa7e527b4d8406bcabe937bdf8a2e8afafcd93

data/.ruby-version

@@ -1 +1 @@
-ruby-2.4.9
+ruby-2.6.6

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    ro-crate (0.3.0)
+    ro-crate (0.4.5)
       addressable (~> 2.7.0)
       rubyzip (~> 2.0.0)
 

data/README.md

@@ -1,16 +1,16 @@
 # ro-crate-ruby
 
-This is a WIP gem for creating, manipulating and reading RO crates (conforming to version 1.1 of the specification).
+This is a WIP gem for creating, manipulating and reading RO-Crates (conforming to version 1.1 of the specification).
 
-* RO Crate - https://researchobject.github.io/ro-crate/
-* RO Crate spec (1.1) - https://researchobject.github.io/ro-crate/1.1/
+* RO-Crate - https://researchobject.github.io/ro-crate/
+* RO-Crate spec (1.1) - https://researchobject.github.io/ro-crate/1.1/
 
 ## Installation
 
 Using bundler, add the following to your Gemfile:
 
 ```
-gem 'ro-crate-ruby', git: 'https://github.com/ResearchObject/ro-crate-ruby.git'
+gem 'ro-crate'
 ```
 
 and run `bundle install`.
@@ -24,20 +24,24 @@ and run `bundle install`.
 ### Examples
 
 ```ruby
-require 'ro_crate_ruby'
+require 'ro_crate'
 
 # Make a new crate
 crate = ROCrate::Crate.new
 crate.add_file(File.open('Gemfile')) # Using IO-like objects
 crate.add_file('README.md') # or paths
 
+# Quickly add everything from a directory into the crate
+crate = ROCrate::Crate.new
+crate.add_all('workspace/secret_project/dataset123')
+
 # Write to a zip file
 ROCrate::Writer.new(crate).write_zip(File.new('ro_crate.zip', 'w'))
 
 # Write to a directory
 ROCrate::Writer.new(crate).write('./ro_crate_stuff')
 
-# Read an RO crate
+# Read an RO-Crate
 crate = ROCrate::Reader.read('./an_ro_crate_directory')
 
 # Make some changes
@@ -55,9 +59,9 @@ ext_file = crate.add_external_file('https://example.com/my_file.txt')
 ROCrate::Writer.new(crate).write('./an_ro_crate_directory')
 ```
 
-### RO Crate Preview
-A simple HTML preview page is generated when an RO Crate is written, containing a list of the crate's contents and some
-metadata. This preview is written to `ro-crate-preview.html` at the root of the RO Crate.
+### RO-Crate Preview
+A simple HTML preview page is generated when an RO-Crate is written, containing a list of the crate's contents and some
+metadata. This preview is written to `ro-crate-preview.html` at the root of the RO-Crate.
 
 The default template can be seen here [here](lib/ro_crate/ro-crate-preview.html.erb).
 

data/Rakefile

@@ -24,7 +24,7 @@ end
 task :console do
   require 'irb'
   require 'irb/completion'
-  require 'ro_crate_ruby'
+  require 'ro_crate'
   ARGV.clear
   IRB.start
 end

data/lib/ro_crate/json_ld_hash.rb

@@ -1,6 +1,6 @@
 module ROCrate
   ##
-  # A wrapper class for Hash that adds methods to dereference Entities within an RO Crate.
+  # A wrapper class for Hash that adds methods to dereference Entities within an RO-Crate.
   class JSONLDHash < ::Hash
     def initialize(graph, content = {})
       @graph = graph

data/lib/ro_crate/model/contextual_entity.rb

@@ -1,6 +1,6 @@
 module ROCrate
   ##
-  # A class to represent a "Contextual Entity" within an RO Crate.
+  # A class to represent a "Contextual Entity" within an RO-Crate.
   # Contextual Entities are used to describe and provide context to the Data Entities within the crate.
   class ContextualEntity < Entity
     def self.format_id(id)

data/lib/ro_crate/model/crate.rb

@@ -1,6 +1,6 @@
 module ROCrate
   ##
-  # A Ruby abstraction of an RO Crate.
+  # A Ruby abstraction of an RO-Crate.
   class Crate < Directory
     IDENTIFIER = './'.freeze
     attr_reader :data_entities
@@ -13,7 +13,7 @@ module ROCrate
     end
 
     ##
-    # Initialize an empty RO Crate.
+    # Initialize an empty RO-Crate.
     def initialize(id = IDENTIFIER, properties = {})
       @data_entities = []
       @contextual_entities = []
@@ -24,7 +24,7 @@ module ROCrate
     # Create a new file and add it to the crate.
     #
     # @param source [String, Pathname, ::File, #read, nil] The source on the disk where this file will be read.
-    # @param crate_path [String] The relative path within the RO crate where this file will be written.
+    # @param crate_path [String] The relative path within the RO-Crate where this file will be written.
     # @param entity_class [Class] The class to use to instantiate the Entity,
     #   useful if you have created a subclass of ROCrate::File that you want to use. (defaults to ROCrate::File).
     # @param properties [Hash{String => Object}] A hash of JSON-LD properties to associate with this file.
@@ -51,7 +51,7 @@ module ROCrate
     # Create a new directory and add it to the crate.
     #
     # @param source_directory [String, Pathname, ::File, #read, nil] The source directory that will be included in the crate.
-    # @param crate_path [String] The relative path within the RO crate where this directory will be written.
+    # @param crate_path [String] The relative path within the RO-Crate where this directory will be written.
     # @param entity_class [Class] The class to use to instantiate the Entity,
     #   useful if you have created a subclass of ROCrate::Directory that you want to use. (defaults to ROCrate::Directory).
     # @param properties [Hash{String => Object}] A hash of JSON-LD properties to associate with this directory.
@@ -61,6 +61,35 @@ module ROCrate
       entity_class.new(self, source_directory, crate_path, properties).tap { |e| add_data_entity(e) }
     end
 
+    ##
+    # Recursively add the contents of the given source directory at the root of the crate.
+    # Useful for quickly RO-Crate-ifying a directory.
+    # Creates data entities for each file/directory discovered (excluding the top level directory itself) if `create_entities` is true.
+    #
+    # @param source_directory [String, Pathname, ::File,] The source directory that will be included in the crate.
+    # @param create_entities [Boolean] Whether to create data entities for the added content, or just include them anonymously.
+    # @param include_hidden [Boolean] Whether to include hidden files, i.e. those prefixed by a `.` (period).
+    #
+    # @return [Array<DataEntity>] Any entities that were created from the directory contents. Will be empty if `create_entities` was false.
+    def add_all(source_directory, create_entities = true, include_hidden: false)
+      added = []
+
+      if create_entities
+        list_all_files(source_directory, include_hidden: include_hidden).each do |rel_path|
+          source_path = Pathname.new(::File.join(source_directory, rel_path)).expand_path
+          if source_path.directory?
+            added << add_directory(source_path, rel_path)
+          else
+            added << add_file(source_path, rel_path)
+          end
+        end
+      else
+        populate_entries(Pathname.new(::File.expand_path(source_directory)), include_hidden: include_hidden)
+      end
+
+      added
+    end
+
     ##
     # Create a new ROCrate::Person and add it to the crate
     #
@@ -119,7 +148,7 @@ module ROCrate
     end
 
     ##
-    # The RO crate metadata file
+    # The RO-Crate metadata file
     #
     # @return [Metadata]
     def metadata
@@ -127,7 +156,7 @@ module ROCrate
     end
 
     ##
-    # The RO crate preview file
+    # The RO-Crate preview file
     #
     # @return [Preview]
     def preview
@@ -143,7 +172,7 @@ module ROCrate
     end
 
     ##
-    # Entities for the metadata file and crate itself, which should be present in all RO crates.
+    # Entities for the metadata file and crate itself, which should be present in all RO-Crates.
     #
     # @return [Array<Entity>]
     def default_entities
@@ -186,8 +215,9 @@ module ROCrate
       entity.class.new(crate, entity.id, entity.raw_properties)
     end
 
+    alias_method :own_entries, :entries
     ##
-    # A map of all the files/directories contained in the RO crate, where the key is the destination path within the crate
+    # A map of all the files/directories contained in the RO-Crate, where the key is the destination path within the crate
     # and the value is an Entry where the source data can be read.
     #
     # @return [Hash{String => Entry}>]
@@ -195,9 +225,8 @@ module ROCrate
       entries = {}
 
       (default_entities | data_entities).each do |entity|
-        next if entity == self
-        entity.entries.each do |path, io|
-          entries[path] = io
+        (entity == self ? own_entries : entity.entries).each do |path, entry|
+          entries[path] = entry
         end
       end
 
@@ -207,5 +236,11 @@ module ROCrate
     def get_binding
       binding
     end
+
+    private
+
+    def full_entry_path(relative_path)
+      relative_path
+    end
   end
 end

data/lib/ro_crate/model/data_entity.rb

@@ -1,6 +1,6 @@
 module ROCrate
   ##
-  # A class to represent a "Data Entity" within an RO Crate.
+  # A class to represent a "Data Entity" within an RO-Crate.
   # Data Entities are the actual physical files and directories within the Crate.
   class DataEntity < Entity
     def self.format_id(id)

data/lib/ro_crate/model/directory.rb

@@ -12,22 +12,18 @@ module ROCrate
     # Create a new Directory. PLEASE NOTE, the new directory will not be added to the crate. To do this, call
     # Crate#add_data_entity, or just use Crate#add_directory.
     #
-    # @param crate [Crate] The RO crate that owns this directory.
+    # @param crate [Crate] The RO-Crate that owns this directory.
     # @param source_directory [String, Pathname, ::File, nil] The source directory that will be included in the crate.
-    # @param crate_path [String] The relative path within the RO crate where this directory will be written.
+    # @param crate_path [String] The relative path within the RO-Crate where this directory will be written.
     # @param properties [Hash{String => Object}] A hash of JSON-LD properties to associate with this directory.
     def initialize(crate, source_directory = nil, crate_path = nil, properties = {})
       @directory_entries = {}
 
       if source_directory
-        raise 'Not a directory' unless ::File.directory?(source_directory)
         source_directory = Pathname.new(::File.expand_path(source_directory))
+        @entry = Entry.new(source_directory)
+        populate_entries(source_directory)
         crate_path = source_directory.basename.to_s if crate_path.nil?
-
-        Dir.chdir(source_directory) { Dir.glob('**/*') }.each do |rel_path|
-          source_path = Pathname.new(::File.join(source_directory, rel_path)).expand_path
-          @directory_entries[rel_path] = Entry.new(source_path)
-        end
       end
 
       super(crate, crate_path, properties)
@@ -40,9 +36,10 @@ module ROCrate
     # @return [Hash{String => Entry}>]
     def entries
       entries = {}
+      entries[filepath.chomp('/')] = @entry if @entry
 
       @directory_entries.each do |rel_path, entry|
-        entries[::File.join(filepath, rel_path)] = entry
+        entries[full_entry_path(rel_path)] = entry
       end
 
       entries
@@ -50,6 +47,37 @@ module ROCrate
 
     private
 
+    ##
+    # Populate this directory with files/directories from a given source directory on disk.
+    #
+    # @param source_directory [Pathname] The source directory to populate from.
+    # @param include_hidden [Boolean] Whether to include hidden files, i.e. those prefixed by a `.` (period).
+    #
+    # @return [Hash{String => Entry}>] The files/directories that were populated.
+    #   The key is the relative path of the file/directory, and the value is an Entry object where data can be read etc.
+    def populate_entries(source_directory, include_hidden: false)
+      raise 'Not a directory' unless ::File.directory?(source_directory)
+      @directory_entries = {}
+      list_all_files(source_directory, include_hidden: include_hidden).each do |rel_path|
+        source_path = Pathname.new(::File.join(source_directory, rel_path)).expand_path
+        @directory_entries[rel_path] = Entry.new(source_path)
+      end
+
+      @directory_entries
+    end
+
+    def full_entry_path(relative_path)
+      ::File.join(filepath, relative_path)
+    end
+
+    def list_all_files(source_directory, include_hidden: false)
+      args = ['**/*']
+      args << ::File::FNM_DOTMATCH if include_hidden
+      Dir.chdir(source_directory) { Dir.glob(*args) }.reject do |path|
+        path == '.' || path == '..' || path.end_with?('/.')
+      end
+    end
+
     def default_properties
       super.merge(
         '@id' => "#{SecureRandom.uuid}/",

data/lib/ro_crate/model/entity.rb

@@ -1,7 +1,7 @@
 module ROCrate
   ##
-  # A generic "Entity" within an RO Crate. It has an identifier and a set of properties, and will be referenced in the
-  # RO Crate Metadata's @graph.
+  # A generic "Entity" within an RO-Crate. It has an identifier and a set of properties, and will be referenced in the
+  # RO-Crate Metadata's @graph.
   class Entity
     attr_reader :crate
     attr_reader :properties
@@ -60,7 +60,7 @@ module ROCrate
     ##
     # Automatically replace an Entity or Array of Entities with a reference or Array of references. Also associates
     # the Entity/Entities with the current crate. This is useful for maintaining the flat @graph of entities that the
-    # RO crate metadata file requires.
+    # RO-Crate metadata file requires.
     #
     # @param value [Entity, Array<Entity>, Object] A value that may be reference or array of references.
     # @return [Hash, Array<Hash>, Object] Return a reference, Array of references, or just the object itself if

data/lib/ro_crate/model/entry.rb

@@ -1,6 +1,6 @@
 module ROCrate
   ##
-  # A class to represent a "physical" file or directory within an RO crate.
+  # A class to represent a "physical" file or directory within an RO-Crate.
   # It handles the actual reading/writing of bytes.
   class Entry
     attr_reader :source

data/lib/ro_crate/model/file.rb

@@ -8,9 +8,9 @@ module ROCrate
     # Create a new ROCrate::File. PLEASE NOTE, the new file will not be added to the crate. To do this, call
     # Crate#add_data_entity, or just use Crate#add_file.
     #
-    # @param crate [Crate] The RO crate that owns this file.
+    # @param crate [Crate] The RO-Crate that owns this file.
     # @param source [String, Pathname, ::File, #read, URI, nil] The source on the disk (or on the internet if a URI) where this file will be read.
-    # @param crate_path [String] The relative path within the RO crate where this file will be written.
+    # @param crate_path [String] The relative path within the RO-Crate where this file will be written.
     # @param properties [Hash{String => Object}] A hash of JSON-LD properties to associate with this file.
     def initialize(crate, source, crate_path = nil, properties = {})
       if crate_path.is_a?(Hash) && properties.empty?

data/lib/ro_crate/model/remote_entry.rb

@@ -1,6 +1,6 @@
 module ROCrate
   ##
-  # A class to represent a reference within an RO crate, to a remote file held on the internet somewhere.
+  # A class to represent a reference within an RO-Crate, to a remote file held on the internet somewhere.
   # It handles the actual reading/writing of bytes.
   class RemoteEntry
     attr_reader :uri

data/lib/ro_crate/reader.rb

@@ -1,13 +1,13 @@
 module ROCrate
   ##
-  # A class to handle reading of RO Crates from Zip files or directories.
+  # A class to handle reading of RO-Crates from Zip files or directories.
   class Reader
     ##
-    # Reads an RO Crate from a directory of zip file.
+    # Reads an RO-Crate from a directory of zip file.
     #
     # @param source [String, ::File, Pathname] The source location for the crate.
     # @param target_dir [String, ::File, Pathname] The target directory where the crate should be unzipped (if its a Zip file).
-    # @return [Crate] The RO Crate.
+    # @return [Crate] The RO-Crate.
     def self.read(source, target_dir: Dir.mktmpdir)
       raise "Not a directory!" unless ::File.directory?(target_dir)
       if ::File.directory?(source)
@@ -37,12 +37,12 @@ module ROCrate
     end
 
     ##
-    # Reads an RO Crate from a zip file. It first extracts the Zip file to a temporary directory, and then calls
+    # Reads an RO-Crate from a zip file. It first extracts the Zip file to a temporary directory, and then calls
     # #read_directory.
     #
     # @param source [String, ::File, Pathname] The location of the zip file.
     # @param target_dir [String, ::File, Pathname] The target directory where the crate should be unzipped.
-    # @return [Crate] The RO Crate.
+    # @return [Crate] The RO-Crate.
     def self.read_zip(source, target_dir: Dir.mktmpdir)
       unzip_to(source, target_dir)
 
@@ -50,10 +50,10 @@ module ROCrate
     end
 
     ##
-    # Reads an RO Crate from a directory.
+    # Reads an RO-Crate from a directory.
     #
     # @param source [String, ::File, Pathname] The location of the directory.
-    # @return [Crate] The RO Crate.
+    # @return [Crate] The RO-Crate.
     def self.read_directory(source)
       source = ::File.expand_path(source)
       metadata_file = Dir.entries(source).detect { |entry| entry == ROCrate::Metadata::IDENTIFIER ||
@@ -68,7 +68,7 @@ module ROCrate
     end
 
     ##
-    # Extracts all the entities from the @graph of the RO Crate Metadata.
+    # Extracts all the entities from the @graph of the RO-Crate Metadata.
     #
     # @param metadata_json [String] A string containing the metadata JSON.
     # @return [Hash{String => Hash}] A Hash of all the entities, mapped by their @id.
@@ -99,12 +99,14 @@ module ROCrate
     # Create a crate from the given set of entities.
     #
     # @param entity_hash [Hash{String => Hash}] A Hash containing all the entities in the @graph, mapped by their @id.
-    # @param source [String, ::File, Pathname] The location of the RO Crate being read.
-    # @return [Crate] The RO Crate.
+    # @param source [String, ::File, Pathname] The location of the RO-Crate being read.
+    # @return [Crate] The RO-Crate.
     def self.build_crate(entity_hash, source)
       ROCrate::Crate.new.tap do |crate|
         crate.properties = entity_hash.delete(ROCrate::Crate::IDENTIFIER)
         crate.metadata.properties = entity_hash.delete(ROCrate::Metadata::IDENTIFIER)
+        preview_properties = entity_hash.delete(ROCrate::Preview::IDENTIFIER)
+        crate.preview.properties = preview_properties if preview_properties
         extract_data_entities(crate, source, entity_hash).each do |entity|
           crate.add_data_entity(entity)
         end
@@ -118,8 +120,8 @@ module ROCrate
     ##
     # Discover data entities from the `hasPart` property of a crate, and create DataEntity objects for them.
     # Entities are looked up in the given `entity_hash` (and then removed from it).
-    # @param crate [Crate] The RO Crate being read.
-    # @param source [String, ::File, Pathname] The location of the RO Crate being read.
+    # @param crate [Crate] The RO-Crate being read.
+    # @param source [String, ::File, Pathname] The location of the RO-Crate being read.
     # @param entity_hash [Hash] A Hash containing all the entities in the @graph, mapped by their @id.
     # @return [Array<ROCrate::File, ROCrate::Directory>] The extracted DataEntity objects.
     def self.extract_data_entities(crate, source, entity_hash)
@@ -135,7 +137,7 @@ module ROCrate
 
     ##
     # Create appropriately specialized ContextualEntity objects from the given hash of entities and their properties.
-    # @param crate [Crate] The RO Crate being read.
+    # @param crate [Crate] The RO-Crate being read.
     # @param entity_hash [Hash] A Hash containing all the entities in the @graph, mapped by their @id.
     # @return [Array<ContextualEntity>] The extracted ContextualEntity objects.
     def self.extract_contextual_entities(crate, entity_hash)
@@ -152,8 +154,8 @@ module ROCrate
 
     ##
     # Create a DataEntity of the given class.
-    # @param crate [Crate] The RO Crate being read.
-    # @param source [String, ::File, Pathname] The location of the RO Crate being read.
+    # @param crate [Crate] The RO-Crate being read.
+    # @param source [String, ::File, Pathname] The location of the RO-Crate being read.
     # @param entity_props [Hash] A Hash containing the entity's properties, including its @id.
     # @return [ROCrate::File, ROCrate::Directory, nil] The DataEntity object,
     #          or nil if it referenced a local file that wasn't found.

data/lib/ro_crate/ro-crate-preview.html.erb

@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <html>
 <head>
-  <title><%= name || "New RO Crate" %></title>
+  <title><%= name || "New RO-Crate" %></title>
   <script type="application/ld+json"><%= metadata.generate %></script>
   <meta name="generator" content="https://github.com/fbacall/ro-crate-ruby">
-  <meta name="keywords" content="RO Crate">
+  <meta name="keywords" content="RO-Crate">
 </head>
 <body>
-  <h1><%= name || "New RO Crate" %></h1>
+  <h1><%= name || "New RO-Crate" %></h1>
   <% if url %>
     <a href="<%= url %>" target="_blank"><%= url %></a>
   <% end %>

data/lib/ro_crate/writer.rb

@@ -1,10 +1,10 @@
 module ROCrate
   ##
-  # A class to handle writing of RO Crates to Zip files or directories.
+  # A class to handle writing of RO-Crates to Zip files or directories.
   class Writer
     ##
     # Initialize a new Writer for the given Crate.
-    # @param crate [Crate] The RO Crate to be written.
+    # @param crate [Crate] The RO-Crate to be written.
     def initialize(crate)
       @crate = crate
     end
@@ -35,7 +35,7 @@ module ROCrate
     ##
     # Write the crate to a zip file.
     #
-    # @param destination [String, ::File] The destination where to write the RO Crate zip.
+    # @param destination [String, ::File] The destination where to write the RO-Crate zip.
     def write_zip(destination)
       Zip::File.open(destination, Zip::File::CREATE) do |zip|
         @crate.entries.each do |path, entry|

data/ro_crate.gemspec

@@ -1,7 +1,7 @@
 Gem::Specification.new do |s|
   s.name        = 'ro-crate'
-  s.version     = '0.4.0'
-  s.summary     = 'Create, manipulate, read RO crates.'
+  s.version     = '0.4.5'
+  s.summary     = 'Create, manipulate, read RO-Crates.'
   s.authors     = ['Finn Bacall']
   s.email       = 'finn.bacall@manchester.ac.uk'
   s.files       = `git ls-files`.split("\n")

data/test/crate_test.rb

@@ -198,4 +198,99 @@ class CrateTest < Test::Unit::TestCase
     assert_equal file, new_crate.get('some/file.txt')
     assert_equal file, new_crate.get('http://mycoolwebsite.golf/ro_crate/some/file.txt')
   end
+
+  test 'can add an entire directory tree as data entities' do
+    crate = ROCrate::Crate.new
+    entities = crate.add_all(fixture_file('directory').path, include_hidden: true)
+
+    paths = crate.entries.keys
+    assert_equal 11, paths.length
+    assert_includes paths, 'data'
+    assert_includes paths, 'root.txt'
+    assert_includes paths, 'info.txt'
+    assert_includes paths, 'data/binary.jpg'
+    assert_includes paths, 'data/info.txt'
+    assert_includes paths, 'data/nested.txt'
+    assert_includes paths, '.dotfile'
+    assert_includes paths, '.dir'
+    assert_includes paths, '.dir/test.txt'
+    assert_includes paths, 'ro-crate-metadata.json'
+    assert_includes paths, 'ro-crate-preview.html'
+
+    assert_equal 9, entities.length
+    assert_equal 'ROCrate::Directory', crate.dereference('data/').class.name
+    assert_equal 'ROCrate::File', crate.dereference('root.txt').class.name
+    assert_equal 'ROCrate::File', crate.dereference('info.txt').class.name
+    assert_equal 'ROCrate::File', crate.dereference('data/binary.jpg').class.name
+    assert_equal 'ROCrate::File', crate.dereference('data/info.txt').class.name
+    assert_equal 'ROCrate::File', crate.dereference('data/nested.txt').class.name
+    assert_equal 'ROCrate::File', crate.dereference('.dotfile').class.name
+    assert_equal 'ROCrate::Directory', crate.dereference('.dir/').class.name
+    assert_equal 'ROCrate::File', crate.dereference('.dir/test.txt').class.name
+
+    assert_equal "5678\n", crate.dereference('data/info.txt').source.read
+    assert_equal "Am I included?\n", crate.dereference('.dotfile').source.read
+  end
+
+  test 'can create an RO-Crate using content from a given directory' do
+    crate = ROCrate::Crate.new
+    entities = crate.add_all(fixture_file('directory').path, false, include_hidden: true)
+
+    assert_empty entities
+
+    paths = crate.entries.keys
+    assert_equal 11, paths.length
+    assert_includes paths, 'data'
+    assert_includes paths, 'root.txt'
+    assert_includes paths, 'info.txt'
+    assert_includes paths, 'data/binary.jpg'
+    assert_includes paths, 'data/info.txt'
+    assert_includes paths, 'data/nested.txt'
+    assert_includes paths, '.dotfile'
+    assert_includes paths, '.dir'
+    assert_includes paths, '.dir/test.txt'
+    assert_includes paths, 'ro-crate-metadata.json'
+    assert_includes paths, 'ro-crate-preview.html'
+
+    # Should not create any data entities
+    assert_nil crate.dereference('data/')
+    assert_nil crate.dereference('root.txt')
+    assert_nil crate.dereference('info.txt')
+    assert_nil crate.dereference('data/binary.jpg')
+    assert_nil crate.dereference('data/info.txt')
+    assert_nil crate.dereference('data/nested.txt')
+    assert_nil crate.dereference('.dotfile')
+  end
+
+  test 'can create an RO-Crate using content from a given directory, excluding hidden files' do
+    crate = ROCrate::Crate.new
+    entities = crate.add_all(fixture_file('directory').path)
+
+    paths = crate.entries.keys
+    assert_equal 8, paths.length
+    assert_includes paths, 'data'
+    assert_includes paths, 'root.txt'
+    assert_includes paths, 'info.txt'
+    assert_includes paths, 'data/binary.jpg'
+    assert_includes paths, 'data/info.txt'
+    assert_includes paths, 'data/nested.txt'
+    assert_not_includes paths, '.dotfile'
+    assert_not_includes paths, '.dir'
+    assert_not_includes paths, '.dir/test.txt'
+    assert_includes paths, 'ro-crate-metadata.json'
+    assert_includes paths, 'ro-crate-preview.html'
+
+    assert_equal 6, entities.length
+    assert_equal 'ROCrate::Directory', crate.dereference('data/').class.name
+    assert_equal 'ROCrate::File', crate.dereference('root.txt').class.name
+    assert_equal 'ROCrate::File', crate.dereference('info.txt').class.name
+    assert_equal 'ROCrate::File', crate.dereference('data/binary.jpg').class.name
+    assert_equal 'ROCrate::File', crate.dereference('data/info.txt').class.name
+    assert_equal 'ROCrate::File', crate.dereference('data/nested.txt').class.name
+    assert_nil crate.dereference('.dotfile')
+    assert_nil crate.dereference('.dir/')
+    assert_nil crate.dereference('.dir/test.txt')
+
+    assert_equal "5678\n", crate.dereference('data/info.txt').source.read
+  end
 end

data/test/fixtures/directory/.dir/test.txt

@@ -0,0 +1 @@
+123

data/test/fixtures/directory/.dotfile

@@ -0,0 +1 @@
+Am I included?

data/test/fixtures/directory_crate/ro-crate-metadata.jsonld

@@ -8,6 +8,13 @@
         "@id": "./"
       }
     },
+    {
+      "@id": "ro-crate-preview.html",
+      "@type": "CreativeWork",
+      "about": {
+        "@id": "./"
+      }
+    },
     {
       "@id": "./",
       "@type": "Dataset",

data/test/fixtures/directory_crate/ro-crate-preview.html

@@ -0,0 +1,66 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>New RO-Crate</title>
+  <script type="application/ld+json">{
+  "@context": "https://w3id.org/ro/crate/1.1/context",
+  "@graph": [
+    {
+      "@id": "ro-crate-metadata.jsonld",
+      "@type": "CreativeWork",
+      "about": {
+        "@id": "./"
+      }
+    },
+    {
+      "@id": "ro-crate-preview.html",
+      "@type": "CreativeWork",
+      "about": {
+        "@id": "./"
+      }
+    },
+    {
+      "@id": "./",
+      "@type": "Dataset",
+      "hasPart": [
+        {
+          "@id": "fish/"
+        }
+      ]
+    },
+    {
+      "@id": "fish/",
+      "@type": "Dataset"
+    }
+  ]
+}</script>
+  <meta name="generator" content="https://github.com/fbacall/ro-crate-ruby">
+  <meta name="keywords" content="RO-Crate">
+</head>
+<body>
+  <h1>New RO-Crate</h1>
+  
+  <p>
+    
+  </p>
+  <dl>
+    
+    
+    
+    
+  </dl>
+
+  <h2>Contents</h2>
+  <ul>
+    
+      <li id="__data_entity_fish/">
+        
+          <strong>fish/</strong>
+        
+        
+        
+      </li>
+    
+  </ul>
+</body>
+</html>

data/test/reader_test.rb

@@ -109,11 +109,13 @@ class ReaderTest < Test::Unit::TestCase
   test 'reading from directory with directories' do
     crate = ROCrate::Reader.read_directory(fixture_file('directory_crate').path)
 
+    assert crate.entries.values.all? { |e| e.is_a?(ROCrate::Entry) }
     assert crate.entries['fish/info.txt']
     assert_equal '1234', crate.entries['fish/info.txt'].source.read.chomp
-    assert crate.entries['fish/root.txt']
+    refute crate.entries['fish/root.txt'].directory?
+    assert crate.entries['fish/data'].directory?
     assert crate.entries['fish/data/info.txt']
-    assert crate.entries['fish/data/nested.txt']
+    refute crate.entries['fish/data/nested.txt'].remote?
     assert crate.entries['fish/data/binary.jpg']
     assert_equal ['./', 'fish/', 'ro-crate-metadata.jsonld', 'ro-crate-preview.html'], crate.entities.map(&:id).sort
   end

data/test/test_helper.rb

@@ -2,7 +2,7 @@ require 'simplecov'
 SimpleCov.start
 
 require 'test/unit'
-require 'ro_crate_ruby'
+require 'ro_crate'
 require 'webmock/test_unit'
 
 def fixture_file(name, *args)

data/test/writer_test.rb

@@ -99,4 +99,17 @@ class WriterTest < Test::Unit::TestCase
       end
     end
   end
+
+  test 'should write out same contents that it was created with' do
+    crate = ROCrate::Crate.new
+    crate.add_all(fixture_file('directory').path, false)
+
+    Dir.mktmpdir do |dir|
+      ROCrate::Writer.new(crate).write(dir)
+      assert ::File.exist?(::File.join(dir, ROCrate::Metadata::IDENTIFIER))
+      assert ::File.exist?(::File.join(dir, ROCrate::Preview::IDENTIFIER))
+      assert_equal 5, ::File.size(::File.join(dir, 'info.txt'))
+      assert_equal 2529, ::File.size(::File.join(dir, 'data', 'binary.jpg'))
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ro-crate
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.5
 platform: ruby
 authors:
 - Finn Bacall
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-01-18 00:00:00.000000000 Z
+date: 2021-02-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -123,6 +123,7 @@ files:
 - LICENSE
 - README.md
 - Rakefile
+- lib/ro_crate.rb
 - lib/ro_crate/json_ld_hash.rb
 - lib/ro_crate/model/contact_point.rb
 - lib/ro_crate/model/contextual_entity.rb
@@ -140,7 +141,6 @@ files:
 - lib/ro_crate/reader.rb
 - lib/ro_crate/ro-crate-preview.html.erb
 - lib/ro_crate/writer.rb
-- lib/ro_crate_ruby.rb
 - ro_crate.gemspec
 - test/crate_test.rb
 - test/directory_test.rb
@@ -149,6 +149,8 @@ files:
 - test/fixtures/crate-spec1.1/ro-crate-metadata.json
 - test/fixtures/data.csv
 - test/fixtures/directory.zip
+- test/fixtures/directory/.dir/test.txt
+- test/fixtures/directory/.dotfile
 - test/fixtures/directory/data/binary.jpg
 - test/fixtures/directory/data/info.txt
 - test/fixtures/directory/data/nested.txt
@@ -160,6 +162,7 @@ files:
 - test/fixtures/directory_crate/fish/info.txt
 - test/fixtures/directory_crate/fish/root.txt
 - test/fixtures/directory_crate/ro-crate-metadata.jsonld
+- test/fixtures/directory_crate/ro-crate-preview.html
 - test/fixtures/file with spaces.txt
 - test/fixtures/info.txt
 - test/fixtures/spaces/file with spaces.txt
@@ -2414,5 +2417,5 @@ requirements: []
 rubygems_version: 3.0.8
 signing_key: 
 specification_version: 4
-summary: Create, manipulate, read RO crates.
+summary: Create, manipulate, read RO-Crates.
 test_files: []