openlogic-rdf 0.3.6

data/lib/rdf/util/cache.rb

@@ -0,0 +1,139 @@
+module RDF; module Util
+  ##
+  # A `Hash`-like cache that holds only weak references to the values it
+  # caches, meaning that values contained in the cache can be garbage
+  # collected. This allows the cache to dynamically adjust to changing
+  # memory conditions, caching more objects when memory is plentiful, but
+  # evicting most objects if memory pressure increases to the point of
+  # scarcity.
+  #
+  # While this cache is something of an internal implementation detail of
+  # RDF.rb, some external libraries do currently make use of it as well,
+  # including [SPARQL::Algebra](http://sparql.rubyforge.org/algebra/) and
+  # [Spira](http://spira.rubyforge.org/). Do be sure to include any changes
+  # here in the RDF.rb changelog.
+  #
+  # @see   RDF::URI.intern
+  # @see   http://en.wikipedia.org/wiki/Weak_reference
+  # @since 0.2.0
+  class Cache
+    ##
+    # @private
+    def self.new(*args)
+      # JRuby doesn't support `ObjectSpace#_id2ref` unless the `-X+O`
+      # startup option is given.  In addition, ObjectSpaceCache is very slow
+      # on Rubinius.  On those platforms we'll default to using
+      # the WeakRef-based cache:
+      if RUBY_PLATFORM == 'java' || (defined?(RUBY_ENGINE) && RUBY_ENGINE == 'rbx')
+        klass = WeakRefCache
+      else
+        klass = ObjectSpaceCache
+      end
+      cache = klass.allocate
+      cache.send(:initialize, *args)
+      cache
+    end
+
+    ##
+    # @param  [Integer] capacity
+    def initialize(capacity = -1)
+      @capacity = capacity
+      @cache  ||= {}
+      @index  ||= {}
+    end
+
+    ##
+    # @return [Integer]
+    def size
+      @cache.size
+    end
+
+    ##
+    # @return [Boolean]
+    def has_capacity?
+      @capacity.equal?(-1) || @capacity > @cache.size
+    end
+
+    ##
+    # @param  [Object] value
+    # @return [void]
+    def define_finalizer!(value)
+      ObjectSpace.define_finalizer(value, finalizer)
+    end
+
+    ##
+    # @return [Proc]
+    def finalizer
+      lambda { |object_id| @cache.delete(@index.delete(object_id)) }
+    end
+
+    ##
+    # This implementation relies on `ObjectSpace#_id2ref` and performs
+    # optimally on Ruby 1.8.x and 1.9.x; however, it does not work on JRuby
+    # by default since much `ObjectSpace` functionality on that platform is
+    # disabled unless the `-X+O` startup option is given.
+    #
+    # @see http://ruby-doc.org/ruby-1.9/classes/ObjectSpace.html
+    # @see http://eigenclass.org/hiki/weakhash+and+weakref
+    class ObjectSpaceCache < Cache
+      ##
+      # @param  [Object] key
+      # @return [Object]
+      def [](key)
+        if value_id = @cache[key]
+          value = ObjectSpace._id2ref(value_id) rescue nil
+        end
+      end
+
+      ##
+      # @param  [Object] key
+      # @param  [Object] value
+      # @return [Object]
+      def []=(key, value)
+        if has_capacity?
+          @cache[key] = value.__id__
+          @index[value.__id__] = key
+          define_finalizer!(value)
+        end
+        value
+      end
+    end # ObjectSpaceCache
+
+    ##
+    # This implementation uses the `WeakRef` class from Ruby's standard
+    # library, and provides adequate performance on JRuby and on Ruby 1.9.x;
+    # however, it performs very suboptimally on Ruby 1.8.x.
+    #
+    # @see http://ruby-doc.org/ruby-1.9/classes/WeakRef.html
+    class WeakRefCache < Cache
+      ##
+      # @param  [Integer] capacity
+      def initialize(capacity = -1)
+        require 'weakref' unless defined?(::WeakRef)
+        super
+      end
+
+      ##
+      # @param  [Object] key
+      # @return [Object]
+      def [](key)
+        if (ref = @cache[key]) && ref.weakref_alive?
+          value = ref.__getobj__ rescue nil
+        end
+      end
+
+      ##
+      # @param  [Object] key
+      # @param  [Object] value
+      # @return [Object]
+      def []=(key, value)
+        if has_capacity?
+          @cache[key] = WeakRef.new(value)
+          @index[value.__id__] = key
+          define_finalizer!(value)
+        end
+        value
+      end
+    end # WeakRefCache
+  end # Cache
+end; end # RDF::Util

data/lib/rdf/util/file.rb

@@ -0,0 +1,38 @@
+module RDF; module Util
+  ##
+  # Wrapper for Kernel.open. Allows implementations to override to get
+  # more suffisticated behavior for HTTP resources (e.g., Accept header).
+  #
+  # Also supports the file: scheme for access to local files.
+  #
+  # Classes include this module when they represent some form of a file
+  # as a base resource, for instance an HTTP resource representing the
+  # serialization of a Graph.
+  #
+  # This module may be monkey-patched to allow for more options
+  # and interfaces.
+  #
+  # @since 0.2.4
+  module File
+    # Content
+    # @return [String] 
+    attr_accessor :content_type
+    
+    ##
+    # Open the file, returning or yielding an IO stream and mime_type.
+    #
+    # @param [String] filename_or_url to open
+    # @param  [Hash{Symbol => Object}] options
+    #   options are ignored in this implementation. Applications are encouraged
+    #   to override this implementation to provide more control over HTTP
+    #   headers and redirect following.
+    # @option options [Array, String] :headers
+    #   HTTP Request headers.
+    # @return [IO] File stream
+    # @yield [IO] File stream
+    def self.open_file(filename_or_url, options = {}, &block)
+      filename_or_url = $1 if filename_or_url.to_s.match(/^file:(.*)$/)
+      Kernel.open(filename_or_url.to_s, &block)
+    end
+  end # File
+end; end # RDF::Util

data/lib/rdf/util/uuid.rb

@@ -0,0 +1,36 @@
+module RDF; module Util
+  ##
+  # Utilities for UUID handling.
+  #
+  # @see http://en.wikipedia.org/wiki/Universally_unique_identifier
+  module UUID
+    ##
+    # Generates a UUID string.
+    #
+    # This will make use of either the [UUID][] gem or the [UUIDTools][]
+    # gem, whichever of the two happens to be available.
+    #
+    # [UUID]:      http://rubygems.org/gems/uuid
+    # [UUIDTools]: http://rubygems.org/gems/uuidtools
+    #
+    # @param  [Hash{Symbol => Object}] options
+    #   any options to pass through to the underlying UUID library
+    # @return [String] a UUID string
+    # @raise  [LoadError] if no UUID library is available
+    # @see    http://rubygems.org/gems/uuid
+    # @see    http://rubygems.org/gems/uuidtools
+    def self.generate(options = {})
+      begin
+        require 'uuid'
+        ::UUID.generate(options[:format] || :default)
+      rescue LoadError => e
+        begin
+          require 'uuidtools'
+          ::UUIDTools::UUID.random_create.hexdigest
+        rescue LoadError => e
+          raise LoadError.new("no such file to load -- uuid or uuidtools")
+        end
+      end
+    end
+  end # UUID
+end; end # RDF::Util

data/lib/rdf/util.rb

@@ -0,0 +1,6 @@
+module RDF; module Util
+  autoload :Aliasing, 'rdf/util/aliasing'
+  autoload :Cache,    'rdf/util/cache'
+  autoload :File,     'rdf/util/file'
+  autoload :UUID,     'rdf/util/uuid'
+end; end

data/lib/rdf/version.rb

@@ -0,0 +1,19 @@
+module RDF
+  module VERSION
+    VERSION_FILE = File.expand_path("../../../VERSION", __FILE__)
+    MAJOR, MINOR, TINY, EXTRA = File.read(VERSION_FILE).chop.split(".")
+    STRING = [MAJOR, MINOR, TINY, EXTRA].compact.join('.')
+
+    ##
+    # @return [String]
+    def self.to_s() STRING end
+
+    ##
+    # @return [String]
+    def self.to_str() STRING end
+
+    ##
+    # @return [Array(Integer, Integer, Integer)]
+    def self.to_a() [MAJOR, MINOR, TINY] end
+  end
+end

data/lib/rdf/vocab/cc.rb

@@ -0,0 +1,18 @@
+module RDF
+  ##
+  # Creative Commons (CC) vocabulary.
+  #
+  # @see http://creativecommons.org/ns
+  class CC < Vocabulary("http://creativecommons.org/ns#")
+    property :attributionName
+    property :attributionURL
+    property :deprecatedOn
+    property :jurisdiction
+    property :legalcode
+    property :license
+    property :morePermissions
+    property :permits
+    property :prohibits
+    property :requires
+  end
+end

data/lib/rdf/vocab/cert.rb

@@ -0,0 +1,13 @@
+module RDF
+  ##
+  # W3 Authentication Certificates (CERT) vocabulary.
+  #
+  # @see   http://www.w3.org/ns/auth/cert#
+  # @since 0.2.0
+  class CERT < Vocabulary("http://www.w3.org/ns/auth/cert#")
+    property :decimal
+    property :hex
+    property :identity
+    property :public_key
+  end
+end

data/lib/rdf/vocab/dc.rb

@@ -0,0 +1,63 @@
+module RDF
+  ##
+  # Dublin Core (DC) vocabulary.
+  #
+  # @see http://dublincore.org/schemas/rdfs/
+  class DC < Vocabulary("http://purl.org/dc/terms/")
+    property :abstract
+    property :accessRights
+    property :accrualMethod
+    property :accrualPeriodicity
+    property :accrualPolicy
+    property :alternative
+    property :audience
+    property :available
+    property :bibliographicCitation
+    property :conformsTo
+    property :contributor
+    property :coverage
+    property :created
+    property :creator
+    property :date
+    property :dateAccepted
+    property :dateCopyrighted
+    property :dateSubmitted
+    property :description
+    property :educationLevel
+    property :extent
+    property :format
+    property :hasFormat
+    property :hasPart
+    property :hasVersion
+    property :identifier
+    property :instructionalMethod
+    property :isFormatOf
+    property :isPartOf
+    property :isReferencedBy
+    property :isReplacedBy
+    property :isRequiredBy
+    property :isVersionOf
+    property :issued
+    property :language
+    property :license
+    property :mediator
+    property :medium
+    property :modified
+    property :provenance
+    property :publisher
+    property :references
+    property :relation
+    property :replaces
+    property :requires
+    property :rights
+    property :rightsHolder
+    property :source
+    property :spatial
+    property :subject
+    property :tableOfContents
+    property :temporal
+    property :title
+    property :type
+    property :valid
+  end
+end

data/lib/rdf/vocab/dc11.rb

@@ -0,0 +1,23 @@
+module RDF
+  ##
+  # Dublin Core (DC) legacy vocabulary.
+  #
+  # @see http://dublincore.org/schemas/rdfs/
+  class DC11 < Vocabulary("http://purl.org/dc/elements/1.1/")
+    property :contributor
+    property :coverage
+    property :creator
+    property :date
+    property :description
+    property :format
+    property :identifier
+    property :language
+    property :publisher
+    property :relation
+    property :rights
+    property :source
+    property :subject
+    property :title
+    property :type
+  end
+end

data/lib/rdf/vocab/doap.rb

@@ -0,0 +1,45 @@
+module RDF
+  ##
+  # Description of a Project (DOAP) vocabulary.
+  #
+  # @see http://trac.usefulinc.com/doap
+  class DOAP < Vocabulary("http://usefulinc.com/ns/doap#")
+    property :'anon-root'
+    property :audience
+    property :blog
+    property :browse
+    property :'bug-database'
+    property :category
+    property :created
+    property :description
+    property :developer
+    property :documenter
+    property :'download-mirror'
+    property :'download-page'
+    property :'file-release'
+    property :helper
+    property :homepage
+    property :implements
+    property :language
+    property :license
+    property :location
+    property :'mailing-list'
+    property :maintainer
+    property :module
+    property :name
+    property :'old-homepage'
+    property :os
+    property :platform
+    property :'programming-language'
+    property :release
+    property :repository
+    property :revision
+    property :screenshots
+    property :'service-endpoint'
+    property :shortdesc
+    property :tester
+    property :translator
+    property :vendor
+    property :wiki
+  end
+end

data/lib/rdf/vocab/exif.rb

@@ -0,0 +1,168 @@
+module RDF
+  ##
+  # Exchangeable Image File Format (EXIF) vocabulary.
+  #
+  # @see http://www.w3.org/2003/12/exif/
+  class EXIF < Vocabulary("http://www.w3.org/2003/12/exif/ns#")
+    property :_unknown
+    property :apertureValue
+    property :artist
+    property :bitsPerSample
+    property :brightnessValue
+    property :cfaPattern
+    property :colorSpace
+    property :componentsConfiguration
+    property :compressedBitsPerPixel
+    property :compression
+    property :contrast
+    property :copyright
+    property :customRendered
+    property :datatype
+    property :date
+    property :dateAndOrTime
+    property :dateTime
+    property :dateTimeDigitized
+    property :dateTimeOriginal
+    property :deviceSettingDescription
+    property :digitalZoomRatio
+    property :exifAttribute
+    property :exifVersion
+    property :exif_IFD_Pointer
+    property :exifdata
+    property :exposureBiasValue
+    property :exposureIndex
+    property :exposureMode
+    property :exposureProgram
+    property :exposureTime
+    property :fNumber
+    property :fileSource
+    property :flash
+    property :flashEnergy
+    property :flashpixVersion
+    property :focalLength
+    property :focalLengthIn35mmFilm
+    property :focalPlaneResolutionUnit
+    property :focalPlaneXResolution
+    property :focalPlaneYResolution
+    property :gainControl
+    property :geo
+    property :gpsAltitude
+    property :gpsAltitudeRef
+    property :gpsAreaInformation
+    property :gpsDOP
+    property :gpsDateStamp
+    property :gpsDestBearing
+    property :gpsDestBearingRef
+    property :gpsDestDistance
+    property :gpsDestDistanceRef
+    property :gpsDestLatitude
+    property :gpsDestLatitudeRef
+    property :gpsDestLongitude
+    property :gpsDestLongitudeRef
+    property :gpsDifferential
+    property :gpsImgDirection
+    property :gpsImgDirectionRef
+    property :gpsInfo
+    property :gpsInfo_IFD_Pointer
+    property :gpsLatitude
+    property :gpsLatitudeRef
+    property :gpsLongitude
+    property :gpsLongitudeRef
+    property :gpsMapDatum
+    property :gpsMeasureMode
+    property :gpsProcessingMethod
+    property :gpsSatellites
+    property :gpsSpeed
+    property :gpsSpeedRef
+    property :gpsStatus
+    property :gpsTimeStamp
+    property :gpsTrack
+    property :gpsTrackRef
+    property :gpsVersionID
+    property :height
+    property :ifdPointer
+    property :imageConfig
+    property :imageDataCharacter
+    property :imageDataStruct
+    property :imageDescription
+    property :imageLength
+    property :imageUniqueID
+    property :imageWidth
+    property :interopInfo
+    property :interoperabilityIndex
+    property :interoperabilityVersion
+    property :interoperability_IFD_Pointer
+    property :isoSpeedRatings
+    property :jpegInterchangeFormat
+    property :jpegInterchangeFormatLength
+    property :length
+    property :lightSource
+    property :make
+    property :makerNote
+    property :maxApertureValue
+    property :meter
+    property :meteringMode
+    property :mm
+    property :model
+    property :oecf
+    property :orientation
+    property :photometricInterpretation
+    property :pictTaking
+    property :pimBrightness
+    property :pimColorBalance
+    property :pimContrast
+    property :pimInfo
+    property :pimSaturation
+    property :pimSharpness
+    property :pixelXDimension
+    property :pixelYDimension
+    property :planarConfiguration
+    property :primaryChromaticities
+    property :printImageMatching_IFD_Pointer
+    property :recOffset
+    property :referenceBlackWhite
+    property :relatedFile
+    property :relatedImageFileFormat
+    property :relatedImageLength
+    property :relatedImageWidth
+    property :relatedSoundFile
+    property :resolution
+    property :resolutionUnit
+    property :rowsPerStrip
+    property :samplesPerPixel
+    property :saturation
+    property :sceneCaptureType
+    property :sceneType
+    property :seconds
+    property :sensingMethod
+    property :sharpness
+    property :shutterSpeedValue
+    property :software
+    property :spatialFrequencyResponse
+    property :spectralSensitivity
+    property :stripByteCounts
+    property :stripOffsets
+    property :subSecTime
+    property :subSecTimeDigitized
+    property :subSecTimeOriginal
+    property :subjectArea
+    property :subjectDistance
+    property :subjectDistanceRange
+    property :subjectLocation
+    property :subseconds
+    property :tag_number
+    property :tagid
+    property :transferFunction
+    property :userComment
+    property :userInfo
+    property :versionInfo
+    property :whiteBalance
+    property :whitePoint
+    property :width
+    property :xResolution
+    property :yCbCrCoefficients
+    property :yCbCrPositioning
+    property :yCbCrSubSampling
+    property :yResolution
+  end
+end

data/lib/rdf/vocab/foaf.rb

@@ -0,0 +1,69 @@
+module RDF
+  ##
+  # Friend of a Friend (FOAF) vocabulary.
+  #
+  # @see http://xmlns.com/foaf/spec/
+  class FOAF < Vocabulary("http://xmlns.com/foaf/0.1/")
+    property :account
+    property :accountName
+    property :accountServiceHomepage
+    property :age
+    property :aimChatID
+    property :based_near
+    property :birthday
+    property :currentProject
+    property :depiction
+    property :depicts
+    property :dnaChecksum
+    property :familyName
+    property :family_name
+    property :firstName
+    property :fundedBy
+    property :geekcode
+    property :gender
+    property :givenName
+    property :givenname
+    property :holdsAccount
+    property :homepage
+    property :icqChatID
+    property :img
+    property :interest
+    property :isPrimaryTopicOf
+    property :jabberID
+    property :knows
+    property :lastName
+    property :logo
+    property :made
+    property :maker
+    property :mbox
+    property :mbox_sha1sum
+    property :member
+    property :membershipClass
+    property :msnChatID
+    property :myersBriggs
+    property :name
+    property :nick
+    property :openid
+    property :page
+    property :pastProject
+    property :phone
+    property :plan
+    property :primaryTopic
+    property :publications
+    property :schoolHomepage
+    property :sha1
+    property :skypeID
+    property :status
+    property :surname
+    property :theme
+    property :thumbnail
+    property :tipjar
+    property :title
+    property :topic
+    property :topic_interest
+    property :weblog
+    property :workInfoHomepage
+    property :workplaceHomepage
+    property :yahooChatID
+  end
+end

data/lib/rdf/vocab/geo.rb

@@ -0,0 +1,13 @@
+module RDF
+  ##
+  # WGS84 Geo Positioning (GEO) vocabulary.
+  #
+  # @see   http://www.w3.org/2003/01/geo/wgs84_pos#
+  # @since 0.2.0
+  class GEO < Vocabulary("http://www.w3.org/2003/01/geo/wgs84_pos#")
+    property :lat
+    property :location
+    property :long
+    property :lat_long
+  end
+end

data/lib/rdf/vocab/http.rb

@@ -0,0 +1,26 @@
+module RDF
+  ##
+  # Hypertext Transfer Protocol (HTTP) vocabulary.
+  #
+  # @see http://www.w3.org/2006/http
+  class HTTP < Vocabulary("http://www.w3.org/2006/http#")
+    property :abs_path
+    property :absoluteURI
+    property :authority
+    property :body
+    property :connectionAuthority
+    property :elementName
+    property :elementValue
+    property :fieldName
+    property :fieldValue
+    property :header
+    property :param
+    property :paramName
+    property :paramValue
+    property :request
+    property :requestURI
+    property :response
+    property :responseCode
+    property :version
+  end
+end