rdf-ordered-repo 3.1.1 → 3.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fc5e91c1a02e80cf40af709aa558cd390611332be606ad91ad8a3ca24aaf52a1
-  data.tar.gz: 3f58ec48ccfbfc60c3c330abfce97b9e59563d69f148ea4683dc81554f3a367b
+  metadata.gz: bb8d7a4252659d073d36fe704be60b62b0aff55dfae646c75a38f6cfb38743cd
+  data.tar.gz: 5f58fc30cd2a5fa368edf75d5c39b5769176ca46d652927e394a1757ae6291a1
 SHA512:
-  metadata.gz: e50c14fbc7e26878fe8451e1301c805243a65b1e494360117e659f6884c7f249ddbe7b11f93900bb647eee2ae0fbf1802b48506c3b449a2be3e2c230aa0e07f0
-  data.tar.gz: 2a77db136037a680165a105c0227aac78216edc2deef58116259199e263eb8cc94619676f3ad5d90f1ef84cf08c08a23ce153e98ad2bf251f4e4b0ebfdd5d1fc
+  metadata.gz: dd1df97330d99e8c99c03176d810e889f50ab1f1fd4e5f5697107a389a3e3d52451256d4418721e7396fc6c8b2c7cbf144bcb7ed2f4accc75251ac3d50cef037
+  data.tar.gz: '011816332e445274b75221754e57927137d88ebaa80821cd05cc5188069a9869e0f4e8e0ec8d8e2406e8134d016dddbf3ec09d92e684fbfe261109209d68cd6c'

data/README.md

@@ -3,7 +3,9 @@
 An order-preserving repository for RDF.rb.
 
 [![Gem Version](https://badge.fury.io/rb/rdf-ordered-repo.png)](https://badge.fury.io/rb/rdf-ordered-repo)
-[![Build Status](https://travis-ci.org/ruby-rdf/rdf-ordered-repo.png?branch=master)](https://travis-ci.org/ruby-rdf/rdf-ordered-repo)
+[![Build Status](https://github.com/ruby-rdf/rdf-ordered-repo/workflows/CI/badge.svg?branch=develop)](https://github.com/ruby-rdf/rdf-ordered-repo/actions?query=workflow%3ACI)
+[![Coverage Status](https://coveralls.io/repos/ruby-rdf/rdf-ordered-repo/badge.svg?branch=develop)](https://coveralls.io/github/ruby-rdf/rdf-ordered-repo?branch=develop)
+[![Gitter chat](https://badges.gitter.im/ruby-rdf/rdf.png)](https://gitter.im/ruby-rdf/rdf)
 
 ## Description
 
@@ -17,8 +19,8 @@ An in-memory implementation of RDF::Repository using native Ruby Hashes having i
 
 ## Dependencies
 
-* [Ruby](https://ruby-lang.org/) (>= 2.4)
-* [RDF.rb][] (~> 3.1)
+* [Ruby](https://ruby-lang.org/) (>= 2.6)
+* [RDF.rb][] (~> 3.2)
 
 ## Mailing List
 

data/VERSION

@@ -1 +1 @@
-3.1.1
+3.2.0

data/etc/doap.ttl

@@ -12,7 +12,7 @@
   doap:homepage      <https://github.com/ruby-rdf/rdf-ordered-repo> ;
   doap:license       <https://unlicense.org/1.0/> ;
   doap:shortdesc     "An order-preserving repository for RDF.rb."@en ;
-  doap:description   "An in-memory implementation of RDF::Repository using native Ruby Hashes having insert-order preserving properties."@en ;
+  doap:description   "An in-memory implementation of RDF::Repository using native Ruby Hashes having insert-order preserving properties for the Ruby RDF.rb library suite."@en ;
   doap:created       "2020-09-22"^^xsd:date;
   doap:programming-language "Ruby" ;
   doap:implements    <http://www.w3.org/TR/rdf11-concepts/> ;
@@ -23,7 +23,6 @@
   doap:bug-database  <https://github.com/ruby-rdf/rdf-ordered-repo/issues> ;
   doap:blog          <https://greggkellogg.net/> ;
   doap:developer     <https://greggkellogg.net/foaf#me> ;
-  doap:helper        <http://njh.me/> ;
   doap:maintainer    <https://greggkellogg.net/foaf#me> ;
   doap:documenter    <https://greggkellogg.net/foaf#me> ;
   foaf:maker         <https://greggkellogg.net/foaf#me> ;

data/lib/rdf/ordered_repo.rb

@@ -40,7 +40,7 @@ module RDF
     def supports?(feature)
       case feature.to_sym
       when :rdfstar          then true
-      when :snapshots        then false
+      when :snapshots        then true
       else super
       end
     end
@@ -71,11 +71,24 @@ module RDF
     end
     
     ##
-    # @private
-    # @see RDF::Enumerable#has_graph?      
-    def has_graph?(graph)
-      @data.has_key?(graph)
+    # @overload graph?
+    #   Returns `false` to indicate that this is not a graph.
+    #
+    #   @return [Boolean]
+    # @overload graph?(name)
+    #   Returns `true` if `self` contains the given RDF graph_name.
+    #
+    #   @param  [RDF::Resource, false] graph_name
+    #     Use value `false` to query for the default graph_name
+    #   @return [Boolean]
+    def graph?(*args)
+      case args.length
+      when 0 then false
+      when 1 then @data.key?(args.first)
+      else raise ArgumentError("wrong number of arguments (given #{args.length}, expected 0 or 1)")
+      end
     end
+    alias_method :has_graph?, :graph?
 
     ##
     # @private
@@ -97,11 +110,21 @@ module RDF
     end
 
     ##
-    # @private
-    # @see RDF::Enumerable#has_statement?
-    def has_statement?(statement)
-      has_statement_in?(@data, statement)
+    # @overload statement?
+    #   Returns `false` indicating this is not an RDF::Statemenet.
+    #   @return [Boolean]
+    #   @see RDF::Value#statement?
+    # @overload statement?(statement)
+    #   @private
+    #   @see    RDF::Enumerable#statement?
+    def statement?(*args)
+      case args.length
+      when 0 then false
+      when 1 then args.first && statement_in?(@data, args.first)
+      else raise ArgumentError("wrong number of arguments (given #{args.length}, expected 0 or 1)")
+      end
     end
+    alias_method :has_statement?, :statement?
 
     ##
     # @private
@@ -141,7 +164,18 @@ module RDF
     ##
     # @see RDF::Dataset#isolation_level
     def isolation_level
-      :serializable
+      :snapshot
+    end
+
+    ##
+    # A readable & queryable snapshot of the repository for isolated reads. 
+    # 
+    # @return [Dataset] an immutable Dataset containing a current snapshot of
+    #   the Repository contents.
+    #
+    # @see Mutable#snapshot
+    def snapshot
+      self.class.new(data: @data).freeze
     end
 
     protected
@@ -157,13 +191,14 @@ module RDF
     # @private
     # @see RDF::Queryable#query_pattern
     def query_pattern(pattern, **options, &block)
+      snapshot = @data
       if block_given?
         graph_name  = pattern.graph_name
         subject     = pattern.subject
         predicate   = pattern.predicate
         object      = pattern.object
 
-        cs = @data.has_key?(graph_name) ? { graph_name => @data[graph_name] } : @data
+        cs = snapshot.has_key?(graph_name) ? { graph_name => snapshot[graph_name] } : snapshot
 
         cs.each do |c, ss|
           next unless graph_name.nil? ||
@@ -221,7 +256,7 @@ module RDF
     # @private
     # @see RDF::Mutable#clear
     def clear_statements
-      @data = @data.clear
+      @data = @data.class.new
     end
 
     ##
@@ -242,16 +277,17 @@ module RDF
 
     ##
     # @private
-    # @see #has_statement
-    def has_statement_in?(data, statement)
+    # @see #statement?
+    def statement_in?(data, statement)
       s, p, o, g = statement.to_quad
       g ||= DEFAULT_GRAPH
 
-      data.has_key?(g) &&
-        data[g].has_key?(s) &&
-        data[g][s].has_key?(p) &&
-        data[g][s][p].has_key?(o)
+      data.key?(g) &&
+        data[g].key?(s) &&
+        data[g][s].key?(p) &&
+        data[g][s][p].key?(o)
     end
+    alias_method :has_statement_in?, :statement_in?
 
     ##
     # @private
@@ -259,7 +295,7 @@ module RDF
     def insert_to(data, statement)
       raise ArgumentError, "Statement #{statement.inspect} is incomplete" if statement.incomplete?
 
-      unless has_statement_in?(data, statement)
+      unless statement_in?(data, statement)
         s, p, o, c = statement.to_quad
         c ||= DEFAULT_GRAPH
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rdf-ordered-repo
 version: !ruby/object:Gem::Version
-  version: 3.1.1
+  version: 3.2.0
 platform: ruby
 authors:
 - Gregg Kellogg
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-10-29 00:00:00.000000000 Z
+date: 2021-12-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rdf
@@ -16,56 +16,56 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: '3.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: '3.2'
 - !ruby/object:Gem::Dependency
   name: rdf-spec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: '3.2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: '3.2'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.9'
+        version: '3.10'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.9'
+        version: '3.10'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.20
+        version: '0.9'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.20
+        version: '0.9'
 description: An in-memory implementation of RDF::Repository using native Ruby Hashes
   having insert-order preserving properties.
 email: public-rdf-ruby@w3.org
@@ -91,14 +91,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.4'
+      version: '2.6'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.3.3
 signing_key:
 specification_version: 4
 summary: An order-preserving repository for RDF.rb.