appengine-tools 0.0.1

data/LICENSE

@@ -0,0 +1,202 @@
+
+                              Apache License
+                        Version 2.0, January 2004
+                     http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+   "License" shall mean the terms and conditions for use, reproduction,
+   and distribution as defined by Sections 1 through 9 of this document.
+
+   "Licensor" shall mean the copyright owner or entity authorized by
+   the copyright owner that is granting the License.
+
+   "Legal Entity" shall mean the union of the acting entity and all
+   other entities that control, are controlled by, or are under common
+   control with that entity. For the purposes of this definition,
+   "control" means (i) the power, direct or indirect, to cause the
+   direction or management of such entity, whether by contract or
+   otherwise, or (ii) ownership of fifty percent (50%) or more of the
+   outstanding shares, or (iii) beneficial ownership of such entity.
+
+   "You" (or "Your") shall mean an individual or Legal Entity
+   exercising permissions granted by this License.
+
+   "Source" form shall mean the preferred form for making modifications,
+   including but not limited to software source code, documentation
+   source, and configuration files.
+
+   "Object" form shall mean any form resulting from mechanical
+   transformation or translation of a Source form, including but
+   not limited to compiled object code, generated documentation,
+   and conversions to other media types.
+
+   "Work" shall mean the work of authorship, whether in Source or
+   Object form, made available under the License, as indicated by a
+   copyright notice that is included in or attached to the work
+   (an example is provided in the Appendix below).
+
+   "Derivative Works" shall mean any work, whether in Source or Object
+   form, that is based on (or derived from) the Work and for which the
+   editorial revisions, annotations, elaborations, or other modifications
+   represent, as a whole, an original work of authorship. For the purposes
+   of this License, Derivative Works shall not include works that remain
+   separable from, or merely link (or bind by name) to the interfaces of,
+   the Work and Derivative Works thereof.
+
+   "Contribution" shall mean any work of authorship, including
+   the original version of the Work and any modifications or additions
+   to that Work or Derivative Works thereof, that is intentionally
+   submitted to Licensor for inclusion in the Work by the copyright owner
+   or by an individual or Legal Entity authorized to submit on behalf of
+   the copyright owner. For the purposes of this definition, "submitted"
+   means any form of electronic, verbal, or written communication sent
+   to the Licensor or its representatives, including but not limited to
+   communication on electronic mailing lists, source code control systems,
+   and issue tracking systems that are managed by, or on behalf of, the
+   Licensor for the purpose of discussing and improving the Work, but
+   excluding communication that is conspicuously marked or otherwise
+   designated in writing by the copyright owner as "Not a Contribution."
+
+   "Contributor" shall mean Licensor and any individual or Legal Entity
+   on behalf of whom a Contribution has been received by Licensor and
+   subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   copyright license to reproduce, prepare Derivative Works of,
+   publicly display, publicly perform, sublicense, and distribute the
+   Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   (except as stated in this section) patent license to make, have made,
+   use, offer to sell, sell, import, and otherwise transfer the Work,
+   where such license applies only to those patent claims licensable
+   by such Contributor that are necessarily infringed by their
+   Contribution(s) alone or by combination of their Contribution(s)
+   with the Work to which such Contribution(s) was submitted. If You
+   institute patent litigation against any entity (including a
+   cross-claim or counterclaim in a lawsuit) alleging that the Work
+   or a Contribution incorporated within the Work constitutes direct
+   or contributory patent infringement, then any patent licenses
+   granted to You under this License for that Work shall terminate
+   as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+   Work or Derivative Works thereof in any medium, with or without
+   modifications, and in Source or Object form, provided that You
+   meet the following conditions:
+
+   (a) You must give any other recipients of the Work or
+       Derivative Works a copy of this License; and
+
+   (b) You must cause any modified files to carry prominent notices
+       stating that You changed the files; and
+
+   (c) You must retain, in the Source form of any Derivative Works
+       that You distribute, all copyright, patent, trademark, and
+       attribution notices from the Source form of the Work,
+       excluding those notices that do not pertain to any part of
+       the Derivative Works; and
+
+   (d) If the Work includes a "NOTICE" text file as part of its
+       distribution, then any Derivative Works that You distribute must
+       include a readable copy of the attribution notices contained
+       within such NOTICE file, excluding those notices that do not
+       pertain to any part of the Derivative Works, in at least one
+       of the following places: within a NOTICE text file distributed
+       as part of the Derivative Works; within the Source form or
+       documentation, if provided along with the Derivative Works; or,
+       within a display generated by the Derivative Works, if and
+       wherever such third-party notices normally appear. The contents
+       of the NOTICE file are for informational purposes only and
+       do not modify the License. You may add Your own attribution
+       notices within Derivative Works that You distribute, alongside
+       or as an addendum to the NOTICE text from the Work, provided
+       that such additional attribution notices cannot be construed
+       as modifying the License.
+
+   You may add Your own copyright statement to Your modifications and
+   may provide additional or different license terms and conditions
+   for use, reproduction, or distribution of Your modifications, or
+   for any such Derivative Works as a whole, provided Your use,
+   reproduction, and distribution of the Work otherwise complies with
+   the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+   any Contribution intentionally submitted for inclusion in the Work
+   by You to the Licensor shall be under the terms and conditions of
+   this License, without any additional terms or conditions.
+   Notwithstanding the above, nothing herein shall supersede or modify
+   the terms of any separate license agreement you may have executed
+   with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+   names, trademarks, service marks, or product names of the Licensor,
+   except as required for reasonable and customary use in describing the
+   origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+   agreed to in writing, Licensor provides the Work (and each
+   Contributor provides its Contributions) on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+   implied, including, without limitation, any warranties or conditions
+   of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+   PARTICULAR PURPOSE. You are solely responsible for determining the
+   appropriateness of using or redistributing the Work and assume any
+   risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+   whether in tort (including negligence), contract, or otherwise,
+   unless required by applicable law (such as deliberate and grossly
+   negligent acts) or agreed to in writing, shall any Contributor be
+   liable to You for damages, including any direct, indirect, special,
+   incidental, or consequential damages of any character arising as a
+   result of this License or out of the use or inability to use the
+   Work (including but not limited to damages for loss of goodwill,
+   work stoppage, computer failure or malfunction, or any and all
+   other commercial damages or losses), even if such Contributor
+   has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+   the Work or Derivative Works thereof, You may choose to offer,
+   and charge a fee for, acceptance of support, warranty, indemnity,
+   or other liability obligations and/or rights consistent with this
+   License. However, in accepting such obligations, You may act only
+   on Your own behalf and on Your sole responsibility, not on behalf
+   of any other Contributor, and only if You agree to indemnify,
+   defend, and hold each Contributor harmless for any liability
+   incurred by, or claims asserted against, such Contributor by reason
+   of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+   To apply the Apache License to your work, attach the following
+   boilerplate notice, with the fields enclosed by brackets "[]"
+   replaced with your own identifying information. (Don't include
+   the brackets!)  The text should be enclosed in the appropriate
+   comment syntax for the file format. We also recommend that a
+   file or class name and description of purpose be included on the
+   same "printed page" as the copyright notice for easier
+   identification within third-party archives.
+
+Copyright [yyyy] [name of copyright owner]
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+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.

data/README.rdoc

@@ -0,0 +1,10 @@
+Generate XML files required by App Engine for JRuby from a rackup file.
+This works from standard Ruby or JRuby, but you'll need the rack gem.         
+
+Configure your app from within the 'config.ru' file:
+
+  AppEngine::Rack.app.configure( :application => 'simple', :version => 2 )
+
+Now run xmlgen.rb and and your ready to go:
+
+  jruby -rubygems -e 'require "appengine-tools/genxml"'

data/Rakefile

@@ -0,0 +1,57 @@
+require 'rubygems'
+require 'rake/gempackagetask'
+require 'rubygems/specification'
+require 'date'
+require 'spec/rake/spectask'
+
+GEM = "appengine-tools"
+GEM_VERSION = "0.0.1"
+AUTHOR = "Ryan Brown"
+EMAIL = "ribrdb@gmail.com"
+HOMEPAGE = "http://code.google.com/p/appengine-jruby"
+SUMMARY = "Tools for developing and deploying apps to Google App Engine"
+
+spec = Gem::Specification.new do |s|
+  s.name = GEM
+  s.version = GEM_VERSION
+  s.platform = Gem::Platform::RUBY
+  s.has_rdoc = true
+  s.extra_rdoc_files = ["README.rdoc", "LICENSE"]
+  s.summary = SUMMARY
+  s.description = s.summary
+  s.author = AUTHOR
+  s.email = EMAIL
+  s.homepage = HOMEPAGE
+  
+  s.require_path = 'lib'
+  s.files = %w(LICENSE README.rdoc Rakefile) + Dir.glob("{lib,spec}/**/*")
+  s.executables = [ 'appcfg.rb', 'dev_appserver.rb' ]
+  s.add_dependency('appengine-rack')
+  s.add_dependency('appengine-sdk')
+  s.add_dependency('jruby-abridged')
+end
+
+task :default => :spec
+
+desc "Run specs"
+Spec::Rake::SpecTask.new do |t|
+  t.spec_files = FileList['spec/**/*_spec.rb']
+  t.spec_opts = IO.read('spec/spec.opts').split
+end
+
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+end
+
+desc "install the gem locally"
+task :install => [:package] do
+  sh %{sudo gem install pkg/#{GEM}-#{GEM_VERSION}}
+end
+
+desc "create a gemspec file"
+task :make_spec do
+  File.open("#{GEM}.gemspec", "w") do |file|
+    file.puts spec.to_ruby
+  end
+end

data/bin/appcfg.rb

@@ -0,0 +1,18 @@
+#! /usr/bin/env ruby
+# Copyright:: Copyright 2009 Google Inc.
+# Original Author:: Ryan Brown (mailto:ribrdb@google.com)
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# 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.
+
+require 'appengine-tools/appcfg'
+AppEngine::Admin::JRubyAppCfg.main(ARGV)

data/bin/dev_appserver.rb

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby 
+# Copyright:: Copyright 2009 Google Inc.
+# Original Author:: John Woodell (mailto:woodie@google.com)
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# 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.
+
+require 'appengine-tools/dev_appserver'
+AppEngine::Development::JRubyDevAppserver.run(ARGV)

data/lib/appengine-tools/appcfg.rb

@@ -0,0 +1,216 @@
+#! /usr/bin/ruby
+# Copyright:: Copyright 2009 Google Inc.
+# Original Author:: Ryan Brown (mailto:ribrdb@google.com)
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# 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.
+
+require 'appengine-sdk'
+require 'appengine-tools/boot'
+require 'appengine-tools/bundler'
+require 'yaml'
+
+module AppEngine
+  module Admin
+    if defined? Java
+      AppCfg = AppEngine::SDK.load_appcfg
+      import Java.ComGoogleAppengineToolsAdmin.AppAdminFactory 
+      import Java.ComGoogleAppengineToolsAdmin.AppVersionUpload
+      import Java.ComGoogleAppengineToolsUtil.Logging
+    
+      class JRubyAppVersionUpload < AppVersionUpload
+        def initialize(connection, app)
+          @connection = connection
+          @app = app
+          super(connection, app)
+        end
+      
+        def getIndexYaml
+          indexes = merge_indexes
+          if indexes
+            return indexes.to_yaml
+          end
+          nil
+        end
+      
+        def getCronYaml
+          cron = File.join(app.path, 'cron.yaml')
+          if File.exists?(cron)
+            return cron.to_yaml
+          end
+          nil
+        end
+      
+        def merge_indexes
+          if @app.indexes_xml
+            indexes = YAML.load(@app.indexes_xml.to_yaml)['indexes']
+          end
+          indexes ||= []
+          index_yaml = File.join(@app.path, 'index.yaml')
+          if File.exist?(index_yaml)
+            manual_indexes = YAML.load_file(index_yaml)['indexes'] || []
+            manual_indexes.each do |index|
+              indexes << index unless indexes.include?(index)
+            end
+          end
+          if indexes.size > 0
+            {'indexes' => indexes}
+          else
+            nil
+          end
+        end
+      end
+    end
+    
+    class JRubyAppCfg
+      NO_XML_COMMANDS = [ 'version' ]
+      RUBY_COMMANDS = ['bundle', 'gem', 'help', 'run']
+      COMMAND_SUMMARY = <<EOF
+  run: run jruby in your application environment.
+  gem: run rubygems for your application.
+  bundle: package your application for deployment.
+The 'gem' and 'run' commands assume the app directory is the current directory.
+EOF
+      class << self
+        def main(args)
+          command, parsed_args = parse_args(args)
+          if RUBY_COMMANDS.include? command
+            send(command, *parsed_args)
+            return
+          end
+          if command && ! NO_XML_COMMANDS.include?(command)
+            AppEngine::Admin.bundle_app(parsed_args[0])
+          end
+          if !RUBY_COMMANDS.include?(command)
+            puts "running AppCfg"
+            run_appcfg(args)
+          end
+        end
+        
+        def run_appcfg(args)
+          factory = AppAdminFactory.new
+          factory.setAppVersionUploadClass(JRubyAppVersionUpload)
+          Logging.initializeLogging
+          AppCfg.new(factory, args.to_java(java.lang.String))
+        end
+        
+        def bundle(path)
+          AppEngine::Admin.bundle_app(path)
+        end
+        
+        def bundle_help
+          help = <<EOF
+#{$0} bundle app_dir
+
+Generates files necessary to run an application as a Java Servlet.
+This is run automatically when necessary, so you should not
+need to run it manually.
+
+EOF
+        end
+        
+        def gem(*args)
+          AppEngine::Development.boot_jruby
+          require 'rubygems'
+          require 'rubygems/command_manager'
+          Gem.configuration = Gem::ConfigFile.new(args)
+          Gem.use_paths('.gems')
+          Gem::Command.add_specific_extra_args(
+              'install', %w(--no-rdoc --no-ri))
+          begin
+            Gem::CommandManager.instance.run(Gem.configuration.args)
+          rescue Gem::SystemExitException => e
+            exit e.exit_code unless e.exit_code == 0
+          end
+          unless Dir.glob('.gems/specifications/*.gemspec').empty?
+            Dir.mkdir 'WEB-INF' unless File.exists? 'WEB-INF'
+            Dir.mkdir 'WEB-INF/lib' unless File.exists? 'WEB-INF/lib'
+            Dir.chdir '.gems'
+            command = %w(jar cf ../WEB-INF/lib/gems.jar gems specifications)
+            if !system(*command)
+              puts 'Error running jar command.'
+              exit $?
+            end
+          end
+        end
+        
+        def gem_help
+          help = <<EOF
+#{$0} gem [rubygems arguments]
+
+
+Configures rubygems for this application and bundles the gems into a .jar file.
+Must be run from the application directory.
+
+EOF
+        end
+        
+        def run(*args)
+          AppEngine::Development.boot_app('.', args)
+        end
+        
+        def run_help
+          help = <<EOF
+#{$0} run [ruby args]
+
+
+Starts the jruby interpreter within your application's environment.
+Use `#{$0} run -S command` to run a command such as rake or irb.
+Must be run from the application directory, after running bundle.
+
+EOF
+        end
+
+        def help(command=nil)
+          puts
+          if command != 'help' && RUBY_COMMANDS.include?(command)
+            puts send("#{command}_help")
+          else
+            java_args = %W(java -cp #{AppEngine::SDK::TOOLS_JAR})
+            java_args << 'com.google.appengine.tools.admin.AppCfg'
+            java_args << 'help'
+            java_args << command if command
+            print_help(%x{#{java_args.map{|x| x.inspect}.join(' ')}}, !command)
+          end
+        end
+        
+        def print_help(help, summary)
+          help.gsub!('AppCfg', $0)
+          count = 0
+          help.each_line do |line|
+            line.chomp!
+            if summary && line.size > 0 && line.lstrip == line
+              count += 1
+              print COMMAND_SUMMARY if count == 3
+            end
+            puts line
+          end
+        end
+
+        def parse_args(args)
+          if RUBY_COMMANDS.include?(args[0])
+            return [args[0], args[1, args.length]]
+          elsif args.empty? || !(%w(-h --help) & args).empty?
+            return ['help', []]
+          elsif args[-3] == 'request_logs'
+            command = args[-3]
+            path = args[-2]
+          else
+            command = args[-2]
+            path = args[-1]
+          end
+          return [command, [path]]
+        end
+      end
+    end
+  end
+end

data/lib/appengine-tools/boot.rb

@@ -0,0 +1,63 @@
+#! /usr/bin/ruby
+# Copyright:: Copyright 2009 Google Inc.
+# Original Author:: Ryan Brown (mailto:ribrdb@google.com)
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# 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.
+
+require 'appengine-sdk'
+
+module AppEngine
+  module Development
+    
+    class << self
+      def boot_jruby(root=nil)
+        unless defined?(JRUBY_VERSION)
+          require 'rubygems'
+          require 'jruby-abridged'
+
+          jars = [
+            JRubyAbridged.jruby_jar,
+            JRubyAbridged.rubygems_jar,
+            AppEngine::SDK::TOOLS_JAR,
+            ]
+
+          ENV['GEM_HOME'] = Gem.dir
+          exec_jruby(root, jars, [$0] + ARGV)
+        end
+      end
+    
+      def boot_app(root, args)
+        root = File.expand_path(root)
+
+        jars = AppEngine::SDK::RUNTIME_JARS
+
+        jruby_args = %w(-rappengine_boot) + args
+
+        ENV['APPLICATION_ROOT'] = root
+        ENV.delete 'GEM_HOME'
+        exec_jruby(root, jars, jruby_args)
+      end
+      
+      def exec_jruby(root, jars, args)
+        app_jars = root ? Dir.glob("#{root}/WEB-INF/lib/*.jar") : []
+        classpath = (app_jars + jars).join(File::PATH_SEPARATOR)
+        utf = "-Dfile.encoding=UTF-8"
+        java_command = %W(java #{utf} -cp #{classpath} org.jruby.Main) + args
+        if ENV['VERBOSE']
+          puts java_command.map {|a| a.inspect}.join(' ')
+        end
+        exec *java_command
+      end
+    end
+  end
+end

data/lib/appengine-tools/bundler.rb

@@ -0,0 +1,196 @@
+#!/usr/bin/ruby1.8 -w
+#
+# Copyright:: Copyright 2009 Google Inc.
+# Original Author:: Ryan Brown (mailto:ribrdb@google.com)
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# 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.
+
+require 'appengine-rack'
+require 'appengine-tools/web-xml'
+require 'appengine-tools/xml-formatter'
+
+module AppEngine
+  module Admin
+
+    class Application
+      attr_reader :root
+      
+      def initialize(root)
+        @root = root
+      end
+
+      def path(*pieces)
+        File.join(@root, *pieces)
+      end
+      
+      def webinf
+        path('WEB-INF')
+      end
+      
+      def webinf_lib
+        path('WEB-INF', 'lib')
+      end
+      
+      def config_ru
+        path('config.ru')
+      end
+      
+      def web_xml
+        path('WEB-INF', 'web.xml')
+      end
+      
+      def aeweb_xml
+        path('WEB-INF', 'appengine-web.xml')
+      end
+      
+      def public_root
+        path(AppEngine::Rack.app.public_root) if AppEngine::Rack.app.public_root
+      end
+      
+      def rack_app
+        AppEngine::Rack.app
+      end
+      
+    end
+    
+    class AppBundler
+      EXISTING_JRUBY = /^jruby(?!-rack).*jar$/
+      EXISTING_RACK = /jruby-rack.*jar$/
+      EXISTING_APIS = /^appengine-api.*jar$/
+      JRUBY_RACK = 'jruby-rack-0.9.4.jar'
+      JRUBY_RACK_URL = 'http://kenai.com/projects/jruby-rack/downloads/' +
+                       'download/' + JRUBY_RACK
+      RACKUP = %q{Dir.chdir('..') if Dir.pwd =~ /WEB-INF$/;} +
+        %q{eval IO.read('config.ru'), nil, 'config.ru', 1}
+      
+      def initialize(root_path)
+        @app = Application.new(root_path)
+      end
+      
+      def bundle
+        create_webinf
+        create_public
+        copy_jruby
+        copy_rack
+        copy_sdk
+        convert_config_ru
+      end
+      
+      def app
+        @app
+      end
+      
+      def create_webinf
+        Dir.mkdir(app.webinf) unless File.exists?(app.webinf)
+        Dir.mkdir(app.webinf_lib) unless File.exists?(app.webinf_lib)
+      end
+      
+      def create_public
+        path = app.public_root
+        if path && !File.exists?(path)
+          Dir.mkdir(path)
+        end
+      end
+      
+      def convert_config_ru
+        AppEngine::Development.boot_jruby(app.root)
+        if !File.exists?(app.config_ru)
+          if File.exists?(app.web_xml)
+            unless File.exists?(app.aeweb_xml)
+              puts "Error: you either need a #{app.config_ru} or "
+              puts "      #{app.aeweb_xml}."
+              exit 1
+            end
+          else
+            # TODO auto generate a config.ru
+            puts "Error: you need to create #{app.config_ru}."
+            exit 1
+          end
+        else
+          generate_xml
+        end
+      end
+      
+      def copy_jruby
+        current_jruby = find_jars(EXISTING_JRUBY)
+        if current_jruby.empty?
+          require 'jruby-abridged'
+          FileUtils.cp([JRubyAbridged.jruby_jar, JRubyAbridged.rubygems_jar],
+                       app.webinf_lib)
+        end
+        # TODO else warn if out of date
+      end
+      
+      def copy_rack
+        current_rack = find_jars(EXISTING_RACK)
+        if current_rack.empty?
+          # TODO cache this somewhere
+          require 'open-uri'
+          puts 'Downloading jruby-rack...'
+          open(JRUBY_RACK_URL) do |src|
+            open(File.join(app.webinf_lib, JRUBY_RACK), 'wb') do |dest|
+              dest.write(src.read)
+            end
+          end
+        end
+      end
+      
+      def copy_sdk
+        current_apis = find_jars(EXISTING_APIS)
+        if current_apis.empty?
+          require 'appengine-sdk'
+          jars = Dir.glob(
+              "#{AppEngine::SDK::SDK_ROOT}/lib/user/appengine-api*.jar")
+          # TODO if there's more than 1 we need to check the api version.
+          FileUtils.cp(jars[0], app.webinf_lib)
+        end
+      end
+      
+      private
+      
+      def find_jars(regex)
+        Dir.entries(app.webinf_lib).grep(regex) rescue []
+      end
+      
+      def generate_xml
+        Dir.glob("#{app.webinf_lib}/*.jar").each do |path|
+          $: << path
+        end
+        app_root = app.root
+        builder = WebXmlBuilder.new do
+          # First configure the basic jruby-rack settings.
+          add_jruby_rack_defaults(RACKUP)
+
+          # Now read the user's rackup file
+          # TODO generate a skeleton if it's missing
+          Dir.chdir(app_root) do
+            eval IO.read('config.ru'), nil, 'config.ru', 1
+          end
+        end
+        open(app.web_xml, 'w') do |webxml|
+          xml = AppEngine::Rack::XmlFormatter.format(builder.to_xml)
+          webxml.write(xml)
+        end
+        open(app.aeweb_xml, 'w') do |aeweb|
+          xml = AppEngine::Rack::XmlFormatter.format(app.rack_app.to_xml)
+          aeweb.write(xml)
+        end
+      end
+    end
+
+    def self.bundle_app(root_path)
+      AppBundler.new(root_path).bundle
+    end
+
+  end
+end

data/lib/appengine-tools/dev_appserver.rb

@@ -0,0 +1,62 @@
+#!/usr/bin/ruby
+# Copyright:: Copyright 2009 Google Inc.
+# Original Author:: John Woodell (mailto:woodie@google.com)
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# 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.
+
+require 'appengine-sdk'
+require 'appengine-tools/boot'
+require 'appengine-tools/bundler'
+
+module AppEngine
+  module Development
+    DEV_APPSERVER = 'com.google.appengine.tools.development.DevAppServerMain'
+    class JRubyDevAppserver
+      class << self
+        def run(args)
+          path = args[-1] || '.'
+          if args.length > 0 and File::directory?(args[-1])
+            unless ENV['BOOTING_DEVAPPSERVER']
+              puts  "=> Booting DevAppServer"
+              puts  "=> Press Ctrl-C to shutdown server"
+              print "=> "
+              $stdout.flush
+              ENV['BOOTING_DEVAPPSERVER'] = 'true'
+            end
+            AppEngine::Admin.bundle_app(path)
+          end
+          AppEngine::Development.boot_jruby
+          args.unshift(DEV_APPSERVER)
+          jruby_home = get_jruby_home(args[-1])
+          if jruby_home
+            args.unshift("--jvm_flag=-Djruby.home=#{jruby_home}")
+          end
+          AppEngine::SDK.load_kickstart.main(args.to_java(:string))
+        end
+        
+        def get_jruby_home(path)
+          return unless path
+          Dir.chdir("#{path}/WEB-INF/lib") do
+            jars = Dir.glob("jruby-abridged-*.jar").grep(
+                /^jruby-abridged-\d+[.]\d+[.]\d+[.]jar$/)
+            if !jars.empty?
+              jar = File.expand_path(jars[0])
+              return "file:/#{jar}!/META-INF/jruby.home"
+            end
+          end
+          return nil
+        end
+      end
+    end
+  end
+end

data/lib/appengine-tools/web-xml.rb

@@ -0,0 +1,86 @@
+#!/usr/bin/ruby1.8 -w
+#
+# Copyright:: Copyright 2009 Google Inc.
+# Original Author:: Ryan Brown (mailto:ribrdb@google.com)
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# 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.
+
+require 'rack'
+require 'rexml/document'
+require 'uri'
+
+require 'appengine-rack/java'
+
+class WebXmlBuilder < Rack::Builder
+  DUMMY_APP = Proc.new{|env|}
+  
+  def initialize(&block)
+    @path = "/"
+    @paths = Hash.new {|h, k| h[k] = []}
+    instance_eval(&block) if block_given?
+  end
+  
+  def add_jruby_rack_defaults(rackup)
+    use JavaContextParams, :rackup => rackup
+
+    run JavaServlet.new('org.jruby.rack.RackServlet')
+    use JavaContextListener, 'org.jruby.rack.RackServletContextListener'
+  end
+  
+  def use(middleware, *args, &block)
+    if middleware.respond_to? :append_xml
+      @paths[@path] << [middleware, args, block]
+    else
+      @paths[@path] << [middleware.new(DUMMY_APP, *args, &block)]
+    end
+  end
+  
+  def map(path, &block)
+    if URI.parse(path).scheme.nil?  # we can only natively support path matching
+      saved_path = @path
+      @path = [@path, path].join('/').squeeze('/')
+      begin
+        instance_eval(&block) if block_given?
+      ensure
+        @path = saved_path
+      end
+    end
+  end
+  
+  def run(app)
+    @paths[@path] << [app, [], nil]
+  end
+
+  def to_xml
+    doc = REXML::Document.new.add_element('web-app')
+    doc.add_attribute("xmlns", "http://java.sun.com/xml/ns/javaee")
+    doc.add_attribute("version", "2.5")
+    each_path do |path, objects|
+      pattern = path.chomp('/')
+      pattern = '/' if pattern.empty?
+      objects.each do |object, args, block|
+        if object.respond_to? :append_xml
+          object.append_xml(doc, pattern, *args, &block)
+        end
+      end
+    end
+    doc
+  end
+  
+  private
+  def each_path
+    @paths.sort {|a, b| b[0].length - a[0].length}.each do |path, value|
+      yield path, value
+    end
+  end
+end

data/lib/appengine-tools/xml-formatter.rb

@@ -0,0 +1,40 @@
+#!/usr/bin/ruby1.8 -w
+#
+# Copyright:: Copyright 2009 Google Inc.
+# Original Author:: Ryan Brown (mailto:ribrdb@google.com)
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# 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.
+
+require 'rexml/formatters/pretty'
+
+module AppEngine
+  module Rack
+    class XmlFormatter < REXML::Formatters::Pretty
+      def initialize
+        @compact = true
+        super
+      end
+  
+      def write_text( node, output )
+        output << node.to_s()
+      end
+  
+      def self.format(xml)
+        @formatter ||= XmlFormatter.new
+        output = ''
+        @formatter.write(xml, output)
+        return output
+      end
+    end
+  end
+end

data/spec/appengine-web.xml

@@ -0,0 +1,12 @@
+<appengine-web-app xmlns='http://appengine.google.com/ns/1.0'>
+  <application>tools-test</application>
+  <version>foo</version>
+  <public-root>/public</public-root>
+  <static-files/>
+  <resource-files/>
+  <system-properties>
+    <property name='os.arch' value=''/>
+    <property name='jruby.management.enabled' value='false'/>
+  </system-properties>
+  <ssl-enabled>true</ssl-enabled>
+</appengine-web-app>

data/spec/config.ru

@@ -0,0 +1,33 @@
+require 'appengine-rack'
+
+AppEngine::Rack.configure_app(
+  :application => 'tools-test', :version => 'foo', :ssl_enabled => true)
+
+ruby_app = lambda {|env| [200, {}, "Hello Rack!"]}
+
+map '/admin' do
+  use JavaServletFilter, 'com.example.AdminFilter', :wildcard => true
+  run JavaServlet.new('com.example.AdminServlet', :wildcard => true)
+end
+
+map '/store' do
+  use JavaServletFilter, 'com.example.StoreFilter', :name => 'StoreFilter'
+  run JavaServlet.new('com.example.StoreServlet', :name => 'store')
+end
+
+map '/admin2' do
+  use AppEngine::Rack::AdminRequired
+  run ruby_app
+end
+
+map '/private' do
+  use AppEngine::Rack::LoginRequired
+  run ruby_app
+end
+
+map '/secure' do
+  use AppEngine::Rack::SSLRequired
+  run ruby_app
+end
+
+run ruby_app

data/spec/rack_spec.rb

@@ -0,0 +1,31 @@
+# Copyright:: Copyright 2009 Google Inc.
+# Original Author:: Ryan Brown (mailto:ribrdb@google.com)
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# 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.
+
+require File.dirname(__FILE__) + '/spec_helper.rb'
+require 'appengine-rack'
+require 'appengine-tools/web-xml'
+require 'appengine-tools/xml-formatter'
+
+describe AppEngine::Rack do
+  it "should generate correct xml" do
+    rackup = IO.read("#{File.dirname(__FILE__)}/config.ru")
+    builder = WebXmlBuilder.new do
+      add_jruby_rack_defaults('rackup')
+      eval rackup, nil, "#{File.dirname(__FILE__)}/config.ru", 1
+    end
+    xml = AppEngine::Rack::XmlFormatter.format(AppEngine::Rack.app.to_xml)
+    xml.should == IO.read("#{File.dirname(__FILE__)}/appengine-web.xml")
+  end
+end

data/spec/spec.opts

@@ -0,0 +1 @@
+--colour --diff

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+$:.unshift(File.dirname(__FILE__) + '/../lib')

data/spec/web-xml_spec.rb

@@ -0,0 +1,30 @@
+# Copyright:: Copyright 2009 Google Inc.
+# Original Author:: Ryan Brown (mailto:ribrdb@google.com)
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# 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.
+
+require File.dirname(__FILE__) + '/spec_helper.rb'
+require 'appengine-tools/web-xml'
+require 'appengine-tools/xml-formatter'
+
+describe WebXmlBuilder do
+  it "should generate correct xml" do
+    rackup = IO.read("#{File.dirname(__FILE__)}/config.ru")
+    builder = WebXmlBuilder.new do
+      add_jruby_rack_defaults('rackup')
+      eval rackup, nil, "#{File.dirname(__FILE__)}/config.ru", 1
+    end
+    xml = AppEngine::Rack::XmlFormatter.format(builder.to_xml)
+    xml.should == IO.read("#{File.dirname(__FILE__)}/web.xml")
+  end
+end

data/spec/web.xml

@@ -0,0 +1,81 @@
+<web-app version='2.5' xmlns='http://java.sun.com/xml/ns/javaee'>
+  <security-constraint>
+    <web-resource-collection>
+      <url-pattern>/private/*</url-pattern>
+    </web-resource-collection>
+    <auth-constraint>
+      <role-name>*</role-name>
+    </auth-constraint>
+  </security-constraint>
+  <security-constraint>
+    <web-resource-collection>
+      <url-pattern>/admin2/*</url-pattern>
+    </web-resource-collection>
+    <auth-constraint>
+      <role-name>admin</role-name>
+    </auth-constraint>
+  </security-constraint>
+  <security-constraint>
+    <web-resource-collection>
+      <url-pattern>/secure/*</url-pattern>
+    </web-resource-collection>
+    <user-data-constraint>
+      <transport-guarantee>CONFIDENTIAL</transport-guarantee>
+    </user-data-constraint>
+  </security-constraint>
+  <filter>
+    <filter-name>StoreFilter</filter-name>
+    <filter-class>com.example.StoreFilter</filter-class>
+  </filter>
+  <filter-mapping>
+    <filter-name>StoreFilter</filter-name>
+    <url-pattern>/store</url-pattern>
+  </filter-mapping>
+  <servlet>
+    <servlet-name>store</servlet-name>
+    <servlet-class>com.example.StoreServlet</servlet-class>
+  </servlet>
+  <servlet-mapping>
+    <servlet-name>store</servlet-name>
+    <url-pattern>/store</url-pattern>
+  </servlet-mapping>
+  <filter>
+    <filter-name>com.example.AdminFilter</filter-name>
+    <filter-class>com.example.AdminFilter</filter-class>
+  </filter>
+  <filter-mapping>
+    <filter-name>com.example.AdminFilter</filter-name>
+    <url-pattern>/admin</url-pattern>
+  </filter-mapping>
+  <filter-mapping>
+    <filter-name>com.example.AdminFilter</filter-name>
+    <url-pattern>/admin/*</url-pattern>
+  </filter-mapping>
+  <servlet>
+    <servlet-name>com.example.AdminServlet</servlet-name>
+    <servlet-class>com.example.AdminServlet</servlet-class>
+  </servlet>
+  <servlet-mapping>
+    <servlet-name>com.example.AdminServlet</servlet-name>
+    <url-pattern>/admin</url-pattern>
+  </servlet-mapping>
+  <servlet-mapping>
+    <servlet-name>com.example.AdminServlet</servlet-name>
+    <url-pattern>/admin/*</url-pattern>
+  </servlet-mapping>
+  <context-param>
+    <param-name>rackup</param-name>
+    <param-value>rackup</param-value>
+  </context-param>
+  <servlet>
+    <servlet-name>org.jruby.rack.RackServlet</servlet-name>
+    <servlet-class>org.jruby.rack.RackServlet</servlet-class>
+  </servlet>
+  <servlet-mapping>
+    <servlet-name>org.jruby.rack.RackServlet</servlet-name>
+    <url-pattern>/</url-pattern>
+  </servlet-mapping>
+  <listener>
+    <listener-class>org.jruby.rack.RackServletContextListener</listener-class>
+  </listener>
+</web-app>

metadata

@@ -0,0 +1,101 @@
+--- !ruby/object:Gem::Specification 
+name: appengine-tools
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Ryan Brown
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-07-30 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: appengine-rack
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: appengine-sdk
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: jruby-abridged
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: Tools for developing and deploying apps to Google App Engine
+email: ribrdb@gmail.com
+executables: 
+- appcfg.rb
+- dev_appserver.rb
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+- LICENSE
+files: 
+- LICENSE
+- README.rdoc
+- Rakefile
+- lib/appengine-tools/appcfg.rb
+- lib/appengine-tools/boot.rb
+- lib/appengine-tools/bundler.rb
+- lib/appengine-tools/dev_appserver.rb
+- lib/appengine-tools/web-xml.rb
+- lib/appengine-tools/xml-formatter.rb
+- spec/appengine-web.xml
+- spec/config.ru
+- spec/rack_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- spec/web-xml_spec.rb
+- spec/web.xml
+has_rdoc: true
+homepage: http://code.google.com/p/appengine-jruby
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+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: Tools for developing and deploying apps to Google App Engine
+test_files: []
+