factoid 0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 9e01d537e7fcee79c2f5f1d17096672fda9c17ff
+  data.tar.gz: ccbf896597df8d4ee9c2adf618fcefec774f970f
+SHA512:
+  metadata.gz: 97325418c38331595952ce5d20ba685951f97af709ed528ded4ceb7751e16d92bbff607d9905a316f990c17e6918058eafe8a6fac40265b5686aff2290528f67
+  data.tar.gz: c00e48f039b7d5e507f3335078d493206874f8a8bfc7d4500342fe10f9ad6ae4a0b94e930c3d166515602c2f7833b4d989b5cf2121f6efbbf1728608f3a2b383

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/COPYING

@@ -0,0 +1,121 @@
+Creative Commons Legal Code
+
+CC0 1.0 Universal
+
+    CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE
+    LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN
+    ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS
+    INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES
+    REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS
+    PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM
+    THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED
+    HEREUNDER.
+
+Statement of Purpose
+
+The laws of most jurisdictions throughout the world automatically confer
+exclusive Copyright and Related Rights (defined below) upon the creator
+and subsequent owner(s) (each and all, an "owner") of an original work of
+authorship and/or a database (each, a "Work").
+
+Certain owners wish to permanently relinquish those rights to a Work for
+the purpose of contributing to a commons of creative, cultural and
+scientific works ("Commons") that the public can reliably and without fear
+of later claims of infringement build upon, modify, incorporate in other
+works, reuse and redistribute as freely as possible in any form whatsoever
+and for any purposes, including without limitation commercial purposes.
+These owners may contribute to the Commons to promote the ideal of a free
+culture and the further production of creative, cultural and scientific
+works, or to gain reputation or greater distribution for their Work in
+part through the use and efforts of others.
+
+For these and/or other purposes and motivations, and without any
+expectation of additional consideration or compensation, the person
+associating CC0 with a Work (the "Affirmer"), to the extent that he or she
+is an owner of Copyright and Related Rights in the Work, voluntarily
+elects to apply CC0 to the Work and publicly distribute the Work under its
+terms, with knowledge of his or her Copyright and Related Rights in the
+Work and the meaning and intended legal effect of CC0 on those rights.
+
+1. Copyright and Related Rights. A Work made available under CC0 may be
+protected by copyright and related or neighboring rights ("Copyright and
+Related Rights"). Copyright and Related Rights include, but are not
+limited to, the following:
+
+  i. the right to reproduce, adapt, distribute, perform, display,
+     communicate, and translate a Work;
+ ii. moral rights retained by the original author(s) and/or performer(s);
+iii. publicity and privacy rights pertaining to a person's image or
+     likeness depicted in a Work;
+ iv. rights protecting against unfair competition in regards to a Work,
+     subject to the limitations in paragraph 4(a), below;
+  v. rights protecting the extraction, dissemination, use and reuse of data
+     in a Work;
+ vi. database rights (such as those arising under Directive 96/9/EC of the
+     European Parliament and of the Council of 11 March 1996 on the legal
+     protection of databases, and under any national implementation
+     thereof, including any amended or successor version of such
+     directive); and
+vii. other similar, equivalent or corresponding rights throughout the
+     world based on applicable law or treaty, and any national
+     implementations thereof.
+
+2. Waiver. To the greatest extent permitted by, but not in contravention
+of, applicable law, Affirmer hereby overtly, fully, permanently,
+irrevocably and unconditionally waives, abandons, and surrenders all of
+Affirmer's Copyright and Related Rights and associated claims and causes
+of action, whether now known or unknown (including existing as well as
+future claims and causes of action), in the Work (i) in all territories
+worldwide, (ii) for the maximum duration provided by applicable law or
+treaty (including future time extensions), (iii) in any current or future
+medium and for any number of copies, and (iv) for any purpose whatsoever,
+including without limitation commercial, advertising or promotional
+purposes (the "Waiver"). Affirmer makes the Waiver for the benefit of each
+member of the public at large and to the detriment of Affirmer's heirs and
+successors, fully intending that such Waiver shall not be subject to
+revocation, rescission, cancellation, termination, or any other legal or
+equitable action to disrupt the quiet enjoyment of the Work by the public
+as contemplated by Affirmer's express Statement of Purpose.
+
+3. Public License Fallback. Should any part of the Waiver for any reason
+be judged legally invalid or ineffective under applicable law, then the
+Waiver shall be preserved to the maximum extent permitted taking into
+account Affirmer's express Statement of Purpose. In addition, to the
+extent the Waiver is so judged Affirmer hereby grants to each affected
+person a royalty-free, non transferable, non sublicensable, non exclusive,
+irrevocable and unconditional license to exercise Affirmer's Copyright and
+Related Rights in the Work (i) in all territories worldwide, (ii) for the
+maximum duration provided by applicable law or treaty (including future
+time extensions), (iii) in any current or future medium and for any number
+of copies, and (iv) for any purpose whatsoever, including without
+limitation commercial, advertising or promotional purposes (the
+"License"). The License shall be deemed effective as of the date CC0 was
+applied by Affirmer to the Work. Should any part of the License for any
+reason be judged legally invalid or ineffective under applicable law, such
+partial invalidity or ineffectiveness shall not invalidate the remainder
+of the License, and in such case Affirmer hereby affirms that he or she
+will not (i) exercise any of his or her remaining Copyright and Related
+Rights in the Work or (ii) assert any associated claims and causes of
+action with respect to the Work, in either case contrary to Affirmer's
+express Statement of Purpose.
+
+4. Limitations and Disclaimers.
+
+ a. No trademark or patent rights held by Affirmer are waived, abandoned,
+    surrendered, licensed or otherwise affected by this document.
+ b. Affirmer offers the Work as-is and makes no representations or
+    warranties of any kind concerning the Work, express, implied,
+    statutory or otherwise, including without limitation warranties of
+    title, merchantability, fitness for a particular purpose, non
+    infringement, or the absence of latent or other defects, accuracy, or
+    the present or absence of errors, whether or not discoverable, all to
+    the greatest extent permissible under applicable law.
+ c. Affirmer disclaims responsibility for clearing rights of other persons
+    that may apply to the Work or any use thereof, including without
+    limitation any person's Copyright and Related Rights in the Work.
+    Further, Affirmer disclaims responsibility for obtaining any necessary
+    consents, permissions or other rights required for any use of the
+    Work.
+ d. Affirmer understands and acknowledges that Creative Commons is not a
+    party to this document and has no duty or obligation with respect to
+    this CC0 or use of the Work.

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in factoid.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Gioele Barabucci
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,116 @@
+factoid: read, manipulate and save factoids
+===========================================
+
+`factoid` is a Ruby library to manipulate _factoids_ and _entitoids_
+inside Ruby applications without touching the their XML representations.
+
+
+What is a factoid?
+------------------
+
+Factoids and Entitoids are representations of pieces of information
+about a certain entity. These representations not only store the
+information itself, but also keep track of provenance (who stated
+something, where, when) and context (under which assumption is a
+certain piece of information valid?). Using factoids one can store
+and manage different values for the same property of an entity.
+
+For example, instead of just storing that
+
+> composer with ID 14 has property 'name' = 'Frédéric Chopin'
+
+using factoids one can say
+
+> there is a composer with ID 14
+
+> Wikipedia says that composer#14 has
+> * a property 'name',
+> * with context 'language' = 'fra',
+> * and value 'Frédéric Chopin'.
+
+> Book with ISBN 9780007351824 says that composer#14 has
+> * a property 'name',
+> * with context 'language' = 'pol',
+> * and value 'Fryderyk Chopin'.
+
+The name of composer 14 is then both _Frédéric Chopin_ and _Fryderyk
+Chopin_ depending on the context.
+
+Factoids and entitoids are described more in depth at
+<http://svario.it/factoid>.
+
+The `factoid` gem makes it possible to load and save factoids, to search
+and select factoids that match certain patterns and to access complex
+information in a simple way.
+
+
+Examples
+--------
+
+    c14 = Factoid::Entitoid.from_xml('composer14.xml')
+
+    puts "Known names:"
+    puts
+    c.factoids('name').each do |fact|
+    	puts " #{fact.value} in #{fact.context['language']}"
+	puts "   (from #{fact.sources})"
+	puts
+    end
+
+    # Known names:
+    #
+    #  Frédéric Chopin in fra
+    #    (from http://en.wikipedia.org/wiki/Frédéric_Chopin)
+    #  Fryderyk Chopin in pol
+    #    (from urn:isbn:9780007351824)
+
+
+Requirements
+------------
+
+factoid is based on Nokogiri and uses Addressable to manage URIs.
+
+
+Install
+-------
+
+Install the factoid gem using RubyGems
+
+    gem install factoid
+
+or Bundler
+
+    # in Gemfile
+    gem 'factoid'
+
+To use the factoid gem in your project, load it with
+
+    require 'factoid'
+
+
+Author
+------
+
+* Gioele Barabucci <http://svario.it/gioele> (initial author)
+
+
+Development
+-----------
+
+Code
+: <http://svario.it/factoid/ruby> (redirects to GitHub)
+
+Report issues
+: <http://svario.it/factoid/ruby/issues>
+
+Documentation
+: <http://svario.it/factoid/ruby/docs>
+
+
+License
+-------
+
+This is free software released into the public domain (CC0 license).
+
+See the `COPYING` file or <http://creativecommons.org/publicdomain/zero/1.0/>
+for more details.

data/Rakefile

@@ -0,0 +1,6 @@
+require 'bundler/gem_tasks'
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/factoid.gemspec

@@ -0,0 +1,31 @@
+# This is free software released into the public domain (CC0 license).
+
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'factoid/version'
+
+Gem::Specification.new do |spec|
+	spec.name          = "factoid"
+	spec.version       = Factoid::VERSION
+	spec.authors       = ["Gioele Barabucci"]
+	spec.email         = ["gioele@svario.it"]
+	spec.summary       = "factoid is a Ruby library to manipulate factoids " +
+	                     "entitoids inside Ruby applications without " +
+	                     "touching the their XML representations."
+	spec.homepage      = 'http://svario.it/factoid/ruby'
+	spec.license       = 'CC0'
+
+	spec.files         = `git ls-files`.split($/)
+	spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+	spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+	spec.require_paths = ['lib']
+
+	spec.add_dependency 'nokogiri'
+	spec.add_dependency 'addressable'
+
+	spec.add_development_dependency 'bundler', '~> 1.3'
+	spec.add_development_dependency 'rake'
+	spec.add_development_dependency 'rspec'
+end

data/lib/factoid.rb

@@ -0,0 +1,4 @@
+# This is free software released into the public domain (CC0 license).
+
+require 'factoid/entitoid'
+require 'factoid/factoid'

data/lib/factoid/entitoid.rb

@@ -0,0 +1,55 @@
+# This is free software released into the public domain (CC0 license).
+
+
+module Factoid
+	class Entitoid
+		def initialize(uuid)
+			@uuid = uuid
+			@factoids = []
+		end
+
+		attr_reader :uuid
+
+		def add_factoid(factoid)
+			@factoids << factoid
+		end
+
+		def factoids(name, context = {})
+			if name == :all
+				return @factoids
+			end
+
+			matching = @factoids.select { |f| f.match?(name, context) }
+			return matching
+		end
+
+		def value(name, context = {})
+			f = factoids(name, context)
+
+			if f.empty?
+				raise "Cannot return value, no factoid matches name: '#{name}', context: #{context}"
+			end
+
+			if f.count > 1
+				raise "Cannot return value, too many factoids match name: '#{name}', context: #{context}"
+			end
+
+			return f.first.value
+		end
+
+		def eql?(other)
+			if other.equal?(self)
+				return true
+			end
+
+			if other.class != self.class
+				return false
+			end
+
+			f = factoids(:all)
+			other_f = other.factoids(:all)
+
+			return f.eql?(other_f)
+		end
+	end
+end

data/lib/factoid/entitoid_ref.rb

@@ -0,0 +1,33 @@
+# This is free software released into the public domain (CC0 license).
+
+
+require 'addressable/uri'
+
+require 'factoid/entitoid'
+
+module Factoid
+	class EntitoidRef
+		def initialize(uri, base)
+			@uri = Addressable::URI.parse(uri)
+			@base = base
+		end
+
+		attr_reader :uri
+
+		def full_uri
+			return Addressable::URI.join(@base, @uri)
+		end
+
+		def deref
+			return Entitoid.from_xml(full_uri)
+		end
+
+		def eql?(other)
+			if other.class != self.class
+				return false
+			end
+
+			return other.full_uri == self.full_uri
+		end
+	end
+end

data/lib/factoid/factoid.rb

@@ -0,0 +1,57 @@
+# This is free software released into the public domain (CC0 license).
+
+
+module Factoid
+	class Factoid
+		def initialize(type, context, value_obj, sources, context_sources)
+			@type = type
+			@context = context
+			@value_obj = value_obj
+
+			@sources = sources
+			@context_sources = context_sources
+		end
+
+		attr_reader :type
+		attr_reader :value_obj
+		attr_reader :context
+
+		def sources
+			if !@sources.empty?
+				return @sources
+			end
+
+			uris = @context_sources.select { |s| s.default? }
+
+			return uris
+		end
+
+		def match?(type, context)
+			if @type != type # FIXME: check type hierarchy
+				return false
+			end
+
+			return context.to_a.all? { |k, v| @context[k.to_s] == v }
+		end
+
+		def value(interpret = true, follow = false)
+			return @value_obj.value(interpret, follow)
+		end
+
+		def eql?(other)
+			if other.equal?(self)
+				return true
+			end
+
+			if other.class != self.class
+				return false
+			end
+
+			same = other.type == self.type &&
+			       other.value.eql?(self.value) &&
+			       other.sources == self.sources
+
+			return same
+		end
+	end
+end

data/lib/factoid/source.rb

@@ -0,0 +1,50 @@
+# This is free software released into the public domain (CC0 license).
+
+
+require 'addressable/uri'
+
+module Factoid
+	class Source
+		def initialize(uuid, uri, default, value)
+			@uuid = uuid
+			@uri = Addressable::URI.parse(uri)
+			@default = default
+			@value = value
+		end
+
+		attr_reader :uuid
+		attr_reader :uri
+		attr_reader :value
+
+		def default?
+			return @default
+		end
+
+		def ref?
+			# FIXME: separate SourceRef class
+			return !@uri.nil?
+		end
+
+		def ==(other)
+			if other.equal?(self)
+				return true
+			end
+
+			if other.is_a?(Source)
+				if other.ref?
+					return other.uri == self.uri
+				else
+					return other.value == self.value
+				end
+			end
+
+			if ref?
+				return Addressable::URI.parse(other) == @uri
+			else
+				return other == @value.to_s
+			end
+		end
+
+		# FIXME: move part of == to eql?; add tests
+	end
+end

data/lib/factoid/value.rb

@@ -0,0 +1,85 @@
+# This is free software released into the public domain (CC0 license).
+
+
+module Factoid
+	class Value
+		def initialize(type, raw_value)
+			@type = type
+			@raw_value = raw_value
+		end
+
+		EMPTY = Value.new(nil, nil).freeze
+
+		def value(interpret, follow)
+			raw = nil
+
+			if @raw_value.elements.empty?
+				raw = @raw_value.text
+			else
+				raw = @raw_value
+			end
+
+			if !interpret
+				return raw
+			end
+
+			interpreter = Interpreters.find { |i| begin i.accept?(@type, raw); rescue; end; }
+			v = interpreter.interpret(@type, raw)
+
+			if !follow
+				return v
+			end
+
+			# FIXME: use Dereferenciators (like Interpreters)
+			if v.is_a? EntitoidRef
+				r = v.deref
+			else
+				r = v
+			end
+
+			return r
+		end
+
+		class XSDDateInterpreter
+			def self.accept?(type, value)
+				return type == 'xsd:date'
+			end
+
+			def self.interpret(type, value)
+				require 'time'
+				return Time.parse(value)
+			end
+		end
+
+		class EntitoidInterpreter
+			def self.accept?(type, value)
+				return !value.xpath('./f:*', NS).empty?
+			end
+
+			def self.interpret(type, value)
+				require 'factoid/xml'
+
+				# FIXME: allow also complete entitoids
+
+				elem = value.at('./f:*', NS)
+				return EntitoidRef.from_xml(elem)
+			end
+		end
+
+		class IndentityInterpreter
+			def self.accept?(type, value)
+				return true
+			end
+
+			def self.interpret(type, value)
+				return value
+			end
+		end
+
+		Interpreters = [
+			XSDDateInterpreter,
+			EntitoidInterpreter,
+			IndentityInterpreter,
+		]
+	end
+end

data/lib/factoid/version.rb

@@ -0,0 +1,6 @@
+# This is free software released into the public domain (CC0 license).
+
+
+module Factoid
+	VERSION = '0.1'
+end

data/lib/factoid/xml.rb

@@ -0,0 +1,91 @@
+# This is free software released into the public domain (CC0 license).
+
+
+require 'nokogiri'
+
+require 'factoid/entitoid'
+require 'factoid/entitoid_ref'
+require 'factoid/factoid'
+require 'factoid/source'
+require 'factoid/value'
+
+module Factoid
+	FACTOID_NS_URI = 'http://svario.it/factoid'
+
+	NS = {
+		'f' => FACTOID_NS_URI,
+		'xlink' => 'http://www.w3.org/1999/xlink',
+		'xsd' => 'http://www.w3.org/2001/XMLSchema-datatypes',
+	}
+
+	def Entitoid.from_xml(filename)
+		x = Nokogiri::XML(open(filename))
+
+		uuid = x.root.attr('xml:id')
+		e = self.new(uuid)
+
+		context_sources = []
+		x.xpath('/*/f:sources/f:source').each do |s|
+			context_sources << Source.from_xml(s)
+		end
+
+		x.xpath('/*/f:*', NS).each do |f|
+			if f.name == 'sources'
+				next
+			end
+
+			e.add_factoid(Factoid.from_xml(f, context_sources))
+		end
+
+		return e
+	end
+
+	def EntitoidRef.from_xml(elem)
+		href = elem.attr('xlink:href')
+		base = elem.document.url
+
+		return EntitoidRef.new(href, base)
+	end
+
+	def Factoid.from_xml(elem, context_sources)
+		type = elem.name unless elem.name == 'factoid'
+		type ||= elem.attr('type')
+
+		context = {}
+		elem.xpath('./*[name(.) != "value"]').each do |e|
+			context[e.name] = e.text
+		end
+
+		value = Value.from_xml(elem)
+
+		raw_sources = elem.xpath('f:source', NS)
+		sources = raw_sources.map do |e|
+			Source.from_xml(e)
+		end
+
+		return Factoid.new(type, context, value, sources, context_sources)
+	end
+
+	def Source.from_xml(elem)
+		uuid = elem.attr('xml:id')
+
+		uri = elem.attr('xlink:href')
+
+		default = (elem.attr('default') == 'true')
+
+		#value = Value.from_xml(elem)
+		value = Value::EMPTY
+
+		return Source.new(uuid, uri, default, value)
+	end
+
+	def Value.from_xml(container_elem)
+		elem = container_elem.at('./f:value', NS)
+
+		type = elem.attr('type')
+		# TODO: special case for entitoids
+		# TODO: use type = :entitoid_ref instead of nil
+
+		return Value.new(type, elem)
+	end
+end

data/spec/factoid/entitoid_spec.rb

@@ -0,0 +1,56 @@
+# This is free software released into the public domain (CC0 license).
+
+
+require 'spec_helpers'
+
+require 'factoid/entitoid'
+require 'factoid/xml'
+
+describe Factoid::Entitoid do
+	before(:all) do
+		@e = Factoid::Entitoid.from_xml('spec/fixtures/chopin.xml')
+	end
+
+	it "can be loaded from XML" do
+		expect(@e).to be_a Factoid::Entitoid
+		expect(@e.uuid).to eql "chopin-23"
+	end
+
+	describe "#factoids" do
+		it "returns all the factoids" do
+			expect(@e.factoids(:all)).to have(8).items
+		end
+
+		it "returns all the factoids of type 'name'" do
+			expect(@e.factoids('name')).to have(4).items
+		end
+
+		it "returns all the factoids of type 'name' with a certain context" do
+			expect(@e.factoids('name', :language => 'fra')).to have(2).items
+		end
+	end
+
+	describe "#value" do
+		it "raises an exception if the request is ambiguous" do
+			expect { @e.value('birth-date') }.to raise_error
+		end
+
+		it "raises an exception if no factoid exists" do
+			expect { @e.value('unk-property') }.to raise_error
+		end
+	end
+
+	describe "#source" do
+		it "returns the stated source" do
+			f = @e.factoids('birth-date').first
+
+			expect(f.sources).to eq ["#bcert"]
+		end
+
+		it "returns the default source" do
+			f = @e.factoids('birth-date').last
+
+			expect(f.sources).to eq ["http://en.wikipedia.org/wiki/Frédéric_Chopin"]
+		end
+	end
+end

data/spec/factoid/factoid_spec.rb

@@ -0,0 +1,66 @@
+# This is free software released into the public domain (CC0 license).
+
+
+require 'spec_helpers'
+
+require 'nokogiri'
+
+require 'factoid/entitoid'
+require 'factoid/entitoid_ref'
+require 'factoid/factoid'
+require 'factoid/xml'
+
+describe Factoid::Factoid do
+	before (:all) do
+		e = Factoid::Entitoid.from_xml('spec/fixtures/chopin.xml')
+		@name = e.factoids('name', 'language' => 'fra').first
+		@death_date = e.factoids('death-date').first
+		@birth_place = e.factoids('birth-place').first
+	end
+
+	describe "#value" do
+		context "with no arguments" do
+			it "returns a string" do
+				expect(@name.value).to eql "Frédéric Chopin"
+			end
+
+			it "returns a date" do
+				expect(@death_date.value).to eql Time.mktime(1849, 10, 17)
+			end
+
+			it "returns an entitoid ref" do
+				place_ref = Factoid::EntitoidRef.new('zelazowa-wola', 'spec/fixtures/chopin.xml')
+				expect(@birth_place.value).to eql place_ref
+			end
+		end
+
+		context "with no interpretation" do
+			it "returns a string" do
+				expect(@name.value(false)).to eql "Frédéric Chopin"
+			end
+
+			it "returns a string also for dates" do
+				expect(@death_date.value(false)).to eql "1849-10-17"
+			end
+
+			it "returns an XML element" do
+				expect(@birth_place.value(false)).to be_a Nokogiri::XML::Node
+			end
+		end
+
+		context "with follows" do
+			it "returns a string" do
+				expect(@name.value(true, true)).to eql "Frédéric Chopin"
+			end
+
+			it "returns a string also for dates" do
+				expect(@death_date.value(true, true)).to eql Time.mktime(1849, 10, 17)
+			end
+
+			it "returns an entitoid" do
+				zelazowa_wola = Factoid::Entitoid.from_xml('spec/fixtures/zelazowa-wola.xml')
+				expect(@birth_place.value(true, true)).to eql zelazowa_wola
+			end
+		end
+	end
+end

data/spec/fixtures/chopin.xml

@@ -0,0 +1,49 @@
+<f:entity type="composer" xml:id="chopin-23" xmlns:f='http://svario.it/factoid'
+	xmlns:xlink="http://www.w3.org/1999/xlink"
+	xmlns:xsd="http://www.w3.org/2001/XMLSchema-datatypes">
+	<f:sources>
+		<f:source xml:id="wp" xlink:href="http://en.wikipedia.org/wiki/Fr%C3%A9d%C3%A9ric_Chopin" default="true"/>
+		<f:source xml:id="bcert" xlink:href="urn:isbn:9780007351824"/>
+	</f:sources>
+
+	<f:factoid type="name">
+		<language>pol</language>
+		<f:value>Fryderyk Franciszek Chopin</f:value>
+	</f:factoid>
+
+	<f:factoid type="name">
+		<language>pol</language>
+		<f:value>Fryderyk Chopin</f:value>
+	</f:factoid>
+
+	<f:name>
+		<language>fra</language>
+		<f:value>Frédéric Chopin</f:value>
+	</f:name>
+
+	<f:name>
+		<language>fra</language>
+		<alphabet>Hang</alphabet>
+		<f:value>프레데리크 쇼팽</f:value>
+	</f:name>
+
+	<f:factoid type="birth-date">
+		<f:value type="xsd:date">1810-08-22</f:value>
+		<f:source xlink:href="#bcert"/>
+	</f:factoid>
+
+	<f:birth-date>
+		<f:value type="xsd:date">1810-03-01</f:value>
+	</f:birth-date>
+
+	<f:birth-place>
+		<f:value>
+			<f:place xlink:href="zelazowa-wola"/>
+		</f:value>
+	</f:birth-place>
+
+	<f:death-date>
+		<f:value type="xsd:date">1849-10-17</f:value>
+	</f:death-date>
+</f:entity>
+<!-- This is free software released into the public domain (CC0 license). -->

data/spec/fixtures/zelazowa-wola

@@ -0,0 +1,19 @@
+<f:entity type="place" xml:id="zelazowa-wola" xmlns:f='http://svario.it/factoid'
+          xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:xsd="http://www.w3.org/2001/XMLSchema-datatypes">
+	<f:sources>
+		<f:source xml:id="wp" xlink:href="http://en.wikipedia.org/wiki/Żelazowa_Wola" default="true"/>
+	</f:sources>
+
+	<f:name>
+		<language>pol</language>
+		<f:value>Żelazowa Wola</f:value>
+	</f:name>
+
+	<f:gmina>
+		<f:value>
+			<f:entity xlink:href="sochaczew"/>
+		</f:value>
+	</f:gmina>
+</f:entity>
+<!-- This is free software released into the public domain (CC0 license). -->

data/spec/fixtures/zelazowa-wola.xml

@@ -0,0 +1,19 @@
+<f:entity type="place" xml:id="zelazowa-wola" xmlns:f='http://svario.it/factoid'
+          xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:xsd="http://www.w3.org/2001/XMLSchema-datatypes">
+	<f:sources>
+		<f:source xml:id="wp" xlink:href="http://en.wikipedia.org/wiki/Żelazowa_Wola" default="true"/>
+	</f:sources>
+
+	<f:name>
+		<language>pol</language>
+		<f:value>Żelazowa Wola</f:value>
+	</f:name>
+
+	<f:gmina>
+		<f:value>
+			<f:entity xlink:href="sochaczew"/>
+		</f:value>
+	</f:gmina>
+</f:entity>
+<!-- This is free software released into the public domain (CC0 license). -->

data/spec/spec_helpers.rb

@@ -0,0 +1,3 @@
+# This is free software released into the public domain (CC0 license).
+
+

metadata

@@ -0,0 +1,142 @@
+--- !ruby/object:Gem::Specification
+name: factoid
+version: !ruby/object:Gem::Version
+  version: '0.1'
+platform: ruby
+authors:
+- Gioele Barabucci
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-10-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: addressable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email:
+- gioele@svario.it
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- COPYING
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- factoid.gemspec
+- lib/factoid.rb
+- lib/factoid/entitoid.rb
+- lib/factoid/entitoid_ref.rb
+- lib/factoid/factoid.rb
+- lib/factoid/source.rb
+- lib/factoid/value.rb
+- lib/factoid/version.rb
+- lib/factoid/xml.rb
+- spec/factoid/entitoid_spec.rb
+- spec/factoid/factoid_spec.rb
+- spec/fixtures/chopin.xml
+- spec/fixtures/zelazowa-wola
+- spec/fixtures/zelazowa-wola.xml
+- spec/spec_helpers.rb
+homepage: http://svario.it/factoid/ruby
+licenses:
+- CC0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.4
+signing_key: 
+specification_version: 4
+summary: factoid is a Ruby library to manipulate factoids entitoids inside Ruby applications
+  without touching the their XML representations.
+test_files:
+- spec/factoid/entitoid_spec.rb
+- spec/factoid/factoid_spec.rb
+- spec/fixtures/chopin.xml
+- spec/fixtures/zelazowa-wola
+- spec/fixtures/zelazowa-wola.xml
+- spec/spec_helpers.rb