rdf 0.1.8 → 0.1.9

data/VERSION

@@ -1 +1 @@
-0.1.8
+0.1.9

data/lib/rdf/mixin/enumerable.rb

@@ -87,8 +87,8 @@ module RDF
     #
     # @param  [Hash{Symbol => Boolean}] options
     # @return [Array<Statement>]
-    # @see #each_statement
-    # @see #enum_statement
+    # @see    #each_statement
+    # @see    #enum_statement
     def statements(options = {})
       enum_statement.to_a
     end
@@ -116,7 +116,7 @@ module RDF
     #   @return [Enumerator]
     #
     # @return [void]
-    # @see #enum_statement
+    # @see    #enum_statement
     def each_statement(&block)
       if block_given?
         # Invoke {#each} in the containing class:
@@ -130,7 +130,7 @@ module RDF
     # Returns an enumerator for {#each_statement}.
     #
     # @return [Enumerator]
-    # @see #each_statement
+    # @see    #each_statement
     def enum_statement
       Enumerator.new(self, :each_statement)
     end
@@ -142,8 +142,8 @@ module RDF
     #
     # @param  [Hash{Symbol => Boolean}] options
     # @return [Array<Array(Resource, URI, Value)>]
-    # @see #each_triple
-    # @see #enum_triple
+    # @see    #each_triple
+    # @see    #enum_triple
     def triples(options = {})
       enum_statement.map { |statement| statement.to_triple }
     end
@@ -173,7 +173,7 @@ module RDF
     #   @return [Enumerator]
     #
     # @return [void]
-    # @see #enum_triple
+    # @see    #enum_triple
     def each_triple(&block)
       if block_given?
         each_statement do |statement|
@@ -188,7 +188,7 @@ module RDF
     # Returns an enumerator for {#each_triple}.
     #
     # @return [Enumerator]
-    # @see #each_triple
+    # @see    #each_triple
     def enum_triple
       Enumerator.new(self, :each_triple)
     end
@@ -200,8 +200,8 @@ module RDF
     #
     # @param  [Hash{Symbol => Boolean}] options
     # @return [Array<Array(Resource, URI, Value, Resource)>]
-    # @see #each_quad
-    # @see #enum_quad
+    # @see    #each_quad
+    # @see    #enum_quad
     def quads(options = {})
       enum_statement.map { |statement| statement.to_quad }
     end
@@ -232,7 +232,7 @@ module RDF
     #   @return [Enumerator]
     #
     # @return [void]
-    # @see #enum_quad
+    # @see    #enum_quad
     def each_quad(&block)
       if block_given?
         each_statement do |statement|
@@ -247,7 +247,7 @@ module RDF
     # Returns an enumerator for {#each_quad}.
     #
     # @return [Enumerator]
-    # @see #each_quad
+    # @see    #each_quad
     def enum_quad
       Enumerator.new(self, :each_quad)
     end
@@ -260,8 +260,8 @@ module RDF
     # @param  [Hash{Symbol => Boolean}] options
     # @option options [Boolean] :unique (true)
     # @return [Array<Resource>]
-    # @see #each_subject
-    # @see #enum_subject
+    # @see    #each_subject
+    # @see    #enum_subject
     def subjects(options = {})
       if options[:unique] == false
         enum_statement.map { |statement| statement.subject }
@@ -293,7 +293,7 @@ module RDF
     #   @return [Enumerator]
     #
     # @return [void]
-    # @see #enum_subject
+    # @see    #enum_subject
     def each_subject(&block)
       if block_given?
         values = {}
@@ -313,7 +313,7 @@ module RDF
     # Returns an enumerator for {#each_subject}.
     #
     # @return [Enumerator]
-    # @see #each_subject
+    # @see    #each_subject
     def enum_subject
       Enumerator.new(self, :each_subject)
     end
@@ -326,8 +326,8 @@ module RDF
     # @param  [Hash{Symbol => Boolean}] options
     # @option options [Boolean] :unique (true)
     # @return [Array<URI>]
-    # @see #each_predicate
-    # @see #enum_predicate
+    # @see    #each_predicate
+    # @see    #enum_predicate
     def predicates(options = {})
       if options[:unique] == false
         enum_statement.map { |statement| statement.predicate }
@@ -359,7 +359,7 @@ module RDF
     #   @return [Enumerator]
     #
     # @return [void]
-    # @see #enum_predicate
+    # @see    #enum_predicate
     def each_predicate(&block)
       if block_given?
         values = {}
@@ -379,7 +379,7 @@ module RDF
     # Returns an enumerator for {#each_predicate}.
     #
     # @return [Enumerator]
-    # @see #each_predicate
+    # @see    #each_predicate
     def enum_predicate
       Enumerator.new(self, :each_predicate)
     end
@@ -392,8 +392,8 @@ module RDF
     # @param  [Hash{Symbol => Boolean}] options
     # @option options [Boolean] :unique (true)
     # @return [Array<Value>]
-    # @see #each_object
-    # @see #enum_object
+    # @see    #each_object
+    # @see    #enum_object
     def objects(options = {})
       if options[:unique] == false
         enum_statement.map { |statement| statement.object }
@@ -425,7 +425,7 @@ module RDF
     #   @return [Enumerator]
     #
     # @return [void]
-    # @see #enum_object
+    # @see    #enum_object
     def each_object(&block) # FIXME: deduplication
       if block_given?
         values = {}
@@ -445,7 +445,7 @@ module RDF
     # Returns an enumerator for {#each_object}.
     #
     # @return [Enumerator]
-    # @see #each_object
+    # @see    #each_object
     def enum_object
       Enumerator.new(self, :each_object)
     end
@@ -458,8 +458,8 @@ module RDF
     # @param  [Hash{Symbol => Boolean}] options
     # @option options [Boolean] :unique (true)
     # @return [Array<Resource>]
-    # @see #each_context
-    # @see #enum_context
+    # @see    #each_context
+    # @see    #enum_context
     def contexts(options = {})
       if options[:unique] == false
         enum_statement.map { |statement| statement.context }
@@ -491,7 +491,7 @@ module RDF
     #   @return [Enumerator]
     #
     # @return [void]
-    # @see #enum_context
+    # @see    #enum_context
     def each_context(&block)
       if block_given?
         values = {}
@@ -511,13 +511,52 @@ module RDF
     # Returns an enumerator for {#each_context}.
     #
     # @return [Enumerator]
-    # @see #each_context
+    # @see    #each_context
     def enum_context
       Enumerator.new(self, :each_context)
     end
 
     alias_method :enum_contexts, :enum_context
 
+    ##
+    # Iterates the given block for each RDF graph in `self`.
+    #
+    # If no block was given, returns an enumerator.
+    #
+    # @overload each_graph
+    #   @yield  [graph]
+    #   @yieldparam [RDF::Graph] graph
+    #   @return [void]
+    #
+    # @overload each_graph
+    #   @return [Enumerator]
+    #
+    # @return [void]
+    # @see    #enum_graph
+    # @since  0.1.19
+    def each_graph(&block)
+      if block_given?
+        block.call(RDF::Graph.new(nil, :data => self))
+        each_context do |context|
+          block.call(RDF::Graph.new(context, :data => self))
+        end
+      else
+        enum_graph
+      end
+    end
+
+    ##
+    # Returns an enumerator for {#each_graph}.
+    #
+    # @return [Enumerator]
+    # @see    #each_graph
+    # @since  0.1.19
+    def enum_graph
+      Enumerator.new(self, :each_graph)
+    end
+
+    alias_method :enum_graphs, :enum_graph
+
     ##
     # Returns all RDF objects indexed by their subjects and predicates.
     #

data/lib/rdf/mixin/queryable.rb

@@ -11,7 +11,7 @@ module RDF
     include ::Enumerable
 
     ##
-    # Queries `self` for RDF statements matching the given pattern.
+    # Queries `self` for RDF statements matching the given `pattern`.
     #
     # @example
     #     queryable.query([nil, RDF::DOAP.developer, nil])
@@ -22,7 +22,7 @@ module RDF
     # @yieldparam [Statement]
     # @return [Array<Statement>]
     def query(pattern, &block)
-      raise TypeError.new("#{self} is not readable") if respond_to?(:readable) && !readable?
+      raise TypeError.new("#{self} is not readable") if respond_to?(:readable?) && !readable?
 
       case pattern
         when Query
@@ -41,5 +41,140 @@ module RDF
           raise ArgumentError.new("expected RDF::Query, RDF::Pattern, Array or Hash, but got #{pattern.inspect}")
       end
     end
+
+    ##
+    # Queries `self` for an RDF statement matching the given `pattern` and
+    # returns that statement if found.
+    #
+    # Returns `nil` if no statements match `pattern`.
+    #
+    # @overload first
+    #   @return [RDF::Statement]
+    #
+    # @overload first(pattern)
+    #   @param  [Query, Statement, Array(Value), Hash] pattern
+    #   @return [RDF::Statement]
+    #
+    # @return [RDF::Statement]
+    # @since  0.1.19
+    def first(pattern = nil)
+      if pattern
+        query(pattern) do |statement|
+          return statement
+        end
+        return nil
+      else
+        super()
+      end
+    end
+
+    ##
+    # Queries `self` for an RDF statement matching the given `pattern` and
+    # returns the statement's subject term.
+    #
+    # Returns `nil` if no statements match `pattern`.
+    #
+    # @overload first_subject
+    #   @return [RDF::Resource]
+    #
+    # @overload first_subject(pattern)
+    #   @param  [Query, Statement, Array(Value), Hash] pattern
+    #   @return [RDF::Resource]
+    #
+    # @return [RDF::Resource]
+    # @since  0.1.19
+    def first_subject(pattern = nil)
+      __send__(*(pattern ? [:query, pattern] : [:each])) do |statement|
+        return statement.subject
+      end
+      return nil
+    end
+
+    ##
+    # Queries `self` for an RDF statement matching the given `pattern` and
+    # returns the statement's predicate term.
+    #
+    # Returns `nil` if no statements match `pattern`.
+    #
+    # @overload first_predicate
+    #   @return [RDF::URI]
+    #
+    # @overload first_predicate(pattern)
+    #   @param  [Query, Statement, Array(Value), Hash] pattern
+    #   @return [RDF::URI]
+    #
+    # @return [RDF::URI]
+    # @since  0.1.19
+    def first_predicate(pattern = nil)
+      __send__(*(pattern ? [:query, pattern] : [:each])) do |statement|
+        return statement.predicate
+      end
+      return nil
+    end
+
+    ##
+    # Queries `self` for an RDF statement matching the given `pattern` and
+    # returns the statement's object term.
+    #
+    # Returns `nil` if no statements match `pattern`.
+    #
+    # @overload first_object
+    #   @return [RDF::Value]
+    #
+    # @overload first_object(pattern)
+    #   @param  [Query, Statement, Array(Value), Hash] pattern
+    #   @return [RDF::Value]
+    #
+    # @return [RDF::Value]
+    # @since  0.1.19
+    def first_object(pattern = nil)
+      __send__(*(pattern ? [:query, pattern] : [:each])) do |statement|
+        return statement.object
+      end
+      return nil
+    end
+
+    ##
+    # Queries `self` for RDF statements matching the given `pattern` and
+    # returns the first found object literal.
+    #
+    # Returns `nil` if no statements match `pattern` or if none of the found
+    # statements have a literal as their object term.
+    #
+    # @overload first_literal
+    #   @return [RDF::Literal]
+    #
+    # @overload first_literal(pattern)
+    #   @param  [Query, Statement, Array(Value), Hash] pattern
+    #   @return [RDF::Literal]
+    #
+    # @return [RDF::Literal]
+    # @since  0.1.19
+    def first_literal(pattern = nil)
+      __send__(*(pattern ? [:query, pattern] : [:each])) do |statement|
+        return statement.object if statement.object.is_a?(RDF::Literal)
+      end
+      return nil
+    end
+
+    ##
+    # Queries `self` for RDF statements matching the given `pattern` and
+    # returns the value of the first found object literal.
+    #
+    # Returns `nil` if no statements match `pattern` or if none of the found
+    # statements have a literal as their object term.
+    #
+    # @overload first_value
+    #   @return [Object]
+    #
+    # @overload first_value(pattern)
+    #   @param  [Query, Statement, Array(Value), Hash] pattern
+    #   @return [Object]
+    #
+    # @return [Object]
+    # @since  0.1.19
+    def first_value(pattern = nil)
+      (literal = first_literal(pattern)) ? literal.value : nil
+    end
   end
 end

data/lib/rdf/model/graph.rb

@@ -1,6 +1,24 @@
 module RDF
   ##
   # An RDF graph.
+  #
+  # @example Creating an empty unnamed graph
+  #   graph = Graph.new
+  #
+  # @example Creating an empty named graph
+  #   graph = Graph.new("http://rubygems.org/")
+  #
+  # @example Loading graph data from a URL (1)
+  #   require 'rdf/raptor'  # for RDF/XML support
+  #   
+  #   graph = RDF::Graph.new("http://www.bbc.co.uk/programmes/b0081dq5.rdf")
+  #   graph.load!
+  #
+  # @example Loading graph data from a URL (2)
+  #   require 'rdf/raptor'  # for RDF/XML support
+  #   
+  #   graph = RDF::Graph.load("http://www.bbc.co.uk/programmes/b0081dq5.rdf")
+  #
   class Graph < Resource
     include RDF::Enumerable
     include RDF::Mutable
@@ -18,19 +36,12 @@ module RDF
     # Creates a new `Graph` instance populated by the RDF data returned by
     # dereferencing the given context URL.
     #
-    # @overload
-    #   @param  [String, #to_s]          url
-    #   @param  [Hash{Symbol => Object}] options
-    #   @yield  [graph]
-    #   @yieldparam [Graph] graph
-    #   @return [void]
-    #
-    # @overload
-    #   @param  [String, #to_s]          url
-    #   @param  [Hash{Symbol => Object}] options
-    #   @return [Graph]
-    #
-    # @return [void]
+    # @param  [String, #to_s]          url
+    # @param  [Hash{Symbol => Object}] options
+    # @yield  [graph]
+    # @yieldparam [Graph] graph
+    # @return [Graph]
+    # @since  0.1.17
     def self.load(url, options = {}, &block)
       self.new(url, options) do |graph|
         graph.load! unless graph.unnamed?

data/lib/rdf/model/value.rb

@@ -83,6 +83,7 @@ module RDF
     # Returns `true` if this value is a query variable.
     #
     # @return [Boolean]
+    # @since  0.1.17
     def variable?
       false
     end

data/lib/rdf/query/solution.rb

@@ -21,7 +21,8 @@ class RDF::Query
   #   solution.to_hash       #=> {:mbox => "jrhacker@example.org", ...}
   #
   class Solution
-    undef_method *(instance_methods - %w(__id__ __send__ __class__ __eval__ instance_eval inspect class object_id is_a?))
+    # Undefine all superfluous instance methods:
+    undef_method *(instance_methods.map { |s| s.to_sym } - [:__id__, :__send__, :__class__, :__eval__, :object_id, :instance_eval, :inspect, :class, :is_a?])
 
     include Enumerable
 

data/lib/rdf/query/variable.rb

@@ -59,6 +59,7 @@ class RDF::Query
     #
     # @return [Boolean]
     # @see    RDF::Value#variable?
+    # @since  0.1.17
     def variable? 
       true
     end

data/lib/rdf/version.rb

@@ -2,7 +2,7 @@ module RDF
   module VERSION
     MAJOR = 0
     MINOR = 1
-    TINY  = 8
+    TINY  = 9
     EXTRA = nil
 
     STRING = [MAJOR, MINOR, TINY].join('.')

data/lib/rdf/vocab.rb

@@ -117,7 +117,7 @@ module RDF
     end
 
     # Undefine all superfluous instance methods:
-    undef_method *(instance_methods - %w(__id__ __send__ __class__ __eval__ instance_eval inspect class))
+    undef_method *(instance_methods.map { |s| s.to_sym } - [:__id__, :__send__, :__class__, :__eval__, :object_id, :instance_eval, :inspect, :class, :is_a?])
 
     ##
     # @param  [URI, String, #to_s]

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 1
-  - 8
-  version: 0.1.8
+  - 9
+  version: 0.1.9
 platform: ruby
 authors: 
 - Arto Bendiken
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-04-18 00:00:00 +02:00
+date: 2010-04-21 00:00:00 +02:00
 default_executable: rdf
 dependencies: 
 - !ruby/object:Gem::Dependency