spira 0.5.0 → 0.7

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    YmI4NjdiNmExYjA4YTc4MjQ0MzhiM2E0MmE3MWNmY2NhNDkwZGI0OA==
+  data.tar.gz: !binary |-
+    NTMzZGYyOWNjOWY0ODQ3ZGVhNjVkYjNhMDZjZTljN2ExMGU3Mzc1ZQ==
+SHA512:
+  metadata.gz: !binary |-
+    MDJlZjY1MjZiNDNiOGMyYTE0YzJiYzU5MzBjMWEyY2I2NmE1NjBlNmY2Y2Jk
+    NDhhZjQxYTFkZDIzNTllMjdkNzgxMzI2OTdhZmM4M2I1OTIxY2RlYjNjZDhh
+    ZGE0OGU3NzQ0OTMyNzg1ZDI1Y2U4OWEyN2ZlMjk4ZjI0NTE1MjA=
+  data.tar.gz: !binary |-
+    ZTRhNWRkMGFmZDdhYWVmMzk1YjNmMWMyMzYzZjYxOWNkYTY3NTUyMTUyYzdm
+    ODE4NWM1YTFhNmZiYjRjN2YyMDYxYmZjZGQyY2VkZTA1NTU0NDAzYjA5ZGU5
+    NDc0YzU2NWFlNzNjZjA2MTJlMzRhMjUyYzhkNjIzYzIzMmZhMzM=

data/README.md

@@ -2,6 +2,10 @@
 
 It's time to breathe life into your linked data.
 
+## Need Help? Use our Google Group
+
+If you have any question on how to use Spira, please use the [Google Group ruby-rdf](https://groups.google.com/forum/#!forum/ruby-rdf).
+
 ## Synopsis
 Spira is a framework for using the information in [RDF.rb][] repositories as model
 objects.  It gives you the ability to work in a resource-oriented way without
@@ -15,29 +19,32 @@ A changelog is available in the {file:CHANGES.md} file.
 
 ### Example
 
-    class Person < Spira::Base
+```ruby
+class Person < Spira::Base
 
-      configure :base_uri => "http://example.org/example/people"
-    
-      property :name, :predicate => FOAF.name, :type => String
-      property :age,  :predicate => FOAF.age,  :type => Integer
+  configure :base_uri => "http://example.org/example/people"
 
-    end
+  property :name, :predicate => FOAF.name, :type => String
+  property :age,  :predicate => FOAF.age,  :type => Integer
+
+end
+
+Spira.repository = RDF::Repository.new
 
-    bob = RDF::URI("http://example.org/people/bob").as(Person)
-    bob.age  = 15
-    bob.name = "Bob Smith"
-    bob.save!
+bob = RDF::URI("http://example.org/people/bob").as(Person)
+bob.age  = 15
+bob.name = "Bob Smith"
+bob.save!
+
+bob.each_statement {|s| puts s}
+#=> RDF::Statement:0x80abb80c(<http://example.org/example/people/bob> <http://xmlns.com/foaf/0.1/name> "Bob Smith" .)
+#=> RDF::Statement:0x80abb8fc(<http://example.org/example/people/bob> <http://xmlns.com/foaf/0.1/age> "15"^^<http://www.w3.org/2001/XMLSchema#integer> .)
+```
 
-    bob.each_statement {|s| puts s}
-    #=> RDF::Statement:0x80abb80c(<http://example.org/example/people/bob> <http://xmlns.com/foaf/0.1/name> "Bob Smith" .)
-    #=> RDF::Statement:0x80abb8fc(<http://example.org/example/people/bob> <http://xmlns.com/foaf/0.1/age> "15"^^<http://www.w3.org/2001/XMLSchema#integer> .)
-   
 ### Features
 
  * Extensible validations system
  * Extensible types system
- * Easy to use multiple data sources
  * Easy to adapt models to existing data
  * Open-world semantics
  * Objects are still RDF.rb-compatible enumerable objects
@@ -81,7 +88,7 @@ as possible, there are a few changes that you should be aware of:
    for such resource and will only persist its properties.
    Although this is how the original Spira behaves too, I thought I'd state it
    explicitly here before you start freaking out.
- * Configuration options "base_uri", "default_vocabulary" and "repository_name" are
+ * Configuration options "base_uri", "default_vocabulary" are
    now configured via "configure" method (see the examples below).
  * A couple of (not so) subtle changes:
    1) Global caching is gone. This means that "artist.works.first.artist" (reverse lookup)
@@ -101,35 +108,41 @@ To use Spira, define model classes for your RDF data.  Spira classes include
 RDF, and thus have access to all `RDF::Vocabulary` classes and `RDF::URI`
 without the `RDF::` prefix.  For example:
 
-    require 'spira'
-    
-    class CD < Spira::Base
-      configure :base_uri => 'http://example.org/cds'
-      property :name,   :predicate => DC.title,   :type => XSD.string
-      property :artist, :predicate => URI.new('http://example.org/vocab/artist'), :type => :artist
-    end
+```ruby
+require 'spira'
     
-    class Artist < Spira::Base
-      configure :base_uri => 'http://example.org/artists'
-      property :name, :predicate => DC.title, :type => XSD.string
-      has_many :cds,  :predicate => URI.new('http://example.org/vocab/published_cd'), :type => XSD.string
-    end
-
-Then use your model classes, in a way more or less similar to any number of ORMs:
-
-    cd = CD.for("queens-greatest-hits")
-    cd.name = "Queen's greatest hits"
-    artist = Artist.for("queen")
-    artist.name = "Queen"
-    
-    cd.artist = artist
-    cd.save!
-    artist.cds = [cd]
-    artist.save!
-
-    queen = Artist.for('queen')
-    hits = CD.for 'queens-greatest-hits'
-    hits.artist == artist == queen
+class CD < Spira::Base
+  configure :base_uri => 'http://example.org/cds'
+  property :name,   :predicate => DC.title,   :type => XSD.string
+  property :artist, :predicate => URI.new('http://example.org/vocab/artist'), :type => :artist
+end
+
+class Artist < Spira::Base
+  configure :base_uri => 'http://example.org/artists'
+  property :name, :predicate => DC.title, :type => XSD.string
+  has_many :cds,  :predicate => URI.new('http://example.org/vocab/published_cd'), :type => XSD.string
+end
+```
+
+Then define a Spira repository (see [Defining Repositories](#defining-repositories)) to use your model classes, in a way more or less similar to any number of ORMs:
+
+```ruby
+Spira.repository = RDF::Repository.new
+
+cd = CD.for("queens-greatest-hits")
+cd.name = "Queen's greatest hits"
+artist = Artist.for("queen")
+artist.name = "Queen"
+
+cd.artist = artist
+cd.save!
+artist.cds = [cd]
+artist.save!
+
+queen = Artist.for('queen')
+hits = CD.for 'queens-greatest-hits'
+hits.artist == artist == queen
+```
 
 ### URIs and Blank Nodes
 
@@ -138,17 +151,23 @@ Spira instances have a subject, which is either a URI or a blank node.
 A class with a base URI can instantiate with a string (or anything, via to_s),
 and it will have a URI representation:
 
-    Artist.for('queen')
+```ruby
+Artist.for('queen')
+```
 
 However, a class is not required to have a base URI, and even if it does, it
 can always access classes with a full URI:
 
-    nk = Artist.for(RDF::URI.new('http://example.org/my-hidden-cds/new-kids'))
+```ruby
+nk = Artist.for(RDF::URI.new('http://example.org/my-hidden-cds/new-kids'))
+```
 
 If you have a URI that you would like to look at as a Spira resource, you can instantiate it from the URI:
 
-    RDF::URI.new('http://example.org/my-hidden-cds/new-kids').as(Artist)
-    # => <Artist @subject=http://example.org/my-hidden-cds/new-kids>
+```ruby
+RDF::URI.new('http://example.org/my-hidden-cds/new-kids').as(Artist)
+# => <Artist @subject=http://example.org/my-hidden-cds/new-kids>
+```
 
 Any call to 'for' with a valid identifier will always return an object with nil
 fields.  It's a way of looking at a given resource, not a closed-world mapping
@@ -156,16 +175,20 @@ to one.
 
 You can also use blank nodes more or less as you would a URI:
 
-    remix_artist = Artist.for(RDF::Node.new)
-    # => <Artist @subject=#<RDF::Node:0xd1d314(_:g13751060)>>
-    RDF::Node.new.as(Artist)
-    # => <Artist @subject=#<RDF::Node:0xd1d314(_:g13751040)>>
+```ruby
+remix_artist = Artist.for(RDF::Node.new)
+# => <Artist @subject=#<RDF::Node:0xd1d314(_:g13751060)>>
+RDF::Node.new.as(Artist)
+# => <Artist @subject=#<RDF::Node:0xd1d314(_:g13751040)>>
+```
 
 Finally, you can create an instance of a Spira projection with #new, and you'll
 get an instance with a shiny new blank node subject:
 
-    formerly_known_as_prince = Artist.new
-    # => <Artist @subject=#<RDF::Node:0xd1d314(_:g13747140)>>
+```ruby
+formerly_known_as_prince = Artist.new
+# => <Artist @subject=#<RDF::Node:0xd1d314(_:g13747140)>>
+```
 
 ### Class Options
 
@@ -177,38 +200,50 @@ A class with a `base_uri` set (either an `RDF::URI` or a `String`) will
 use that URI as a base URI for non-absolute `for` calls.
 
 Example
-    CD.for 'queens-greatest-hits' # is the same as...
-    CD.for RDF::URI.new('http://example.org/cds/queens-greatest-hits')
+```ruby
+CD.for 'queens-greatest-hits' # is the same as...
+CD.for RDF::URI.new('http://example.org/cds/queens-greatest-hits')
+```
 
 #### type
 
 A class with a `type` set is assigned an `RDF.type` on creation and saving.
 
-    class Album < Spira::Base
-      type URI.new('http://example.org/types/album')
-      property :name,   :predicate => DC.title
-    end
+```ruby
+class Album < Spira::Base
+  type URI.new('http://example.org/types/album')
+  property :name,   :predicate => DC.title
+end
 
-    rolling_stones = Album.for RDF::URI.new('http://example.org/cds/rolling-stones-hits')
-    # See RDF.rb at http://rdf.rubyforge.org/RDF/Enumerable.html for more information about #has_predicate?
-    rolling_stones.has_predicate?(RDF.type) #=> true
-    Album.type #=> RDF::URI('http://example.org/types/album')
+Spira.repository = RDF::Repository.new
+
+rolling_stones = Album.for RDF::URI.new('http://example.org/cds/rolling-stones-hits')
+# See RDF.rb at http://rdf.rubyforge.org/RDF/Enumerable.html for more information about #has_predicate?
+rolling_stones.has_predicate?(RDF.type) #=> true
+Album.type #=> RDF::URI('http://example.org/types/album')
+`
 
 In addition, one can count the members of a class with a `type` defined:
 
-    Album.count  #=> 1 
+```ruby
+Album.count  #=> 1 
+```
 
 
 It is possible to assign multiple types to a Spira class:
 
-    class Man < Spira::Base
-      type RDF::URI.new('http://example.org/people/father')
-      type RDF::URI.new('http://example.org/people/cop')
-    end
+```ruby
+class Man < Spira::Base
+  type RDF::URI.new('http://example.org/people/father')
+  type RDF::URI.new('http://example.org/people/cop')
+end
+```
 
 All assigned types are accessible via "types":
 
-    Man.types #=> #<Set: {#<RDF::URI:0xd5ebc0(http://example.org/people/father)>, #<RDF::URI:0xd5e4b8(http://example.org/people/cop)>}>
+```ruby
+Man.types #=> #<Set: {#<RDF::URI:0xd5ebc0(http://example.org/people/father)>, #<RDF::URI:0xd5e4b8(http://example.org/people/cop)>}>
+```
 
 Also note that "type" actually returns a first type from the list of types.
 
@@ -225,30 +260,23 @@ A class declares list members with the `has_many` function.  See `Property Optio
 
 A class with a `default_vocabulary` set will transparently create predicates for defined properties:
 
-    class Song < Spira::Base
-      configure :default_vocabulary => URI.new('http://example.org/vocab'),
-                :base_uri => 'http://example.org/songs'
-      property :title
-      property :author, :type => :artist
-    end
+```ruby
+class Song < Spira::Base
+  configure :default_vocabulary => URI.new('http://example.org/vocab'),
+            :base_uri => 'http://example.org/songs'
+  property :title
+  property :author, :type => :artist
+end
 
-    dancing_queen = Song.for 'dancing-queen'
-    dancing_queen.title = "Dancing Queen"
-    dancing_queen.artist = abba
-    # See RDF::Enumerable for #has_predicate?
-    dancing_queen.has_predicate?(RDF::URI.new('http://example.org/vocab/title'))  #=> true
-    dancing_queen.has_predicate?(RDF::URI.new('http://example.org/vocab/artist')) #=> true
+Spira.repository = RDF::Repository.new
 
-#### repository_name
-
-Provides this class with a default repository to use instead of the `:default`
-repository if one is not set.
-
-    class Song < Spira::Base
-      configure :repository_name => :songs
-    end
-
-See 'Defining Repositories' for more information.
+dancing_queen = Song.for 'dancing-queen'
+dancing_queen.title = "Dancing Queen"
+dancing_queen.artist = abba
+# See RDF::Enumerable for #has_predicate?
+dancing_queen.has_predicate?(RDF::URI.new('http://example.org/vocab/title'))  #=> true
+dancing_queen.has_predicate?(RDF::URI.new('http://example.org/vocab/artist')) #=> true
+```
 
 ### Property Options
 
@@ -268,6 +296,32 @@ Property always takes a symbol name as a name, and a variable list of options.
    **Types** below.  Default: `Any`
  * `:predicate`: The predicate to use for this type.  This can be any RDF URI.
    This option is required unless the `default_vocabulary` has been used.
+ * `:localized`: Indicates if the property is multilingual. See 'Localized Properties'
+
+#### Localized Properties
+
+A localized property allows to define a value per language. It only works with
+properties having a single item, ie defined with `property`.
+
+```ruby
+class Article < Spira::Base
+  property :label, :localized => true
+end
+
+Spira.repository = RDF::Repository.new
+
+# default locale :en
+random_article = Article.for 'random-article'
+random_article.label = "A label in english"
+i18n.locale = :fr
+random_article.label = "Un libellé en français"
+
+random_article.label_native
+# #=> [#<RDF::Literal:0xdb47c8("A label in english"@en)>, #<RDF::Literal:0xe5c3d8("Un libellé en français"@fr)>]
+
+random_article.label_with_locales
+# #=> {:en=>"A label in english", :fr=>"Un libellé en français"}
+```
 
 ### Types
 
@@ -288,29 +342,33 @@ A type class includes Spira::Type, and can implement serialization and
 deserialization functions, and register aliases to themselves if their datatype
 is usually expressed as a URI.  Here is the built-in Spira Integer class:
 
-    module Spira::Types
-      class Integer
-    
-        include Spira::Type
-    
-        def self.unserialize(value)
-          value.object
-        end
-    
-        def self.serialize(value)
-          RDF::Literal.new(value)
-        end
-    
-        register_alias RDF::XSD.integer
-      end
+```ruby
+module Spira::Types
+  class Integer
+
+    include Spira::Type
+
+    def self.unserialize(value)
+      value.object
+    end
+
+    def self.serialize(value)
+      RDF::Literal.new(value)
     end
 
+    register_alias RDF::XSD.integer
+  end
+end
+```
+
 Classes can now use this particular type like so:
 
-    class Test < Spira::Base
-      property :test1, :type => Integer
-      property :test2, :type => RDF::XSD.integer
-    end
+```ruby
+class Test < Spira::Base
+  property :test1, :type => Integer
+  property :test2, :type => RDF::XSD.integer
+end
+```
 
 Spira classes include the Spira::Types namespace, where several default types
 are implemented:
@@ -328,55 +386,67 @@ The default type for a Spira property is `Spira::Types::Any`, which uses
 You can implement your own types as well.  Your class' serialize method should
 turn an RDF::Value into a ruby object, and vice versa.
 
-    module MyModule
-      class MyType
-        include Spira::Type
-        def self.serialize(value)
-          ...
-        end
-
-        def self.unserialize(value)
-          ...
-        end
-      end
+```ruby
+module MyModule
+  class MyType
+    include Spira::Type
+    def self.serialize(value)
+      ...
     end
 
-    class MyClass < Spira::Base
-      property :property1, :type => MyModule::MyType
+    def self.unserialize(value)
+      ...
     end
+  end
+end
+
+class MyClass < Spira::Base
+  property :property1, :type => MyModule::MyType
+end
+```
 
 ## Defining Repositories
 
-You can define multiple repositories with Spira, and use more than one at a time:
+You can work on any kind of RDF::Repository with Spira:
 
-    require 'rdf/ntriples'
-    require 'rdf/sesame'
-    Spira.add_repository! :cds,    RDF::Sesame::Repository.new 'some_server'
-    Spira.add_repository! :albums, RDF::Repository.load('some_file.nt')
+```ruby
+require 'rdf/ntriples'
+require 'rdf/sesame'
 
-    class CD < Spira::Base
-      configure :repository_name => :cds
-    end
-    class Album < Spira::Base
-      configure :repository_name => :albums
-    end
+class Album < Spira::Base
+end
 
-Objects can reference each other cross-repository.
+Spira.repository = RDF::Sesame::Repository.new 'some_server'
+...
 
-If no repository has been specified, the `:default` repository will be used.
+Spira.repository = RDF::Repository.load('some_file.nt')
+...
 
-    repo = RDF::Repository.new
-    Spira.add_repository! :default, repo
-    Artist.repository == repo #=> true
+Spira.using_repository(RDF::Repository.load('some_file.nt')) do
+   ...
+end
+```
 
-Classes can specify a default repository to use other than `:default` with the
-`repository_name` function:
+Spira.repository is thread-safe, which means that each thread stores its own instance.
+It allows you to work on multiple repositories at the same time:
 
-    class Song < Spira::Base
-      configure :repository_name => :songs
-    end
+```ruby
+threads = []
+repositories = [RDF::Repository.new, RDF::Repository.new, RDF::Repository.new]
+
+repositories.each do |repository|
+  threads << Thread.new(repository) do |repository|
+    Spira.repository = repository
+
+    album = Album.for("http://theperson.com/album/random_name")
+    album.year = 1950 + (rand*100).to_i
+    album.save!
+  end
+end
 
-    Song.repository #=> nil, won't use :default
+threads.map(&:join)
+repositories.map(&:size).join(', ') # 1, 1, 1
+```
 
 ## Validations
 
@@ -408,8 +478,19 @@ Spira is free and unemcumbered software released into the public
 domain.  For more information, see the included UNLICENSE file.
 
 ## Contributing
-Fork it on Github and go.  Please make sure you're kosher with the UNLICENSE
-file before contributing.
+This repository uses [Git Flow](https://github.com/nvie/gitflow) to mange development and release activity. All submissions _must_ be on a feature branch based on the _develop_ branch to ease staging and integration.
+
+* Do your best to adhere to the existing coding conventions and idioms.
+* Don't use hard tabs, and don't leave trailing whitespace on any line.
+* Do document every method you add using [YARD][] annotations. Read the
+  [tutorial][YARD-GS] or just look at the existing code for examples.
+* Don't touch the `.gemspec`, `VERSION` or `AUTHORS` files. If you need to
+  change them, do so on your private branch only.
+* Do feel free to add yourself to the `CREDITS` file and the corresponding
+  list in the the `README`. Alphabetical order applies.
+* Do note that in order for us to merge any non-trivial changes (as a rule
+  of thumb, additions larger than about 15 lines of code), we need an
+  explicit [public domain dedication][PDD] on record from you.
 
 [public-rdf-ruby w3c mailing list]:         http://lists.w3.org/Archives/Public/public-rdf-ruby/
-[RDF.rb]:                                   http://rdf.rubyforge.org
+[RDF.rb]:          http://rubygems.org/gems/rdf

data/VERSION

@@ -0,0 +1 @@
+0.7.0

data/lib/spira/base.rb

@@ -323,6 +323,35 @@ module Spira
       end
     end
 
+    ## Localized properties functions
+
+    def merge_localized_property(name, arg)
+      values = read_attribute("#{name}_native")
+      values.delete_if { |s| s.language == I18n.locale }
+      values << serialize_localized_property(arg, I18n.locale)
+      values
+    end
+
+    def serialize_localized_property(value, locale)
+      RDF::Literal.new(value, :language => locale)
+    end
+
+    def unserialize_localized_properties(values, locale)
+      v = values.detect { |s| s.language == locale || s.simple? }
+      v && v.object
+    end
+
+    def hash_localized_properties(values)
+      values.inject({}) do |out, v|
+        out[v.language] = v.object
+        out
+      end
+    end
+
+    def serialize_hash_localized_properties(values)
+      values.map { |lang, property| RDF::Literal.new(property, :language => lang) }
+    end
+
     # Build a Ruby value from an RDF value.
     def build_value(node, type)
       klass = classize_resource(type)

data/lib/spira/persistence.rb

@@ -3,22 +3,13 @@ module Spira
     extend ActiveSupport::Concern
 
     module ClassMethods
-      ##
-      # Repository name for this class
-      #
-      # @return [Symbol]
-      def repository_name
-        # should be redefined in children, if required
-        # see also Spira::Resource.configure :repository option
-        :default
-      end
 
       ##
       # The current repository for this class
       #
       # @return [RDF::Repository, nil]
       def repository
-        Spira.repository(repository_name)
+        Spira.repository || raise(NoRepositoryError)
       end
 
       ##
@@ -233,11 +224,6 @@ module Spira
         when identifier.respond_to?(:to_uri) && !identifier.is_a?(RDF::URI)
           id_for(identifier.to_uri)
           # see comment with #to_uri above, this might be a fragment
-        when identifier.is_a?(Addressable::URI)
-          id_for(RDF::URI.intern(identifier))
-          # This is a #to_s or a URI fragment with a base uri.  We'll treat them the same.
-          # FIXME: when #/ makes it into RDF.rb proper, this can all be wrapped
-          # into the one case statement above.
         else
           uri = identifier.is_a?(RDF::URI) ? identifier : RDF::URI.intern(identifier.to_s)
           case
@@ -377,13 +363,10 @@ module Spira
     # This resource will block if the underlying repository
     # blocks the next time it accesses attributes.
     #
-    # If repository is not defined, the attributes are just not set,
-    # instead of raising a Spira::NoRepositoryError.
-    #
     # NB: "props" argument is ignored, it is handled in Base
     #
     def reload(props = {})
-      sts = self.class.repository && self.class.repository.query(:subject => subject)
+      sts = self.class.repository.query(:subject => subject)
       self.class.properties.each do |name, options|
         name = name.to_s
         if sts

data/lib/spira/resource.rb

@@ -7,7 +7,6 @@ module Spira
     # Configuration options for the Spira::Resource:
     #
     # @params[Hash] options
-    #   :repository_name    :: name of the repository to use
     #   :base_uri           :: base URI to be used for the resource
     #   :default_vocabulary :: default vocabulary to use for the properties
     #                          defined for this resource
@@ -16,8 +15,7 @@ module Spira
     #
     def configure(options = {})
       singleton_class.class_eval do
-        { :repository_name => options[:repository_name],
-          :base_uri => options[:base_uri],
+        { :base_uri => options[:base_uri],
           :default_vocabulary => options[:default_vocabulary]
         }.each do |name, value|
           # redefine reader methods only when required,
@@ -80,17 +78,23 @@ module Spira
     # @see Spira::Type
     # @return [Void]
     def property(name, opts = {})
-      unset_has_many(name)
-      predicate = predicate_for(opts[:predicate], name)
-      type = type_for(opts[:type])
-      properties[name] = HashWithIndifferentAccess.new(:predicate => predicate, :type => type)
+      if opts.delete(:localized)
+        raise 'Only Spira::Types::Any properties can accept the :localized option' unless type_for(opts[:type]) == Spira::Types::Any
+        define_localized_property_methods(name, opts)
+        has_many "#{name}_native", opts.merge(:type => Spira::Types::Native)
+      else
+        unset_has_many(name)
+        predicate = predicate_for(opts[:predicate], name)
+        type = type_for(opts[:type])
+        properties[name] = HashWithIndifferentAccess.new(:predicate => predicate, :type => type)
 
-      define_attribute_method name
-      define_method "#{name}=" do |arg|
-        write_attribute name, arg
-      end
-      define_method name do
-        read_attribute name
+        define_attribute_method name
+        define_method "#{name}=" do |arg|
+          write_attribute name, arg
+        end
+        define_method name do
+          read_attribute name
+        end
       end
     end
 
@@ -120,7 +124,6 @@ module Spira
       end
     end
 
-
     private
 
     # Unset a has_many relation if it exists. Allow to redefine the cardinality of a relation in a subClass
@@ -134,6 +137,32 @@ module Spira
       end
     end
 
+    ##
+    # Create the localized specific getter/setter for a given property
+    #
+    # @private
+    def define_localized_property_methods(name, opts)
+      define_method "#{name}=" do |arg|
+        new_value = merge_localized_property(name, arg)
+        write_attribute "#{name}_native", new_value
+      end
+
+      define_method name do
+        value = read_attribute("#{name}_native")
+        unserialize_localized_properties(value, I18n.locale)
+      end
+
+      define_method "#{name}_with_locales" do
+        value = read_attribute("#{name}_native")
+        hash_localized_properties(value)
+      end
+
+      define_method "#{name}_with_locales=" do |arg|
+        value = serialize_hash_localized_properties(arg)
+        write_attribute "#{name}_native", value
+      end
+    end
+
     ##
     # Determine the predicate for a property based on the given predicate, name, and default vocabulary
     #

data/lib/spira.rb

@@ -12,11 +12,6 @@ require "spira/utils"
 # @see http://github.com/bhuga/spira
 # @see Spira::Resource
 
-module RDF
-  class Repository
-  end
-end
-
 module Spira
 
   autoload :Base,             'spira/base'
@@ -35,73 +30,51 @@ module Spira
   module_function :types
 
   ##
-  # Add a repository to Spira's list of repositories.
-  #
-  # @overload add_repository(name, repo)
-  #   @param [Symbol] name The name of this repository
-  #   @param [RDF::Repository] repo
+  # The RDF::Repository used (reader)
   #
-  # @overload add_repository(name, klass, *args)
-  #   @param [Symbol] name The name of this repository
-  #   @param [Class] klass
-  #     A Class that inherits from `RDF::Repository`
-  #   @param [Array] args
-  #     The list of arguments to instantiate the class
-  #
-  # @example Adding an ntriples file as a repository
-  #     Spira.add_repository(:default, RDF::Repository.load('http://datagraph.org/jhacker/foaf.nt'))
-  # @example Adding an empty repository to be instantiated on use
-  #     Spira.add_repository(:default, RDF::Repository)
-  # @return [Void]
-  def add_repository(name, klass, *args)
-    repositories[name] =
-      case klass
-      when Class
-        promise { klass.new(*args) }
-      else
-        klass
-      end
-    if (name == :default) && repository(name).nil?
-      warn "WARNING: Adding nil default repository"
-    end
+  # @return [RDF::Repository]
+  # @see RDF::Repository
+  def repository
+    Thread.current[:repository]
   end
-  alias_method :add_repository!, :add_repository
-  module_function :add_repository, :add_repository!
+  module_function :repository
 
   ##
-  # The RDF::Repository for the named repository
+  # The RDF::Repository used (reader)
   #
-  # @param [Symbol] name The name of the repository
   # @return [RDF::Repository]
   # @see RDF::Repository
-  def repository(name)
-    repositories[name]
+  def repository=(repository)
+    Thread.current[:repository] = repository
   end
-  module_function :repository
+  module_function :repository=
 
   ##
-  # Clear all repositories from Spira's knowledge.  Use it if you want, but
+  # Clear the repository from Spira's knowledge.  Use it if you want, but
   # it's really here for testing.
   #
   # @return [Void]
   # @private
-  def clear_repositories!
-    @repositories = {}
+  def clear_repository!
+    Spira.repository = nil
   end
-  module_function :clear_repositories!
-
-
-  private
+  module_function :clear_repository!
 
-  ##
-  # The list of repositories available for Spira resources
+  # Execute a block on a specific repository
   #
-  # @see http://rdf.rubyforge.org/RDF/Repository.html
-  # @return [Hash{Symbol => RDF::Repository}]
-  def repositories
-    @repositories ||= {}
+  # @param [RDF::Repository] repository the repository to work on
+  # @param [Symbol] name the repository name
+  # @yield the block with the instructions while using the repository
+  def using_repository(repo)
+    old_repository = Spira.repository
+    Spira.repository = repo
+    yield if block_given?
+  ensure
+    Spira.repository = old_repository
   end
-  module_function :repositories
+  module_function :using_repository
+
+  private
 
   ##
   # Alias a property type to another.  This allows a range of options to be

metadata

@@ -1,8 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: spira
 version: !ruby/object:Gem::Version
-  version: 0.5.0
-  prerelease: 
+  version: '0.7'
 platform: ruby
 authors:
 - Ben Lavender
@@ -10,196 +9,186 @@ autorequire:
 bindir:
 - bin
 cert_chain: []
-date: 2013-03-01 00:00:00.000000000 Z
+date: 2013-12-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: rdf-spec
+  name: bundler
+  type: :development
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: '1.0'
-  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: '1.0'
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: rdf-spec
+  type: :development
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 2.12.0
+        version: '1.1'
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: rspec
   type: :development
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.14.0
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 2.12.0
+        version: 2.14.0
 - !ruby/object:Gem::Dependency
   name: yard
+  type: :development
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 0.8.3
-  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 0.8.3
 - !ruby/object:Gem::Dependency
   name: redcarpet
+  type: :development
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 2.2.2
-  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 2.2.2
 - !ruby/object:Gem::Dependency
   name: guard
+  type: :development
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 1.2.3
-  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 1.2.3
 - !ruby/object:Gem::Dependency
   name: guard-rspec
+  type: :development
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 1.1.0
-  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 1.1.0
 - !ruby/object:Gem::Dependency
   name: guard-ctags-bundler
+  type: :development
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 0.1.1
-  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 0.1.1
 - !ruby/object:Gem::Dependency
   name: rdf
+  type: :runtime
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '1.0'
-  type: :runtime
+        version: '1.1'
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '1.1'
 - !ruby/object:Gem::Dependency
   name: rdf-isomorphic
+  type: :runtime
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '1.0'
-  type: :runtime
+        version: '1.1'
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '1.1'
 - !ruby/object:Gem::Dependency
   name: promise
+  type: :runtime
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 0.3.0
-  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 0.3.0
 - !ruby/object:Gem::Dependency
   name: activemodel
+  type: :runtime
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: '3'
-  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: '3'
 - !ruby/object:Gem::Dependency
   name: activesupport
+  type: :runtime
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: '3'
-  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -215,62 +204,62 @@ files:
 - AUTHORS
 - README.md
 - UNLICENSE
-- lib/rdf/ext/uri.rb
-- lib/spira/association_reflection.rb
-- lib/spira/base.rb
+- VERSION
+- lib/spira.rb
+- lib/spira/validations.rb
+- lib/spira/resource.rb
+- lib/spira/types.rb
 - lib/spira/exceptions.rb
-- lib/spira/persistence.rb
 - lib/spira/reflections.rb
-- lib/spira/resource.rb
-- lib/spira/serialization.rb
-- lib/spira/type.rb
-- lib/spira/types/any.rb
-- lib/spira/types/boolean.rb
-- lib/spira/types/date.rb
-- lib/spira/types/dateTime.rb
+- lib/spira/version.rb
+- lib/spira/validations/uniqueness.rb
+- lib/spira/base.rb
+- lib/spira/association_reflection.rb
+- lib/spira/utils.rb
+- lib/spira/types/native.rb
 - lib/spira/types/decimal.rb
-- lib/spira/types/float.rb
+- lib/spira/types/string.rb
+- lib/spira/types/nonPositiveInteger.rb
 - lib/spira/types/gYear.rb
-- lib/spira/types/int.rb
-- lib/spira/types/integer.rb
-- lib/spira/types/long.rb
-- lib/spira/types/native.rb
 - lib/spira/types/negativeInteger.rb
+- lib/spira/types/date.rb
+- lib/spira/types/boolean.rb
 - lib/spira/types/nonNegativeInteger.rb
-- lib/spira/types/nonPositiveInteger.rb
+- lib/spira/types/float.rb
 - lib/spira/types/positiveInteger.rb
-- lib/spira/types/string.rb
+- lib/spira/types/any.rb
+- lib/spira/types/integer.rb
+- lib/spira/types/int.rb
 - lib/spira/types/uri.rb
-- lib/spira/types.rb
-- lib/spira/utils.rb
-- lib/spira/validations/uniqueness.rb
-- lib/spira/validations.rb
-- lib/spira/version.rb
-- lib/spira.rb
-homepage: http://spira.rubyforge.org
+- lib/spira/types/dateTime.rb
+- lib/spira/types/long.rb
+- lib/spira/serialization.rb
+- lib/spira/type.rb
+- lib/spira/persistence.rb
+- lib/rdf/ext/uri.rb
+homepage: http://ruby-rdf.github.io/spira/
 licenses:
 - Public Domain
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: 1.9.2
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: spira
-rubygems_version: 1.8.25
+rubygems_version: 2.1.11
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: A framework for using the information in RDF.rb repositories as model objects.
 test_files: []
 has_rdoc: yard