Changeset 144

Timestamp:

11/24/05 03:00:59 (3 years ago)

Author:

lazyatom

Message:

Added load_plugin_fixtures task and documentation

Files:

• plugins/engines/README (modified) (1 diff)
• plugins/engines/tasks/engines.rake (modified) (1 diff)

plugins/engines/README

@@ -241 +241 @@
-        $LOAD_PATH.unshift(Test::Unit::TestCase.fixture_path)
-
+== Loading Fixtures
+
+An additional helpful task for loading fixture data is also provided (thanks to Joe Van Dyk):
+
+  rake load_plugin_fixtures
+  rake load_plugin_fixtures PLUGIN=login_engine
+  
+will load the engine fixture data into your development database.
+
+=== Important Caveat
+Unlike the new 'fixture' directive described above, this task currently relies on you ensuring that the table name to load fixtures into is the same as the name of the fixtures file you are trying to load. If you are using defaults, this should be fine. If you have changed table names, you will need to rename your fixtures files (and possibly update your tests to reflect this too).
+
+You should also note that fixtures typically tend to depend on test configuration information (such as test salt values), so not all data will be usable in fixture form.

plugins/engines/tasks/engines.rake

@@ -32 +32 @@
-  end
-end
+
+# this is just a rip-off from the plugin stuff in railties/lib/tasks/documentation.rake, 
+# because the default plugindoc stuff doesn't support subdirectories like app.
+
+AllEngines = FileList['vendor/plugins/*_engine'].map {|engine| File.basename(engine)}
+# Define doc tasks for each engine
+AllEngines.each do |engine|
+  task :"#{engine}_enginedoc" => :environment do
+    engine_base   = "vendor/plugins/#{engine}"
+    options       = []
+    files         = Rake::FileList.new
+    options << "-o doc/plugins/#{engine}"
+    options << "--title '#{engine.titlecase} Documentation'"
+    options << '--line-numbers --inline-source'
+    options << '--all' #Â include protected methods
+    options << '-T html'
+
+    files.include("#{engine_base}/lib/**/*.rb")
+    files.include("#{engine_base}/app/**/*.rb")
+    if File.exists?("#{engine_base}/README")
+      files.include("#{engine_base}/README")    
+      options << "--main '#{engine_base}/README'"
+    end
+    files.include("#{engine_base}/CHANGELOG") if File.exists?("#{engine_base}/CHANGELOG")
+
+    options << files.to_s
+
+    sh %(rdoc #{options * ' '})
+  end
+end
+
+desc "Generate documation for all installed engines"
+task :enginedoc => AllEngines.map {|engine| :"#{engine}_enginedoc"}
+
+
+desc "Load plugin/engine fixtures into the current environment's database."
+task :load_plugin_fixtures => :environment do
+  require 'active_record/fixtures'
+  ActiveRecord::Base.establish_connection(RAILS_ENV.to_sym)
+  plugin = ENV['PLUGIN'] || '*'
+  Dir.glob(File.join(RAILS_ROOT, 'vendor', 'plugins', plugin, 'test', 'fixtures', '*.yml')).each do |fixture_file|
+    Fixtures.create_fixtures(File.dirname(fixture_file), File.basename(fixture_file, '.*'))
+  end
+end