jruby-enginize 0.8

data/README.rdoc

@@ -0,0 +1,135 @@
+= JRuby-Enginize
+
+== About
+
+JRuby-Enginize is a generator for Google AppEngine compliant JRuby
+applications. The generator currently supports Sinatra and Merb with more
+frameworks to come in the future. If you want to learn more about Google
+AppEngine, go to http://code.google.com/appengine and have a look at the
+tutorials. For more about JRuby, please go to http://www.codehaus.org and see
+what's up running Ruby applications on a Java VM.
+
+== Prerequisites
+
+JRuby-Enginize needs a proper JRuby installation including rake and the
+Google AppEngine SDK (http://code.google.com/appengine/downloads.html) for
+Java. Make sure that the AppEngine configuration tool "appcfg.sh" is in your
+PATH as that's what parts of the software are wrapping.
+
+More dependencies depend on the framework template to generate an application
+for, but installation of additional gems is done with tools provided by
+Google (so below).
+
+== Installation
+
+The Google people worked hard to make JRuby easier to deploy than it was at
+the beginning, so don't blindly trust all those blog posts and samples you'll
+find but use the newest version of jruby-enginize and have a look at the Wiki
+page of the Google AppEngine JRuby tools
+(http://code.google.com/p/appengine-jruby/wiki/GettingStarted)
+to learn about the details beyond.
+
+These are the steps for installing the Google tools plus JRuby-Enginize
+running on top of it to streamline your first steps:
+
+  sudo gem sources -a http://gems.github.com  # Only needed once!
+  sudo gem install google-appengine
+  sudo gem install ulbrich-jruby-enginize
+
+You also need an Google AppEngine account to actually publish your code.
+Without account you can still play around with the tools and run applications
+locally.
+  
+== Using jruby-enginize
+
+JRuby-Enginize includes is a single executable named <tt>jruby-enginize</tt>
+which is inspired by the <tt>rails</tt> tool for generating Rails applications.
+So just call
+
+  jruby-enginize
+
+and have a look at the options.
+
+Here are the steps for creating and deploying a new Sinatra application:
+
+* Register with Google AppEngine and create a new application ID.
+
+* Generate your application with that new ID as directory name. Sample:
+
+  <tt>jruby-enginize --template sinatra jruby-enginize</tt>
+
+* Go to the new directory and install the missing gems first (depends on the
+  template you have chosen):
+
+  <tt>rake template:gems</tt>
+
+  !!Attention: Whenever you want to install additional gems, be sure
+  to use <tt>appcfg.rb gem</tt> provided by the Google AppEngine JRuby tools 
+  and not <tt>jgem</tt> as Google maintains a local repository per project and
+  bundles the files to upload from that information. You will run into missing
+  gems on the server if you bypass this! Best approach is to use a separate
+  JRuby installation for AppEngine development to run into missing gems when
+  running the application locally, too.
+
+* Learn about the available rake tasks
+
+  <tt>rake --tasks</tt>
+
+* Try out your application locally: 
+
+  <tt>sudo rake appengine:run</tt>
+
+* Deploy the application:
+
+  <tt>rake appengine:deploy</tt>
+
+  The first time you deploy your application, you will be asked for e-mail and
+  password to confirm your upload to the server.
+
+You can repeat the deployment whenever you want. Be sure to set the version
+number in the AppEngine::Rack.configure_app part of "config.ru" to a new
+value, when you are experimenting with an unstable version and don't want to
+risk your users getting exceptions.
+
+You can try the new version by opening e.g.
+
+<tt>http://3.latest.jruby-enginize.appspot.com</tt>
+
+and replacing "3" with the version number you want to run.
+
+Switch the application to the new version as default (stable version) by
+opening
+
+<tt>http://appengine.google.com/deployment?&app_id=jruby-enginize</tt>
+
+and setting a new default available at
+
+<tt>http://jruby-enginize.appspot.com</tt>
+
+A small README with these and a few more application specific hints is
+generated along with the source code. Have fun.
+
+== Copyright & License
+
+Copyright (c) 2009 Holtzbrinck Digital GmbH, Jan Ulbrich
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

data/bin/jruby-enginize

@@ -0,0 +1,6 @@
+#!//usr/bin/env ruby
+# JRuby-Enginize, a generator for Google AppEngine compliant JRuby apps.
+
+require 'lib/script'
+
+JRubyEnginize::Script.enginize

data/lib/generator.rb

@@ -0,0 +1,212 @@
+# JRuby-Enginize, a generator for Google AppEngine compliant JRuby apps.
+#
+# This file contains the JRubyEnginize::Generator class creating a new
+# directory tree of files drawn from a set of shared and specific templates.
+
+require 'ftools'
+require 'find'
+require 'digest/md5'
+
+module JRubyEnginize # :nodoc:
+
+  # Code for generating a directory tree created from a shared and a template
+  # specific set of template files.
+
+  class Generator
+    attr_reader :email, :template, :name, :path, :dryrun
+
+    # Constructor of the generator needing at least email, path and template
+    # to run.
+    #
+    # Parameters:
+    #
+    # [email] Mail address of the Google AppEngine account to publish with
+    # [path] Path of the directory to create
+    # [template] Name of the set of templates to generate from
+    # [options] Additional options
+    #
+    # Options:
+    # 
+    # [:name] Optional app name defaulting to name of directory
+    # [:dryrun] Flag to enable 
+
+    def initialize(email, path, template, options = {})
+      @email = email
+      @path = path
+      @template = template
+
+      options = options.dup
+
+      @name = options.delete(:name)
+      @name = File.basename(path) if @name.nil? or @name.empty?
+
+      @dryrun = options.delete(:dryrun)
+
+      raise ArgumentError, "Unknown option(s) #{options.keys.join(', ')}" unless options.empty?
+    end
+
+    # Runs the generator. Starts with setting up a map of files to create
+    # and overriding shared ones with template specific stuff. Runs through
+    # the collected files and calls process_file to render new files in the
+    # target path.
+
+    def run
+      templatesdir = Generator::templates_directory
+
+      shareddir = File.join(templatesdir, 'shared')
+      templatedir = File.join(templatesdir, template)
+
+      raise ArgumentError, 'Missing shared templates' unless File.stat(shareddir).directory?
+      raise ArgumentError, "Template \"#{template}\" missing" unless File.stat(templatedir).directory?
+
+      if dryrun
+        puts "Dry run which would generate the following files from template \"#{template}\":"
+      else
+        puts "Generating files from template \"#{template}\"."
+      end
+
+      template_files(shareddir, templatedir).each do |key, path|
+        target = File.join(self.path, key)
+
+        if dryrun
+          puts "  Creating \"#{target}\" from template\n    file \"#{path}\""
+        else
+          process_file(path, target)
+        end
+      end
+      
+      if not dryrun
+        puts "Done with directory \"#{self.path}\"."
+
+        puts "\nYour next steps:\n  cd #{self.path}\n\n  rake template:gems"
+        puts "\n  rake\n  rake --tasks"
+        puts "\n  sudo rake appengine:run # First call may fail: Just retry!"
+        puts "\n  rake appengine:deploy"
+      end
+    end
+
+    # Returns an Array with the available template names.
+
+    def self.templates
+      return Dir[File.join(Generator::templates_directory, '*')].collect { |path|
+               (name = File.basename(path)) == 'shared' ? nil : name }.compact
+    end      
+
+    protected
+
+      # Returns a Hash with relative paths of files as keys and the whole
+      # paths as values. Runs through all paths in the order as provided and
+      # overrides keys with files found in later paths.
+      #
+      # Sample:
+      #
+      #   + templates
+      #      + shared
+      #      |  + foo
+      #      |  + lib
+      #      |     + bar # Will be overridden with file found in specific
+      #      |
+      #      + specific
+      #         + lib
+      #         |  + bar
+      #         |
+      #         + other
+      #
+      #   => { 'foo' => '/path/templates/shared/foo',
+      #      'lib/bar' => '/path/templates/specific/bar',
+      #      'other' => '/path/templates/specific/other' }
+      #
+      # Parameters:
+      #
+      # [*paths] Paths to directories to gather files from
+
+      def template_files(*paths)
+        files = {}
+
+        Find.find(*paths) do |path|
+          Find.prune if path[-1].chr == '.'
+
+          next if File.stat(path).directory?
+          next if (key = path.gsub(/.*\/templates\/[^\/]+\//, '')) == ''
+
+          files[key] = path
+        end
+
+        return files
+      end      
+
+      # Creates the target file from the source including some substitution
+      # of variables. The target path needs not to exist, as directories are
+      # added on the fly. If the source is an executable, the target file will
+      # be set executable, too.
+      #
+      # Parameters:
+      #
+      # [source] Source file
+      # [target] Target file
+      #
+      # The source files may contain some variables which are replaced on the
+      # fly. All variables are set in double curly brackets and are let passed
+      # without modification if they ar not recognized.
+      #
+      # Supported variables:
+      #
+      # [{{email}}] E-mail address of the Google AppEngine account
+      # [{{name}}] Name of the application
+      # [{{template}}] Name of the template (e.g. "sinatra")
+      # [{{hexrand-xx}}] Hexadecimal random string with xx characters
+      # [{{numrand-xx}}] Random number with xx digits
+
+      def process_file(source, target)
+        content = File.read(source).gsub(/\{\{[^}]*\}\}/) do |variable|
+          case variable
+          when '{{email}}'
+            raise 'missing e-mail address' if email.nil? or email.empty?
+            email
+          when '{{name}}'
+            name
+          else
+            if hexrand = variable.match(/\{\{hexrand-([0-9]+)\}\}/) and
+              hexrand.length == 2 and (len = hexrand[1].to_i) > 0
+            then
+              str = ''
+
+              while str.length < len do
+                str << Digest::MD5.hexdigest("#{rand}-#{Time.now}-#{rand}")
+              end
+
+              str[0, len]
+            elsif numrand = variable.match(/\{\{numrand-([0-9]+)\}\}/) and
+              numrand.length == 2 and (len = numrand[1].to_i) > 0
+            then
+              str = ''
+
+              while str.length < len do
+                str << rand.to_s.sub(/^.*\.0*/, '')
+              end
+
+              str[0, len]
+            else
+              variable
+            end
+          end
+        end
+
+        File.makedirs(File.dirname(target))
+
+        File.open(target, 'wb') do |file|
+          stat = File.stat(source)
+
+          file.write(content)
+          file.chmod(stat.mode | 0x111) if stat.executable?
+        end
+      end
+
+      # Returns the directory where the template files reside (located
+      # relative to the source file of class JRubyEnginize::Generator).
+
+      def self.templates_directory
+        return File.join(File.dirname(File.dirname(__FILE__)), 'templates')
+      end
+  end
+end

data/lib/script.rb

@@ -0,0 +1,90 @@
+# JRuby-Enginize, a generator for Google AppEngine compliant JRuby apps.
+#
+# This file contains the JRubyEnginize::Script class refactored to keep the
+# executables lean.
+
+require 'optparse'
+require 'rubygems'
+
+require 'lib/generator'
+
+module JRubyEnginize # :nodoc:
+
+  # Commandline code refactored to keep the executables lean.
+
+  module Script
+    
+    # Command line code for the <tt>"jruby-enginize"</tt> executable. Call
+    # with <tt>"--help"</tt> to learn more. Checks for running on JRuby and
+    # having the Google AppEngine SDK around and forwards work to
+    # JRubyEnginize::Generator.
+
+    def self.enginize
+      email = nil
+      template = 'sinatra'
+      path = nil
+
+      prog = File.basename($0)
+
+=begin
+      # Check for running with JRuby: The whole generator makes no sense if not 
+      # running with or at least for JRuby...
+
+      begin
+        java.lang.String
+      rescue
+        $stderr.puts "!!#{prog} makes only sense on JRuby systems. Please try again." 
+        exit(1)
+      end
+=end
+
+      # The AppEngine SDK has to be around, too.
+
+      begin
+        raise ArgumentError if not File.stat(`which appcfg.sh`.chop).executable?
+      rescue Exception
+        $stderr.puts "!!AppEngine SDK missing. Please retry after installing and make sure that" 
+        $stderr.puts "AppEngine configuration tool \"appcfg.sh\" is in your PATH." 
+
+        exit(2)
+      end
+
+      options = { :name => nil, :dryrun => false }
+
+      OptionParser.new do |opt|
+        opt.banner = "Usage: #{prog} [options] --email address dirname"
+
+        opt.on('-e', '--email address', 'E-Mail address to publish app with') { |email| }
+        opt.on('-t', '--template name', "Name of the template (defaults to #{template})") { |template| }
+        opt.on('-n', '--name appname', 'Name of the app (defaults to dir basename)') { |name|
+          options[:name] = name }
+        opt.on('-d', '--dry', 'Test run not really creating files') {
+          options[:dryrun] = true }
+        opt.on('-T', '--templates', 'List available templates') {
+          puts 'Supported templates:'
+          JRubyEnginize::Generator.templates.each { |name| puts "  #{name}" }
+          exit(0) }
+
+        begin
+          opt.parse!(ARGV)
+
+          raise 'missing directory name' if (path = ARGV.first).nil? or path.empty?
+          raise 'directory already exists' if FileTest.exists? path
+          raise 'unknown template' if not JRubyEnginize::Generator.templates.include? template
+          
+          raise 'missing e-mail address' if email.nil? or email.empty?
+        rescue SystemExit
+          exit(1)
+        rescue Exception => exception
+          $stderr.puts "!!#{exception}\n\n"
+
+          opt.parse!(['--help'])
+
+          exit(3)
+        end
+      end
+      
+      JRubyEnginize::Generator.new(email, path, template, options).run
+    end
+  end
+end

data/templates/merb/.gitignore

@@ -0,0 +1,21 @@
+.DS_Store
+log/*
+tmp/*
+TAGS
+*~
+.#*
+schema/schema.rb
+schema/*_structure.sql
+schema/*.sqlite3
+schema/*.sqlite
+schema/*.db
+*.sqlite
+*.sqlite3
+*.db
+src/*
+.hgignore
+.hg/*
+.svn/*
+gems/gems/*
+gems/specifications/*
+merb_profile_results

data/templates/merb/app.rb

@@ -0,0 +1,31 @@
+# This application file was generated by jruby-enginize.
+
+begin
+  require 'appengine-apis/merb-logger'
+rescue Exception
+end
+
+# Class EngineApp implements the only controller of this application.
+
+class EngineApp < Merb::Controller
+  layout :engine_app
+
+  # Returns the location of the template depending on controller and action.
+  # Modified to match our flat world.
+  #
+  # Parameters:
+  #
+  # [action] Name of the action
+  # [type] Requested format
+  # [controller] Name of the controller
+
+  def _template_location(action, type = nil, controller = controller_name)
+    (controller == 'layout' ? "layout.#{action}.#{type}" : "#{action}.#{type}")
+  end
+
+  # GET /
+
+  def index
+    render
+  end
+end

data/templates/merb/config/framework.rb

@@ -0,0 +1,7 @@
+Merb::Config[:framework] = {
+  :application => Merb.root / 'app.rb',
+  :config => [Merb.root / 'config', nil],
+  :public => [Merb.root / 'public', nil],
+  :view   => Merb.root / 'views'
+}
+

data/templates/merb/config/init.rb

@@ -0,0 +1,37 @@
+# Go to http://wiki.merbivore.com/pages/init-rb
+
+#  use_orm :none
+use_test :rspec
+use_template_engine :erb
+
+# Specify a specific version of a dependency
+# dependency "RedCloth", "> 3.0"
+
+Merb::BootLoader.before_app_loads do
+  # This will get executed after dependencies have been loaded but before your app's classes have loaded.
+end
+ 
+Merb::BootLoader.after_app_loads do
+  # This will get executed after your app's classes have been loaded.
+end
+
+# Move this to app.rb if you want it to be reloadable in dev mode.
+Merb::Router.prepare do
+  match('/').to(:controller => 'engine_app', :action =>'index')
+
+  default_routes
+end
+
+Merb::Config.use { |c|
+  c[:environment]         = 'production',
+  c[:framework]           = {},
+  c[:log_level]           = :debug,
+  c[:log_stream]          = STDOUT,
+  c[:use_mutex]           = false,
+  c[:session_store]       = 'cookie',
+  c[:session_id_key]      = '_{{name}}_session_id',
+  c[:session_secret_key]  = '{{hexrand-41}}',
+  c[:exception_details]   = false,
+  c[:reload_classes]      = false,
+  c[:reload_templates]    = false
+}

data/templates/merb/config.ru

@@ -0,0 +1,19 @@
+require 'rubygems'
+require 'appengine-rack'
+
+require 'merb-core'
+
+AppEngine::Rack.configure_app(
+  # :ssl_enabled => true,
+  :application => '{{name}}',
+  :version => 1)
+
+Merb::Config.setup(:merb_root => File.dirname(__FILE__),
+                   :environment => ENV['RACK_ENV'])
+
+Merb.environment = Merb::Config[:environment]
+Merb.root = Merb::Config[:merb_root]
+
+Merb::BootLoader.run
+ 
+run Merb::Rack::Application.new

data/templates/merb/lib/tasks/merb.rake

@@ -0,0 +1,44 @@
+# Tasks provided by Merb are guarded with a rescue block as we need this file
+# to work prior to installation of Merb.
+
+begin
+  require 'merb-core'
+  require 'merb-core/tasks/merb'
+
+  include FileUtils
+
+  # Load the basic runtime dependencies; this will include 
+  # any plugins and therefore plugin rake tasks.
+  init_env = ENV['MERB_ENV'] || 'rake'
+  Merb.load_dependencies(:environment => init_env)
+     
+  # Get Merb plugins and dependencies
+  Merb::Plugins.rakefiles.each { |r| require r } 
+
+  # Load any app level custom rakefile extensions from lib/tasks
+  tasks_path = File.join(File.dirname(__FILE__), "lib", "tasks")
+  rake_files = Dir["#{tasks_path}/*.rake"]
+  rake_files.each{|rake_file| load rake_file }
+
+  require 'spec/rake/spectask'
+  require 'merb-core/test/tasks/spectasks'
+rescue Exception
+end
+
+# Task for loading gems needed by this template. Bootstrap to get installed...
+
+namespace :template do
+  desc 'Load missing gems to local gem repository'
+  task :gems do
+    appcfg = which_executable('appcfg.rb')
+
+    puts 'Load missing gems to local gem repository'
+    `(sudo #{appcfg} gem install appengine-apis extlib merb-core) 1>&2`
+  end
+end
+
+# Add your own tasks...
+
+namespace :merb do
+end
+

data/templates/merb/public/stylesheets/default.css

@@ -0,0 +1,55 @@
+body {
+  background: #bbbbbb;
+  color: #000000;
+  font-family: helvetica;
+  font-size: 12pt;
+}
+
+h1, h2, h3, h4, h5, h6 {
+  font-family: helvetica;
+}
+
+h1 {
+  font-size: 18pt;
+}
+
+h2 {
+  font-size: 16pt;
+}
+
+h3 {
+  font-size: 14pt;
+}
+
+h4, h5, h6 {
+  font-size: 12pt;
+}
+
+a {
+  color: inherit;
+  text-decoration: none;
+  border-bottom: 1px dotted;
+}
+
+a:hover {
+  border-bottom: 1px solid;
+}
+
+div {
+  width: 580px;
+  padding: 3px 5px;
+  text-align: left;
+}
+
+#main {
+  background: #ffffff;
+  margin-top: 50px;
+  height: auto;
+  border: 1px solid #808080;
+}
+
+#footer {
+  padding-left: 0px;
+  font-size: 9pt;
+  color: #404040;
+}

data/templates/merb/spec/spec_helper.rb

@@ -0,0 +1,24 @@
+require "rubygems"
+
+# Add the local gems dir if found within the app root; any dependencies loaded
+# hereafter will try to load from the local gems before loading system gems.
+if (local_gem_dir = File.join(File.dirname(__FILE__), '..', 'gems')) && $BUNDLE.nil?
+  $BUNDLE = true; Gem.clear_paths; Gem.path.unshift(local_gem_dir)
+end
+
+require "spec"
+require "merb-core"
+
+Merb::Config.use do |c|
+  c[:session_store] = "memory"
+end
+
+Merb.start_environment(:testing => true,
+                       :adapter => 'runner',
+                       :environment => ENV['MERB_ENV'] || 'test')
+
+Spec::Runner.configure do |config|
+  config.include(Merb::Test::ViewHelper)
+  config.include(Merb::Test::RouteHelper)
+  config.include(Merb::Test::ControllerHelper)
+end

data/templates/merb/views/index.html.erb

@@ -0,0 +1,27 @@
+<center>
+  <div id='main'>
+    <center>
+      <p>
+        <img src='/images/appengine_logo.png' />
+      </p>
+      <h1>
+        Hi folks! Nice to meet you here!
+      </h1>
+      <p>
+        This is
+        <a href='http://code.google.com/appengine'>Google AppEngine</a>
+        running the
+        <a href='http://www.merbivore.com'>Merb</a>
+        framework.
+      </p>
+      <p>
+        <img src='/images/merb_logo.png' />
+      </p>
+    </center>
+  </div>
+  <div id='footer'>
+    This tiny app was generated by
+    <a href='http://github.com/ulbrich/jruby-enginize'>JRuby-Enginize</a>
+    to streamline Google AppEngine development.
+  </div>
+</center>

data/templates/merb/views/layout.engine_app.html.erb

@@ -0,0 +1,9 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+  <head>
+    <link href='/stylesheets/default.css' rel='stylesheet' type='text/css' />
+  </head>
+  <body>
+    <%= catch_content :for_layout %>
+  </body>
+</html>

data/templates/shared/README

@@ -0,0 +1,71 @@
+README
+
+This is a generic README generated by jruby-enginize. Please replace with
+something more meaningful... ;-)
+
+INSTALL MISSING GEMS
+
+As a basic requirement, you have to install missing gems required by the
+template (this task is implemented individually for each template):
+
+  rake template:gems
+
+!!Attention: Whenever you want to install additional gems, be sure to use
+"appcfg.rb gem" provided by the Google AppEngine JRuby tools and not "jgem" as
+Google maintains a local repository per project and bundles the files to
+upload from that information. You will run into missing gems on the server if
+you bypass this!
+
+GOOGLE APPENGINE DEPLOYMENT
+
+Deploy the application with
+
+  rake appengine:deploy
+
+and open
+
+  http://{{name}}.appspot.com
+
+to have a first test.
+
+Be sure to set the version number in the AppEngine::Rack.configure_app part
+of "config.ru" to a new value, when you are experimenting with an unstable
+version and don't want to risk your users getting exceptions.
+
+You can try the new version by opening e.g.
+
+  http://3.latest.{{name}}.appspot.com
+
+and replacing "3" with the version number you want to run.
+
+Switch the application to the new version as default (stable version) by
+opening
+
+  http://appengine.google.com/deployment?&app_id={{name}}
+
+and setting a new default.
+
+SOME MORE INFO
+
+- Gems installed with "appcfg.rb gem" reside in directory ".gems". Again: Do
+  not use "jgem" at all!
+
+- Some gems will throw exceptions during bundling: Have a look for paths
+  assembled using ".." to reach the parent directory and replace with
+  File.dirname(...). Retry and be a good citizen and send in the patch the
+  developer of that gem... ;-)
+
+- Data uploaded to the server is gathered in directory "WEB-INF" as with any
+  Java project. The first time "rake appengine:run" or "rake appengine:deploy"
+  is called, this directory will be created and "jruby-rack-xx.jar" is
+  downloaded from its homepage.
+  
+  The first call to "rake appengine:run" or "rake appengine:deploy" with 
+  downloading the rack jar will fail. Just ignore and retry.
+
+- "WEB-INF/lib/gems.jar" is only created or updated after a call to
+  "appcfg.rb gem". This is enforced by "rake appengine:deploy" but not by
+  "rake appengine:update".
+
+- Sometimes the local test server keeps running after Ctrl-C, so have a look
+  at "ps" and manually kill the process if needed.

data/templates/shared/Rakefile

@@ -0,0 +1,87 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+require 'net/http'
+
+Dir[File.join(File.dirname(__FILE__), 'lib', 'tasks', '*.rake')].each do |ext|
+  load ext
+end
+
+# Helper for retrieving HTML files. Only used to check or trigger things so
+# no highclass implementation...
+
+def fetch(uri, limit = 10)
+  raise ArgumentError, 'HTTP redirect too deep' if limit == 0
+
+  response = Net::HTTP.get_response(URI.parse(uri))
+
+  case response
+  when Net::HTTPSuccess then
+    return response
+  when Net::HTTPRedirection then
+    return fetch(response['location'], limit - 1)
+  else
+    return response.error!
+  end
+end
+
+# Returns an absolute path for the requested executable. Falls back to 
+# returning only the executable if an exception is raised.
+
+def which_executable(executable)
+  begin
+    if (path = `which #{executable}`.chomp).empty?
+      $stderr.puts "!!Error: Could not find \"#{executable}\""
+      exit
+    end
+  rescue Exception
+    path = executable
+  end
+
+  return path
+end
+
+desc 'Display some help and the README'
+task :help do
+  puts 'Call "rake --tasks" to learn what tasks are available...'
+  puts
+  puts File.read('README')
+end
+
+task :default => [:help]
+
+namespace :appengine do
+  desc 'Start a local test server'
+  task :run do
+    puts 'Start a local test server'
+    `(dev_appserver.rb .) 1>&2`
+  end
+
+  desc 'Force rebuilding "WEB-INF/lib/gems.jar"'
+  task :rebuildgems do
+    puts 'Force rebuilding "WEB-INF/lib/gems.jar"'
+    `(appcfg.rb gem help install) 2> /dev/null 1>&2`
+  end
+
+  desc 'Build the application package'
+  task :bundle do
+    puts 'Build the application package.'
+    `(appcfg.rb --email={{email}} --enable_jar_splitting bundle .) 1>&2`
+  end
+
+  desc 'Upload the application code to the server'
+  task :update do
+    puts 'Upload the new application code (this may take a while).'
+    `(appcfg.rb --email={{email}} --enable_jar_splitting update .) 1>&2`
+  end
+
+  desc 'Roll back a blocked and halfway broken deploy'
+  task :rollback do
+    puts 'Roll back a blocked and halfway broken deploy.'
+    `(appcfg.rb --email={{email}} rollback .) 1>&2`
+  end
+
+  desc 'Deploy the application (build package and upload application code)'
+  task :deploy => [:rebuildgems, :bundle, :update]
+end

data/templates/shared/public/robots.txt

@@ -0,0 +1,5 @@
+# See http://www.robotstxt.org/wc/norobots.html for documentation on how to use the robots.txt file
+#
+# To ban all spiders from the entire site uncomment the next two lines:
+# User-Agent: *
+# Disallow: /

data/templates/sinatra/.gitignore

@@ -0,0 +1,14 @@
+.DS_Store
+log/*
+tmp/*
+TAGS
+*~
+.#*
+*.sqlite
+*.sqlite3
+*.db
+.hgignore
+.hg/*
+.svn/*
+gems/gems/*
+gems/specifications/*

data/templates/sinatra/app.rb

@@ -0,0 +1,51 @@
+# This application file was generated by jruby-enginize.
+
+require 'rubygems'
+
+require 'haml'
+require 'sass'
+require 'sinatra'
+
+# Use AppEngine::URLFetch.fetch() for loading remote files.
+
+require 'appengine-apis/urlfetch'
+
+# Set to true if you need sessions.
+
+set :sessions, false
+
+# Configure Sinatra to reload during development.
+
+class Sinatra::Reloader < Rack::Reloader 
+   def safe_load(file, mtime, stderr = $stderr) 
+     ::Sinatra::Application.reset!
+     stderr.puts "#{self.class}: reseting routes" 
+     super 
+   end 
+end 
+
+configure :development do
+  use Sinatra::Reloader
+end
+
+# Helpers to include...
+
+helpers do
+  include Rack::Utils
+
+  alias_method :h, :escape_html
+end
+
+# GET /
+ 
+get '/' do
+  haml :index
+end
+
+# GET /stylesheet.css
+
+get '/stylesheet.css' do
+  content_type 'text/css', :charset => 'utf-8'
+
+  sass :stylesheet
+end

data/templates/sinatra/config.ru

@@ -0,0 +1,13 @@
+require 'rubygems'
+require 'appengine-rack'
+
+require 'sinatra'
+
+AppEngine::Rack.configure_app(
+  # :ssl_enabled => true,
+  :application => '{{name}}',
+  :version => 1)
+
+require 'app'
+ 
+run Sinatra::Application

data/templates/sinatra/lib/tasks/haml-2_2_2-util.patch

@@ -0,0 +1,5 @@
+18c18
+<       File.join(File.dirname(__FILE__), '..', '..', file)
+---
+>       File.join(File.dirname(File.dirname(File.dirname(__FILE__))), file)
+

data/templates/sinatra/lib/tasks/sinatra.rake

@@ -0,0 +1,19 @@
+# Task for loading gems needed by this template. Bootstrap to get installed...
+
+namespace :template do
+  desc 'Load missing gems to local gem repository'
+  task :gems do
+    appcfg = which_executable('appcfg.rb')
+    patch = which_executable('patch')
+
+    puts 'Load missing gems to local gem repository'
+    `(sudo #{appcfg} gem install appengine-apis haml sinatra) 1>&2`
+    puts 'Add patch for Haml 2.2.2 if needed'
+    `(sudo #{patch} --batch --silent .gems/gems/haml-2.2.2/lib/haml/util.rb < lib/tasks/haml-2_2_2-util.patch) 2> /dev/null 1>&2`
+  end
+end
+
+# Add your own tasks...
+
+namespace :sinatra do
+end

data/templates/sinatra/views/index.haml

@@ -0,0 +1,19 @@
+%center
+  %div{ :id => 'main' }
+    %center
+      %p
+        %img{ :src => '/images/appengine_logo.png' }
+      %h1
+        Hi folks! Nice to meet you here!
+      %p
+        This is
+        %a{ :href => 'http://code.google.com/appengine' } Google AppEngine
+        running the
+        %a{ :href => 'http://www.sinatrarb.com' } Sinatra
+        framework.
+      %p
+        %img{ :src => '/images/sinatra_logo.png' }
+  %div{ :id => 'footer' }
+    This tiny app was generated by
+    %a{ :href => 'http://github.com/ulbrich/jruby-enginize' } JRuby-Enginize
+    to streamline Google AppEngine development.

data/templates/sinatra/views/layout.haml

@@ -0,0 +1,6 @@
+!!!
+%html
+  %head
+    %link{ :rel => 'stylesheet', :href => '/stylesheet.css', :type => 'text/css' }
+  %body
+    = yield

data/templates/sinatra/views/stylesheet.sass

@@ -0,0 +1,44 @@
+body
+  :background #bbbbbb
+  :color #000000
+  :font-family helvetica
+  :font-size 12pt
+
+h1, h2, h3, h4, h5, h6
+  :font-family helvetica
+
+h1
+  :font-size 18pt
+
+h2
+  :font-size 16pt
+
+h3
+  :font-size 14pt
+
+h4, h5, h6
+  :font-size 12pt
+
+a
+  :color inherit
+  :text-decoration none
+  :border-bottom 1px dotted
+
+a:hover
+  :border-bottom 1px solid
+
+div
+  :width 580px
+  :padding 3px 5px
+  :text-align left
+
+#main
+  :background #ffffff
+  :margin-top 50px
+  :height auto
+  :border 1px solid #808080
+
+#footer
+  :padding-left 0px
+  :font-size 9pt
+  :color #404040

metadata

@@ -0,0 +1,91 @@
+--- !ruby/object:Gem::Specification 
+name: jruby-enginize
+version: !ruby/object:Gem::Version 
+  version: "0.8"
+platform: ruby
+authors: 
+- Jan Ulbrich
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-11-04 00:00:00 +01:00
+default_executable: 
+dependencies: []
+
+description: 
+email: jan.ulbrich @nospam@ holtzbrinck.com
+executables: 
+- jruby-enginize
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- bin/jruby-enginize
+- lib/generator.rb
+- lib/script.rb
+- templates/sinatra/views/stylesheet.sass
+- templates/sinatra/views/layout.haml
+- templates/sinatra/views/index.haml
+- templates/sinatra/public/images/sinatra_logo.png
+- templates/sinatra/lib/tasks/sinatra.rake
+- templates/sinatra/lib/tasks/haml-2_2_2-util.patch
+- templates/sinatra/config.ru
+- templates/sinatra/app.rb
+- templates/sinatra/.gitignore
+- templates/shared/README
+- templates/shared/Rakefile
+- templates/shared/public/robots.txt
+- templates/shared/public/images/appengine_logo.png
+- templates/shared/public/favicon.ico
+- templates/merb/views/layout.engine_app.html.erb
+- templates/merb/views/index.html.erb
+- templates/merb/spec/spec_helper.rb
+- templates/merb/public/stylesheets/default.css
+- templates/merb/public/images/merb_logo.png
+- templates/merb/lib/tasks/merb.rake
+- templates/merb/config.ru
+- templates/merb/config/init.rb
+- templates/merb/config/framework.rb
+- templates/merb/app.rb
+- templates/merb/.gitignore
+- README.rdoc
+has_rdoc: true
+homepage: http://github.com/ulbrich/jruby-enginize
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --exclude
+- pkg
+- --exclude
+- templates
+- --all
+- --title
+- JRuby-Enginize
+- --main
+- README.rdoc
+require_paths: 
+- .
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: A package for generating Google AppEngine compliant JRuby projects.
+test_files: []
+