rtm-rails 0.3.0 → 0.3.1

data/DISCLAIMER

@@ -1,3 +1,5 @@
+Copyright 2006-2008 Benjamin Bock
+
 Copyright 2008-2010 Topic Maps Lab, University of Leipzig.
 
 Licensed under the Apache License, Version 2.0 (the "License"); 
@@ -10,4 +12,4 @@ Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS, 
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
 See the License for the specific language governing permissions and limitations 
-under the License.
+under the License.

data/lib/rtm/rails.rb

@@ -73,7 +73,7 @@ module RTM
       def self.run(configuration = Configuration.new)
         yield configuration if block_given?
         initializer = new configuration
-        initializer.process
+        initializer.process unless RTM::Rails.initialized?
         initializer
       end
 
@@ -181,7 +181,7 @@ module RTM
         failed_connections = RTM.connections.reject { |identifier,con| con.check }
         unless failed_connections.empty?
           puts "Warning: The following topicmap connection(s) are not properly prepared: #{failed_connections.map{|identifier,con| identifier}.to_sentence}"
-          puts "         Maybe you added them recently to your config but forgot 'rake topicmaps:migrate_backends'?"
+          puts "         Maybe you added them recently to your config but forgot 'rake topicmaps:migrate'?"
         end
       end
 
@@ -196,7 +196,7 @@ module RTM
             RTM.connections[con_spec.to_sym]
           when Hash # inline config given
             c = connect_anonymous(con_spec)
-            puts "Warning: The connection for topicmap '#{identifier}' is not yet prepared. Please run the topicmaps:migrate_backends rake task." unless c.check
+            puts "Warning: The connection for topicmap '#{identifier}' is not yet prepared. Please run the topicmaps:migrate rake task." unless c.check
             c
           else
             raise "Cannot determine connection for #{con_spec.inspect}"
@@ -244,7 +244,7 @@ module RTM
 
     def register_map(identifier, map)
       raise "A topic map with the identifier #{identifier.inspect} is already registered" if @topic_maps.keys.include?(identifier)
-      # TODO maybe we should allow to connect here?
+      # TODO: maybe we should allow to connect here?
       @topic_maps[identifier] = map
     end
 

data/lib/rtm/rails/rake_tasks.rb

@@ -11,7 +11,7 @@ namespace :topicmaps do
   end
 
   desc "Migrate RTM Backends to prepare them for storing topic maps"
-  task :migrate_backends => :load_config do
+  task :migrate => :load_config do
     RTM.connections.each do |identifier, con|
       unless con.check
         print "Migrating #{identifier}..."
@@ -21,6 +21,37 @@ namespace :topicmaps do
     end
   end
 
+  desc "Migrate RTM Backends DOWN to remove all topic maps"
+  task :migrate_down => :load_config do
+    RTM.connections.each do |identifier, con|
+      print "Migrating down #{identifier}..."
+      con.migrate_down
+      puts "done"
+    end
+  end
+
+  desc "Migrate RTM Backends DOWN to remove all topic maps (forced)"
+  task :migrate_force_down => :load_config do
+    RTM.connections.each do |identifier, con|
+      print "Migrating down (forced) #{identifier}..."
+      con.migrate_force_down
+      puts "done"
+    end
+  end
+
+  task :migrate_custom => :load_config do
+    script_fragment = ENV['TM_MIGRATE_CUSTOM'] || raise("Please provide environment variable TM_MIGRATE_CUSTOM")
+    RTM.connections.each do |identifier, con|
+      print "Migrating #{identifier}... using (#{script_fragment})"
+      con.migrate_custom script_fragment
+      puts "done. Please use '#{$0} topicmaps:check' to see if everything is OK."
+    end
+  end
+
+  task :migrate_backends => :migrate
+  task :migrate_backend => :migrate
+  task :migrate_up => :migrate
+
   desc "Check if all RTM Backends are properly set up"
   task :check => :load_config do
     fine, failed = RTM.connections.partition { |identifier,con| con.check }
@@ -29,7 +60,7 @@ namespace :topicmaps do
     else
       puts "The following #{fine.size} topicmap connections are OK: #{fine.map{|identifier,con| identifier}.to_sentence}"
       puts "The following #{failed.size} topicmap connections are NOT properly prepared: #{failed.map{|identifier,con| identifier}.to_sentence}"
-      puts "Run '#{$0} topicmaps:migrate_backends' to prepare them."
+      puts "Run '#{$0} topicmaps:migrate' to prepare them."
     end
   end
 end

data/rails_generators/templates/README.txt

@@ -8,7 +8,7 @@ rtm-rails Gem.
 
 2. Migrate your backends to make them ready for your topic maps:
 
-    jruby -S rake topicmaps:migrate_backends 
+    jruby -S rake topicmaps:migrate
 
 
 3. Use your topic maps in your application code:
@@ -19,8 +19,8 @@ rtm-rails Gem.
     end
 
     TM[:another_map].get("xsd:integer") # get an existing topic
-    
-    TM[:some_map].get!("a:b") # get topic (or create it if it does not exist)
+
+    TM[:some_map].get!("http://example.org/topics/b") # get topic (or create it if it does not exist)
 
 
 See http://rubygems.org/gems/rtm-rails for information about the Gem.
@@ -31,3 +31,4 @@ See http://www.topicmapslab.de/ for general information about Topic Maps.
 ==== License for RTM and RTM-Rails
 Copyright 2009 Topic Maps Lab, University of Leipzig.
 Apache License, Version 2.0
+

data/rails_generators/templates/topicmaps.example.yml

@@ -4,7 +4,7 @@
 #
 # === Default Environment
 # Most people want the same topic maps in all environments. The special
-# environment "default" is the basis for all other enviroments. The simplest
+# environment "default" is the basis for all other environments. The simplest
 # configuration is
 #
 default:
@@ -47,7 +47,7 @@ development:
 # RTM allows to connect to multiple backends at the same time. To connect to
 # multiple backends use the connections keyword. Each connection specified
 # here must have a name to identify the connection. The following example
-# creates two connections for the production environment: one persistent
+# creates three connections for the production environment: one persistent
 # (called primary) using mysql and one temporary (called tmp) in memory.
 # As with the topic maps, the names are arbitrary.
 #
@@ -110,7 +110,7 @@ production:
 # Some backends, like the Ontopia backend support additional settings which
 # can also be provided here.
 #
-# All connections are migrated using the rake task topicmaps:migrate_backend
+# All connections are migrated using the rake task topicmaps:migrate
 # and checked with the rake task topicmaps:check. The default connection is
 # only included there if it is used by at least one topicmap or the property
 # use_for_topicmaps is set:

data/rails_generators/templates/topicmaps.rake

@@ -5,7 +5,7 @@
 # the rtm-rails gem.
 #
 # This file allows you to use your topic maps in your rails tasks and provides
-# the Topic Maps backend migration tasks
+# the Topic Maps backend migration tasks.
 
 begin
   require "rtm/rails"

metadata

@@ -3,51 +3,51 @@ name: rtm-rails
 version: !ruby/object:Gem::Version 
   prerelease: false
   segments: 
-  - 0
-  - 3
-  - 0
-  version: 0.3.0
+    - 0
+    - 3
+    - 1
+  version: 0.3.1
 platform: ruby
 authors: 
-- Benjamin Bock
-- Arnim Bleier
-- Uta Schulze
-- Daniel Exner
+  - Benjamin Bock
+  - Arnim Bleier
+  - Uta Schulze
+  - Daniel Exner
 autorequire: 
 bindir: bin
 cert_chain: []
 
-date: 2010-04-13 00:00:00 +02:00
+date: 2010-09-28 00:00:00 +02:00
 default_executable: 
 dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: rtm-javatmapi
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        - 3
-        - 0
-        version: 0.3.0
-  type: :runtime
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
-  name: rtm-ontopia
-  prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        - 3
-        - 0
-        version: 0.3.0
-  type: :runtime
-  version_requirements: *id002
+  - !ruby/object:Gem::Dependency 
+    name: rtm-javatmapi
+    prerelease: false
+    requirement: &id001 !ruby/object:Gem::Requirement 
+      requirements: 
+        - - ">="
+          - !ruby/object:Gem::Version 
+            segments: 
+              - 0
+              - 3
+              - 1
+            version: 0.3.1
+    type: :runtime
+    version_requirements: *id001
+  - !ruby/object:Gem::Dependency 
+    name: rtm-ontopia
+    prerelease: false
+    requirement: &id002 !ruby/object:Gem::Requirement 
+      requirements: 
+        - - ">="
+          - !ruby/object:Gem::Version 
+            segments: 
+              - 0
+              - 3
+              - 1
+            version: 0.3.1
+    type: :runtime
+    version_requirements: *id002
 description: |
   ==== Topic Maps for Rails (rtm-rails)
   RTM-Rails is the Rails-Adapter for Ruby Topic Maps. It allows simple configuration of topicmaps in config/topicmaps.yml.
@@ -134,7 +134,7 @@ description: |
   Copyright 2009 Topic Maps Lab, University of Leipzig.
   Apache License, Version 2.0
 
-email: rtm+rtm-rails-gem-20100413@topicmapslab.de
+email: rtm+rtm-rails-gem-20100928@topicmapslab.de
 executables: []
 
 extensions: []
@@ -142,19 +142,19 @@ extensions: []
 extra_rdoc_files: []
 
 files: 
-- lib/rtm/rails/rake_tasks.rb
-- lib/rtm/rails.rb
-- lib/rtm-rails.rb
-- rails/init.rb
-- rails_generators/topicmaps_generator.rb
-- rails_generators/templates/topicmaps.rake
-- tasks/topicmaps_tasks.rake
-- rails_generators/templates/README.txt
-- rails_generators/templates/topicmaps.example.yml
-- rails_generators/templates/topicmaps.yml
-- LICENSE
-- DISCLAIMER
-- README
+  - lib/rtm-rails.rb
+  - lib/rtm/rails.rb
+  - lib/rtm/rails/rake_tasks.rb
+  - rails/init.rb
+  - rails_generators/topicmaps_generator.rb
+  - rails_generators/templates/topicmaps.rake
+  - tasks/topicmaps_tasks.rake
+  - rails_generators/templates/README.txt
+  - rails_generators/templates/topicmaps.example.yml
+  - rails_generators/templates/topicmaps.yml
+  - LICENSE
+  - DISCLAIMER
+  - README
 has_rdoc: true
 homepage: http://rtm.topicmapslab.de/
 licenses: []
@@ -163,21 +163,21 @@ post_install_message:
 rdoc_options: []
 
 require_paths: 
-- lib
+  - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
   requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      segments: 
-      - 0
-      version: "0"
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+          - 0
+        version: "0"
 required_rubygems_version: !ruby/object:Gem::Requirement 
   requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      segments: 
-      - 0
-      version: "0"
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+          - 0
+        version: "0"
 requirements: []
 
 rubyforge_project: rtm