parasite 0.2.0

data/History.txt

@@ -0,0 +1,7 @@
+Release 0-2-0
+-- added parasite executable, links into rails environment
+-- updated generator to be compatible with changes in Rails
+-- updated generator to be compatible with changes in Camping
+-- cleaned up some behind the scenes stuff
+-- add a website to the build
+

data/Manifest.txt

@@ -0,0 +1,8 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+bin/parasite
+lib/parasite.rb
+test/test_parasite.rb
+templates/server.rake

data/README.txt

@@ -0,0 +1,117 @@
+** Parasite
+
+Camping app developers no longer have any reason to envy their Ruby on Rails friends: Parasite brings generators, environments, and other Rails-y goodness to the world of Camping app development.
+
+Parasite is currently at version 0.2. The Parasite package is composed of two gems: parasite and the camping_generator. The first provides a way to hook into the Rails development environment, while the second provides a generator for creating Camping apps quickly and painlessly.
+
+*** Installation
+
+To install parasite and the camping_generator fire up a terminal and:
+
+$ sudo gem install parasite
+parasite will require the camping_generator, along with Rails and Camping. More details on installing those packages can be found at their project pages.
+
+If you are installing Camping for the first time, I would encourage you to install the camping-omnibus gem:
+
+$ sudo gem install camping-omnibus --source http://code.whytheluckystiff.net
+If you wish to install the camping_generator without the parasite gem, you can install it directly with:
+
+$ sudo gem install camping_generator
+Usage
+
+**** Parasite
+The parasite package consists of an executable and a set of Rake templates to facilitate the building of Camping apps. Using the executable, you can latch on to a “host” Rails project. Just run the executable in an existing Rails environment.
+
+$ rails example_project
+      create  
+      create  app/controllers
+            ...
+$ cd example_project/
+$ ls
+README          components      doc             public          tmp
+Rakefile        config          lib             script          vendor
+app             db              log             test
+$ parasite
+/path/to/parasite/parasite-0.2.0/bin/../templates/
+
+/path/to/parasiteparasite-0.2.0/bin/../templates/server.rake
+
+Installed parasite to ./vendor/plugins/parasite
+$ ls -R vendor/plugins/parasite/
+tasks
+
+vendor/plugins/parasite//tasks:
+server.rake
+$
+To see a description of the installed rake tasks,
+
+$ rake -T
+    rake camping:server            # Run the camping server with specified files or all .rb files in the apps directory
+    ...
+Now you’re ready to start creating camping apps, using the camping_generator.
+
+**** Camping Generator
+The camping_generator adds a generator for creating templated Camping apps. If you’re not familiar with the structure of single file Camping apps, see The Camping Short, Short Example. To see the usage,
+
+$ script/generate camping
+Usage: script/generate camping CampingName [options]
+
+Options:
+        --scaffold                   Generate controllers and views
+        --session                    Add session support
+        --stylesheet                 Include a dynamic style sheet
+
+Rails Info:
+    -v, --version                    Show the Rails version number and quit.
+    -h, --help                       Show this help message and quit.
+
+General Options:
+    -p, --pretend                    Run but do not make any changes.
+    -f, --force                      Overwrite files that already exist.
+    -s, --skip                       Skip files that already exist.
+    -q, --quiet                      Suppress normal output.
+    -t, --backtrace                  Debugging: show backtrace on errors.
+    -c, --svn                        Modify files with subversion. (Note: svn must be in path)
+
+Description:
+    The camping generator creates a new camping app in a single file in the /app
+    directory.
+
+Example:
+    ./script/generate camping --scaffold Blog Post User
+
+    This will create a Blog app with models (Posts and Users), views,
+    controllers, and the appropriate pre-amble and post-amble.
+
+For example, let’s create the canonical jukebox app using the generator:
+
+$ script/generate camping Jukebox Artist Record Track --scaffold --stylesheet
+      exists  app/
+      create  app/jukebox.rb
+$ cat app/jukebox.rb 
+#!/usr/bin/env ruby
+
+require 'camping' 
+Camping.goes :Jukebox
+
+module Jukebox
+
+end
+
+module Jukebox::Models
+  class Artist < Base; end
+  class Record < Base; end
+  class Track < Base; end
+    ...
+Closer investigation of the jukebox app is left as an exercise to the reader.
+
+*** Support
+
+The best place for getting support is on #camping on irc.freenode.net. Just ask for mfredrickson. Also, you can file bugs and patches on Parasite project page on RubyForge.
+
+*** Links
+
+http://rubyforge.org/projects/parasite
+http://rubyonrails.com/
+http://code.whytheluckystiff.net/camping
+

data/Rakefile

@@ -0,0 +1,20 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'echoe'
+require '../version.rb'
+
+# Copy in history and readmes
+File.cp '../History.txt', './History.txt'
+File.cp '../README.txt', './README.txt'
+
+Echoe.new('parasite', Parasite::Common::MAJOR_VERSION + '.0') do |p|
+  p.rubyforge_name = 'parasite'
+  p.summary = 'Turn a Rails environment into a Camping factory'
+  p.description = p.paragraphs_of('README.txt', 2..3).join("\n\n")
+  p.url = Parasite::Common::URL
+  p.changes = p.paragraphs_of('History.txt', 0..1).join("\n\n")
+  p.extra_deps = [['camping_generator', '0.2.0']]
+end
+
+# vim: syntax=Ruby

data/bin/parasite

@@ -0,0 +1,49 @@
+#!/usr/bin/env ruby
+
+require 'fileutils'
+require 'optparse'
+
+templates = File.dirname(__FILE__) + '/../templates/'
+
+puts templates + "\n\n"
+
+OPTIONS = {
+  :rails_root => '.'
+}
+parser = OptionParser.new do |opts|
+  opts.banner = <<BANNER
+Turn your Rails environment into a Camping factory.
+Installs rake tasks and overrides generators to make 
+creating Camping apps faster and easier.
+
+Usage: #{File.basename($0)} [--apply-to <rails app path>]
+
+Options are:
+BANNER
+  opts.separator ""
+  opts.on("-a", "--apply-to=PATH", String,
+          "Root path of your rails application",
+          "Default: .") { |OPTIONS[:rails_root]| }
+  opts.parse!(ARGV)
+end
+
+plugins    = File.join(OPTIONS[:rails_root], 'vendor', 'plugins')
+parasite_path  = File.join(plugins, 'parasite')
+tasks_path = File.join(parasite_path, 'tasks')
+task_templates = Dir[File.join(templates, '*.rake')]
+
+FileUtils.rm_rf parasite_path
+Dir.mkdir parasite_path
+
+Dir.mkdir tasks_path
+Dir.chdir tasks_path do
+  task_templates.each do |template_name|
+    puts template_name + "\n\n"
+    task_name = File.basename(template_name).sub(/\Atasks_/,'')
+    template = File.open(template_name,'r') {|f| f.readlines.join}
+    File.open(task_name, 'w') {|file| file << template }
+  end
+end
+
+puts "Installed parasite to #{parasite_path}"
+

data/lib/parasite.rb

@@ -0,0 +1,3 @@
+class Parasite
+  VERSION = '1.0.0'
+end

data/templates/server.rake

@@ -0,0 +1,127 @@
+#!/usr/local/bin/ruby                                                                                           
+namespace :camping do
+    desc "Run the camping server with specified files or all .rb files in the apps directory"
+    task :server do
+      require 'rubygems'       
+      require 'camping'  
+      require 'camping/reloader'
+      require 'webrick/httpserver'
+      require 'camping/webrick'
+  
+      # Get the database and log from the current rails environment
+      require(File.join(RAILS_ROOT, 'config', 'environment'))
+      database = (YAML.load(open(File.join('config', 'database.yml')))[RAILS_ENV])
+      log = File.join(RAILS_ROOT, 'log', RAILS_ENV + '.log')
+  
+      # TODO take these from environment variables or something else useful
+      webhost = '0.0.0.0'
+      webport = '3301'
+  
+      ARGV.shift # drop the 'camping' command from the list
+  
+      # if the user specified a file(s) use it, otherwise grab everything in /app
+      ARGV << File.join(RAILS_ROOT, 'app') if ARGV.empty? 
+  
+      # from the camping command line tool:
+      # Load apps
+      PATHS = ARGV.dup
+      apps = PATHS.inject([]) do |apps, script|
+          if File.directory? script
+              apps.push(*Dir[File.join(script, '*.rb')])
+          else
+              apps << script
+          end
+      end
+  
+      Camping::Reloader.database = database
+      Camping::Reloader.log = log
+      apps.map! { |script| Camping::Reloader.new(script) }
+      abort("** No apps successfully loaded") unless apps.detect { |app| app.klass }
+  
+      def apps.find_new_scripts
+          each { |app| app.reload_app }
+          PATHS.each do |path|
+              Dir[File.join(path, '*.rb')].each do |script|
+                  smount = File.basename(script, '.rb')
+                  next if detect { |x| x.mount == smount }
+  
+                  puts "** Discovered new #{script}"
+                  app = Camping::Reloader.new(script)
+                  next unless app
+  
+                  yield app
+                  self << app
+              end
+          end
+          self.sort! { |x, y| x.mount <=> y.mount }
+      end
+  
+      def apps.index_page
+          welcome = "You are Camping"
+          apps = self
+          b = Markaby::Builder.new({}, {})
+          b = b.instance_eval do
+              html do
+                  head do
+                      title welcome
+                      style <<-END, :type => 'text/css'
+                          body { 
+                              font-family: verdana, arial, sans-serif; 
+                              padding: 10px 40px; 
+                              margin: 0; 
+                          }
+                          h1, h2, h3, h4, h5, h6 {
+                              font-family: utopia, georgia, serif;
+                          }
+                      END
+                  end
+                  body do
+                      h1 welcome
+                      p %{Good day.  These are the Camping apps you mounted.}
+                      ul do
+                          apps.each do |app|
+                              next unless app.klass
+                              li do
+                                  h3(:style => "display: inline") { a app.klass.name, :href => "/#{app.mount}" }
+                                  small { text " / " ; a "View Source", :href => "/code/#{app.mount}" }
+                              end
+                          end
+                      end
+                  end
+              end
+          end
+          b.to_s
+      end
+
+      # Mount the root
+      s = WEBrick::HTTPServer.new(:BindAddress => webhost, :Port => webport)
+      if apps.length > 1
+          apps.each do |app|
+              s.mount "/#{app.mount}", WEBrick::CampingHandler, app
+              s.mount_proc("/code/#{app.mount}") do |req, resp|
+                  resp['Content-Type'] = 'text/plain'
+                  resp.body = app.view_source
+              end
+          end
+          s.mount_proc("/") do |req, resp|
+              apps.find_new_scripts do |app|
+                  s.mount "/#{app.mount}", WEBrick::CampingHandler, app
+                  s.mount_proc("/code/#{app.mount}") do |req, resp|
+                      resp['Content-Type'] = 'text/plain'
+                      resp.body = app.view_source
+                  end
+              end
+              resp.body = apps.index_page
+          end
+      else
+          s.mount "/", WEBrick::CampingHandler, apps.first
+      end
+  
+      # Server up
+      trap(:INT) do
+          s.shutdown
+      end
+      s.start
+
+    end
+end

metadata

@@ -0,0 +1,61 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.1
+specification_version: 1
+name: parasite
+version: !ruby/object:Gem::Version 
+  version: 0.2.0
+date: 2007-03-11 00:00:00 -06:00
+summary: Turn a Rails environment into a Camping factory
+require_paths: 
+- lib
+email: ""
+homepage: http://parasite.rubyforge.org
+rubyforge_project: parasite
+description: "Parasite is currently at version 0.2. The Parasite package is composed of two gems: parasite and the camping_generator. The first provides a way to hook into the Rails development environment, while the second provides a generator for creating Camping apps quickly and painlessly.  *** Installation"
+autorequire: 
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- ""
+files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- bin/parasite
+- lib/parasite.rb
+- test/test_parasite.rb
+- templates/server.rake
+test_files: 
+- test/test_parasite.rb
+rdoc_options: []
+
+extra_rdoc_files: []
+
+executables: 
+- parasite
+extensions: []
+
+requirements: []
+
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: camping_generator
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Version::Requirement 
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        version: 0.2.0
+    version: