rtm 0.2.0 → 0.2.1

data/spec/rtm/tmapi/core/variant_spec.rb

@@ -40,11 +40,11 @@ module RTM::Variant
         @variant2 = @name1.create_variant("Bubi",["endearment"])
       end
       it "should remove this Variant from the container (Name)" do
-        @name1.should have(2).children
+        @name1.should have(2).variants
         @variant1.remove
-        @name1.should have(1).children
+        @name1.should have(1).variants
         @variant2.remove
-        @name1.should have(0).children
+        @name1.should have(0).variants
       end
     end
     

data/spec/rtm_spec.rb

@@ -12,7 +12,6 @@ describe RTM do
   describe "#connect" do
     it "should have a TMAPI engine as default backend" do
       tms_tmapi = RTM.connect(:implementation => implementation_for_spec)
-      tms_tmapi.should be_a_kind_of RTM::TopicMapSystem
       tms_tmapi.should be_a_kind_of RTM::JavaTMAPI
       tms_tmapi.should be_a_kind_of org.tmapi.core.TopicMapSystem
     end

data/spec/spec_helper.rb

@@ -1,7 +1,7 @@
 # Copyright: Copyright 2009 Topic Maps Lab, University of Leipzig.
 # License:   Apache License, Version 2.0
 
-$: << File.join(File.dirname(__FILE__), "/../lib")
+$LOAD_PATH.unshift File.join(File.dirname(__FILE__), "/../lib")
 
 require 'spec'
 require 'rtm'
@@ -15,7 +15,12 @@ end
 
 def get_used_tm_sys_tm
   @basis = get_used_tm_sys
-  @basis.create("http://www.topicmapslab.de/")
+  tm = @basis.create("http://www.topicmapslab.de/")
+  if (implementation_for_spec == :hatana)
+    tm.merge_in(RTM.connect(:implementation => :ontopia).create("http://www.topicmapslab.de/"))
+  end
+# tm.enable_query_cache
+  return tm
 end
 
 def ar_available?

data/test/tmapi_tests.rb

@@ -0,0 +1,25 @@
+# Copyright: Copyright 2009 Topic Maps Lab, University of Leipzig.
+# License:   Apache License, Version 2.0
+
+$: << File.join(File.dirname(__FILE__), "/../lib")
+
+Dir[File.join(File.dirname(__FILE__), '/javalibs/*.jar')].each {|file| require file }
+
+require 'rtm'
+
+class TMAPITests
+
+  def initialize(engine)
+    RTM.connect(:implementation => engine)
+    run_tests_for_backend
+  end
+
+  def run_tests_for_backend
+    Java::OrgTmapi::AllTests.main([].to_java(Java::JavaLang::String))
+  end
+
+end
+
+engine = ENV['RTM_IMPLEMENTATION'] && ENV['RTM_IMPLEMENTATION'].to_sym || :ontopia
+
+TMAPITests.new(engine)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: rtm
 version: !ruby/object:Gem::Version 
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors: 
 - Benjamin Bock
@@ -12,12 +12,52 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-02-05 00:00:00 +01:00
+date: 2010-02-21 00:00:00 +01:00
 default_executable: 
 dependencies: []
 
-description: Ruby Topic Maps is a Topic Maps engine written in Ruby with several backends.
-email: "#rtm+rtm-gem-20100205@topicmapslab.de"
+description: |
+  ==== Ruby Topic Maps (RTM)
+  RTM is a Topic Maps engine written in Ruby. See http://rtm.topicmapslab.de/ for instructions.
+  Several backends and extensions are available as separate gems.
+  
+  ==== Overview
+  From a developer's perspective, RTM is a schema-less database management system.
+  The Topic Maps standard (described below) on which RTM is based provides a way of creating a self-describing schema just by using it.
+  
+  ==== Quickstart
+   require 'rtm'
+   connection = RTM.connect # uses the default Ontopia in-memory backend
+   topic_map = connection.create "http://example.org/my_topic_map/"
+   some_topic = topicmap.get!("identifier_of_the_topic")
+   some_topic["-"] = "default name for the topic"
+   topic_map.to_xtm("my_xtm_file.xtm")
+  
+  ==== Topic Maps
+  Topic Maps is an international industry standard (ISO13250) for interchangeably representing information
+  about the structure of information resources used to define topics, and the relationships between topics.
+  A set of one or more interrelated documents that employs the notation defined by this International Standard is called a topic map.
+  A topic map defines a multidimensional topic space - a space in which the locations are topics,
+  and in which the distances between topics are measurable in terms of the number of intervening topics
+  which must be visited in order to get from one topic to another, and the kinds of relationships that define
+  the path from one topic to another, if any, through the intervening topics, if any.
+  In addition, information objects can have properties, as well as values for those properties, assigned to them.
+  The Topic Maps Data Model which is used in this implementation can be found on http://www.isotopicmaps.org/sam/sam-model/.
+  
+  ==== Backends
+  * rtm-ontopia: JRuby only, recommended, uses Ontopia: http://code.google.com/p/ontopia/
+  * rtm-tinytim: JRuby only, uses TinyTiM: http://tinytim.sourceforge.net/
+  * rtm-activerecord: uses a custom ActiveRecord schema
+  
+  ==== Extensions
+  * rtm-tmql: Adds support for the Topic Maps Query Language (TMQL), http://isotopicmaps.org/tmql/
+  * rtm-tmcl: Adds support for the Topic Maps Constraint Language (TMCL), http://isotopicmaps.org/tmcl/
+  
+  ==== License 
+  Copyright 2009 Topic Maps Lab, University of Leipzig.
+  Apache License, Version 2.0
+
+email: rtm+rtm-gem-20100221@topicmapslab.de
 executables: []
 
 extensions: []
@@ -42,8 +82,8 @@ files:
 - lib/rtm/helpers/no_output.rb
 - lib/rtm/helpers/uri.rb
 - lib/rtm/io/from_xtm2_libxml.rb
-- lib/rtm/io/ontopia_io.rb
-- lib/rtm/io/tmapix.rb
+- lib/rtm/io/tmapix_from.rb
+- lib/rtm/io/tmapix_to.rb
 - lib/rtm/io/to_hash.rb
 - lib/rtm/io/to_jtm.rb
 - lib/rtm/io/to_rdf.rb
@@ -69,14 +109,18 @@ files:
 - lib/rtm/psi.rb
 - lib/rtm/sugar/association/hash_access.rb
 - lib/rtm/sugar/occurrence/dynamic_value.rb
-- lib/rtm/sugar/occurrence/externalize.rb
+- lib/rtm/sugar/occurrence/external.rb
+- lib/rtm/sugar/reifiable/reifier.rb
 - lib/rtm/sugar/role/counterparts.rb
+- lib/rtm/sugar/topic/best_name.rb
 - lib/rtm/sugar/topic/characteristics.rb
 - lib/rtm/sugar/topic/counterparts.rb
 - lib/rtm/sugar/topic/hash_access.rb
 - lib/rtm/sugar/topic/scoped.rb
 - lib/rtm/sugar/topic/topic_ref.rb
 - lib/rtm/sugar/topic/typed.rb
+- lib/rtm/sugar/topic_map/query_cache.rb
+- lib/rtm/sugar/topic_map/themes.rb
 - lib/rtm/sugar/typed/types.rb
 - lib/rtm/sugar.rb
 - lib/rtm/validation.rb
@@ -93,7 +137,12 @@ files:
 - spec/rtm/axes/topic_spec.rb
 - spec/rtm/axes/topics_spec.rb
 - spec/rtm/base_spec.rb
-- spec/rtm/io/tmapix_spec.rb
+- spec/rtm/io/tmapix_from_spec.rb
+- spec/rtm/io/tmapix_to_spec.rb
+- spec/rtm/io/to_hash_spec.rb
+- spec/rtm/io/to_rdf_spec.rb
+- spec/rtm/io/to_string_spec.rb
+- spec/rtm/io/to_yaml_spec.rb
 - spec/rtm/navigation/association/players_spec.rb
 - spec/rtm/navigation/association_spec.rb
 - spec/rtm/navigation/name/atomify_spec.rb
@@ -115,16 +164,21 @@ files:
 - spec/rtm/navigation/topic_spec.rb
 - spec/rtm/sugar/association/hash_access_spec.rb
 - spec/rtm/sugar/occurrence/dynamic_value_spec.rb
+- spec/rtm/sugar/occurrence/external_spec.rb
+- spec/rtm/sugar/reifiable/reifier_spec.rb
 - spec/rtm/sugar/role/counterparts_spec.rb
+- spec/rtm/sugar/topic/best_name_spec.rb
 - spec/rtm/sugar/topic/characteristics_spec.rb
 - spec/rtm/sugar/topic/counterparts_spec.rb
 - spec/rtm/sugar/topic/hash_access_spec.rb
 - spec/rtm/sugar/topic/scoped_spec.rb
 - spec/rtm/sugar/topic/topic_ref_spec.rb
 - spec/rtm/sugar/topic/typed_spec.rb
+- spec/rtm/sugar/topic_map/themes_spec.rb
 - spec/rtm/sugar/typed/types_spec.rb
 - spec/rtm/tmapi/core/association_spec.rb
 - spec/rtm/tmapi/core/construct_spec.rb
+- spec/rtm/tmapi/core/datatype_aware_spec.rb
 - spec/rtm/tmapi/core/name_spec.rb
 - spec/rtm/tmapi/core/occurrence_spec.rb
 - spec/rtm/tmapi/core/reifiable_spec.rb
@@ -139,8 +193,9 @@ files:
 - spec/rtm/utils/sparql_spec.rb
 - spec/rtm_spec.rb
 - spec/spec_helper.rb
-- test/base_unit_test.rb
-- test/base_unit_test_tmapi.rb
+- test/tmapi_tests.rb
+- test/javalibs/junit-4.5.jar
+- test/javalibs/tmapi-2.0-tests.jar
 - LICENSE
 - DISCLAIMER
 - README
@@ -171,6 +226,6 @@ rubyforge_project: rtm
 rubygems_version: 1.3.5
 signing_key: 
 specification_version: 3
-summary: Ruby Topic Maps is a Topic Maps engine written in Ruby
+summary: Ruby Topic Maps is a Topic Maps engine written in Ruby.
 test_files: []
 

data/lib/rtm/io/ontopia_io.rb

@@ -1,25 +0,0 @@
-# Copyright: Copyright 2009 Topic Maps Lab, University of Leipzig.
-# License:   Apache License, Version 2.0
-
-
-module RTM::IO
-  # Import and Export of TMAPI Topic Maps
-  # Utilizing the Ontopia libary http://code.google.com/p/tmapix/
-  # Consequently the (de-) serializer provided here 
-  # are only Wrapper
-  
-  module Ontopia
-    module TopicMap
-      def to_cxtm(filename)
-        raise("Only supported for Ontopia.") unless self.kind_of?(net.ontopia.topicmaps.impl.tmapi2.TopicMapImpl)
-        out_file = java.io.FileOutputStream.new(filename) 
-        writer = net.ontopia.topicmaps.xml.CanonicalXTMWriter.new(out_file)
-        writer.write(self.wrapped)
-        out_file.flush
-        out_file.close      
-      end
-    end
-    
-    RTM.register_extension(self)
-  end
-end

data/lib/rtm/io/tmapix.rb

@@ -1,234 +0,0 @@
-# Copyright: Copyright 2009 Topic Maps Lab, University of Leipzig.
-# License:   Apache License, Version 2.0
-
-module RTM::IO
-# Import and Export of TMAPI Topic Maps
-# Utilizing the TMAPIX libary http://code.google.com/p/tmapix/
-# Consequently the (de-) serializer provided here 
-# are only Wrapper
-
-  module TMAPIX
-    module TopicMap
-      
-      # Reads a Topic Map from an LTM File
-      # whose location is given as String parameter
-      #
-      # :call-seq:
-      #   from_ltm(filename)
-      #
-      def from_ltm(filename)
-        raise "Only supported for TMAPI backends!!" unless self.kind_of? Java::OrgTmapiCore::TopicMap 
-        org.tmapix.io.LTMTopicMapReader.new(self,  java.io.File.new(filename)).read
-      end
-      
-      # Reads a Topic Map from an CTM File
-      # whose location is given as String parameter
-      #
-      # :call-seq:
-      #   from_ctm(filename)
-      #
-      def from_ctm(filename)
-        raise "Only supported for TMAPI backends!!" unless self.kind_of? Java::OrgTmapiCore::TopicMap 
-        org.tmapix.io.CTMTopicMapReader.new(self,  java.io.File.new(filename)).read
-      end
-      
-      # Reads a JSON Topic Maps (JTM) File
-      # whose location is given as String parameter
-      #
-      # :call-seq:
-      #   from_jtm(filename)
-      #
-      def from_jtm(filename)
-        raise "Only supported for TMAPI backends!!" unless self.kind_of? Java::OrgTmapiCore::TopicMap 
-        # seems not to acceped all files that are found to be valid by the JTM validator
-        org.tmapix.io.JTMTopicMapReader.new(self,  java.io.File.new(filename)).read
-      end
-      
-      # Reads a Friendly Topic Maps XML (TM/XML) File
-      # independent of the version
-      # whose location is given as String parameter
-      #
-      # :call-seq:
-      #   from_tmxml(filename)
-      #
-      def from_tmxml(filename)
-        raise "Only supported for TMAPI backends!!" unless self.kind_of? Java::OrgTmapiCore::TopicMap 
-        org.tmapix.io.TMXMLTopicMapReader.new(self,  java.io.File.new(filename)).read
-      end
-      
-      # Reads a XML Topic Maps (XTM) 1.0 File
-      # whose location is given as String parameter
-      #
-      # :call-seq:
-      #   from_xtm10(filename)
-      #
-      def from_xtm10(filename)
-        raise "Only supported for TMAPI backends!!" unless self.kind_of? Java::OrgTmapiCore::TopicMap 
-        org.tmapix.io.XTM10TopicMapReader.new(self,  java.io.File.new(filename)).read
-      end
-      
-      # Reads a XML Topic Maps (XTM) 2.0 File
-      # whose location is given as String parameter
-      #
-      # :call-seq:
-      #   from_xtm20(filename)
-      #
-      def from_xtm20(filename)
-        from_xtm(filename)
-      end
-      
-      # Reads a XML Topic Maps (XTM) File
-      # independent of the version
-      # whose location is given as String parameter
-      #
-      # :call-seq:
-      #   from_xtm(filename)
-      #
-      def from_xtm(filename)
-        raise "Only supported for TMAPI backends!!" unless self.kind_of? Java::OrgTmapiCore::TopicMap 
-        org.tmapix.io.XTMTopicMapReader.new(self,  java.io.File.new(filename)).read
-      end
-      
-      # Reads a Notation3 (N3) File
-      # whose location is given as String 
-      # a second parameter has to be handed over
-      # providing the mapping vocabulary.
-      # The syntax of the vocabulary is guessed.
-      #
-      # :call-seq:
-      #   from_n3(source vocabulary)
-      #
-      def from_n3(filename, vocab)
-        raise "Only supported for TMAPI backends!!" unless self.kind_of? Java::OrgTmapiCore::TopicMap 
-        reader = org.tmapix.io.N3TopicMapReader.new self,  java.io.File.new(filename)
-        reader.setMappingSource(java.io.File.new(vocab))
-        reader.read
-      end
-      
-      # Reads a RDF/XML File
-      # whose location is given as String 
-      # a second parameter has to be handed over
-      # providing the mapping vocabulary.
-      # The syntax of the vocabulary is guessed.
-      #
-      # :call-seq:
-      #   from_rdfxml(source vocabulary)
-      #
-      def from_rdfxml(filename, vocab)
-        raise "Only supported for TMAPI backends!!" unless self.kind_of? Java::OrgTmapiCore::TopicMap 
-        reader = org.tmapix.io.RDFXMLTopicMapReader.new self,  java.io.File.new(filename)
-        reader.setMappingSource(java.io.File.new(vocab))
-        reader.read
-      end
-      
-      # Serializes an RTM::TopicMap to XTM v. 2.0.
-      #
-      # The argument filename defines the absolute location of the file that is created.
-      # The argument base_iri is used to resolve IRIs against.
-      #
-      # :call-seq:
-      #   to_xtm20(filename, base_iri)
-      #
-      def to_xtm20(filename, base_iri)
-        raise("Only supported for TMAPI backends.") unless self.kind_of?(Java::OrgTmapiCore::TopicMap)
-        out_file = java.io.FileOutputStream.new(filename)
-        writer = org.tmapix.io.XTM20TopicMapWriter.new(out_file, base_iri)
-        writer.write(self)
-        out_file.flush
-        out_file.close
-      end
-      alias :to_xtm :to_xtm20
-      
-      # Serializes an RTM::TopicMap to XTM v. 1.0.
-      #
-      # The argument filename defines the absolute location of the file that is created.
-      # The argument base_iri is used to resolve IRIs against.
-      # Both arguments have to be Strings.
-      #
-      # :call-seq:
-      #   to_xtm10(filename, base_iri)
-      #
-      def to_xtm10(filename, base_iri)
-        raise("Only supported for TMAPI backends.") unless self.kind_of?(Java::OrgTmapiCore::TopicMap) 
-        out_file = java.io.FileOutputStream.new(filename) 
-        writer = org.tmapix.io.XTM10TopicMapWriter.new(out_file, base_iri)
-        writer.write(self)
-        out_file.flush
-        out_file.close
-      end
-      
-      # Serializes an RTM::TopicMap to JTM.
-      #
-      # The argument filename defines the absolute location of the file that is created.
-      # The argument base_iri is used to resolve IRIs against.
-      #
-      # :call-seq:
-      #   to_jtm(filename, base_iri)
-      #
-      def to_jtm(filename, base_iri)
-        raise("Only supported for TMAPI backends.") unless self.kind_of?(Java::OrgTmapiCore::TopicMap)
-        out_file = java.io.FileOutputStream.new(filename) 
-        writer = org.tmapix.io.JTMTopicMapWriter.new(out_file, base_iri)
-        writer.write(self)
-        out_file.flush
-        out_file.close
-      end
-      alias :to_json :to_jtm
-
-      # Serializes an RTM::TopicMap to LTM.
-      #
-      # The argument filename defines the absolute location of the file that is created.
-      # The argument base_iri is used to resolve IRIs against.
-      #
-      # :call-seq:
-      #   to_ltm(filename, base_iri)
-      #
-      def to_ltm(filename, base_iri)
-        raise("Only supported for TMAPI backends.") unless self.kind_of?(Java::OrgTmapiCore::TopicMap)
-        out_file = java.io.FileOutputStream.new(filename) 
-        writer = org.tmapix.io.LTMTopicMapWriter.new(out_file, base_iri)
-        writer.write(self)
-        out_file.flush
-        out_file.close 
-      end
-
-      # Serializes an RTM::TopicMap to TM/XML.
-      #
-      # The argument filename defines the absolute location of the file that is created.
-      # The argument base_iri is used to resolve IRIs against.
-      #
-      # :call-seq:
-      #   to_tmxml(filename, base_iri)
-      #
-      def to_tmxml(filename, base_iri)
-        raise("Only supported for TMAPI backends.") unless self.kind_of?(Java::OrgTmapiCore::TopicMap)
-        out_file = java.io.FileOutputStream.new(filename) 
-        writer = org.tmapix.io.TMXMLTopicMapWriter.new(out_file, base_iri)
-        writer.write(self)
-        out_file.flush
-        out_file.close 
-      end
-
-      # Serializes an RTM::TopicMap to CTM.
-      #
-      # The argument filename defines the absolute location of the file that is created.
-      # The argument base_iri is used to resolve IRIs against.
-      #
-      # :call-seq:
-      #   to_ctm(filename, base_iri)
-      #
-      def to_ctm(filename, base_iri)
-        raise("Only supported for TMAPI backends.") unless self.kind_of?(Java::OrgTmapiCore::TopicMap)
-        out_file = java.io.FileOutputStream.new(filename)
-        line = "writer.features.export.itemidentifier = false, " + "writer.features.prefixDetection.enabled = false, " + "writer.features.templateDetection.enabled = false, " + "writer.features.templateDetection.topicTemplates = false , " + "writer.features.templateDetection.associationTemplates = false, " + "writer.features.templateMerger.enabled = false"  
-        writer = de.topicmapslab.ctm.writer.core.CTMTopicMapWriter.new(out_file, base_iri, line)
-        writer.write(self)
-        out_file.flush
-        out_file.close
-      end
-
-    end
-
-    RTM.register_extension(self)
-  end
-end