class Closure

Closure tools may be called directly, run as a stand-alone server, installed as middleware into a framework like Rails, or adapted to anything with a rack environment. @example config.ru

#\ -p 8080 -E none
require 'closure'
Closure.add_source :goog, '/goog'
Closure.add_source './src/myapp', '/myapp'
use Rack::ShowExceptions
use Closure::Middleware
run Rack::File.new './public'

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.

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

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

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

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

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

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

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

Constants

BUILT_INS: Scripts that are distributed with the gem. These will help get you started quickly.
VERSION

Public Class Methods

add_source(directory, path) click to toggle source

Easy config. This adds to the global instance of sources and supports using the {BUILT_INS}. @example

Closure.add_source :soy, '/soy_js'
Closure.add_source './myapp', '/myapp'

@overload add_source(directory, path) @overload add_source(built_in, path) @param (String) path http server mount point. @param (String) directory Where the scripts are in the filesystem. @param (Symbol) built_in

# File lib/closure.rb, line 58
def self.add_source(directory, path)
  if directory.kind_of? Symbol
    dir = BUILT_INS[directory]
    raise "Unknown built-in: #{directory}" unless dir
    directory = dir
  end
  raise Errno::ENOENT, File.expand_path(directory, Dir.pwd) unless File.directory? directory
  sources.add directory, path
end

base_path() click to toggle source

Filesystem location of the Closure Script install. Typically, where the gem was installed. This is mainly used internally but may be useful for experimental configurations. @return [String]

# File lib/closure.rb, line 36
def self.base_path
  @@base_path ||= File.expand_path(File.join(File.dirname(__FILE__), '..'))
end

config() click to toggle source

Set these before the rack server is called for the first time.

Attributes:¶ ↑

(String) java – default: “java” – Your Java executable. Not used under JRuby.
(String) compiler_jar – A compiler.jar to use instead of the packaged one.
(String) soy_js_jar – A SoyToJsSrcCompiler.jar to use instead of the packaged one.
(Array) engines – Add new script engines here.

@return [OpenStruct]

# File lib/closure.rb, line 123
def self.config
  return @@config if defined? @@config
  @@config = OpenStruct.new({
    :compiler_jar => File.join(base_path, 'closure-compiler', 'compiler.jar'),
    :soy_js_jar => File.join(base_path, 'closure-templates', 'SoyToJsSrcCompiler.jar'),
    :engines => {}
  })
  if !defined? JRUBY_VERSION
    @@config.java = 'java'
  end
  @@config
end

exclude(directory) click to toggle source

Easy config. Exclude a subdirectories of sources. This is typically used to exclude the build folder for whitespace builds (which contain “goog.provide”).

# File lib/closure.rb, line 72
def self.exclude(directory)
  # no check if exists, build may create later
  sources.add directory, nil
end

run_java(jar, mainClass, args) click to toggle source

Execute jar in a REPL or with JRuby @private - internal use only @param (String) jar Path to .jar file @param (String) mainClass Class with main(String[] args) @param (Array) args Arguments @return (Array)[stdout, stderr]

# File lib/closure.rb, line 93
def self.run_java(jar, mainClass, args)
  jar = File.expand_path(jar)
  cmdout = Tempfile.new 'closure_java_out'
  cmderr = Tempfile.new 'closure_java_err'
  begin
    if defined? JRUBY_VERSION
      require 'java'
      require File.join(base_path, 'lib', 'shim.jar')
      Java::ClosureScript.run(jar, mainClass, cmdout.path, cmderr.path, args)
    else
      @@beanshell ||= BeanShell.new File.join(base_path, 'lib', 'shim.jar')
      java_opts = args.collect{|a|a.to_s.dump}.join(', ')
      cmd = "ClosureScript.run(#{jar.dump}, #{mainClass.dump}, #{cmdout.path.dump}, #{cmderr.path.dump}, new String[]{#{java_opts}});"
      @@beanshell.run(cmd)
    end
  ensure
    out = cmdout.read; cmdout.close; cmdout.unlink
    err = cmderr.read; cmderr.close; cmderr.unlink
  end
  [out, err]
end

sources() click to toggle source

This is a global instance of sources, configured with Closure.add_source() and used for {Closure Script::Middleware} by default. Path and directory pairs configured with Closure.add_source(). @return [Array]

# File lib/closure.rb, line 82
def self.sources
  @@sources ||= Sources.new
end

welcome() click to toggle source

Run the welcome server. Handy for gem users. @example

ruby -e "require 'rubygems'; gem 'closure'; require 'closure'; Closure.welcome"

# File lib/closure.rb, line 139
def self.welcome
  raise 'Use rackup, config.ru already exists.' if File.exist? 'config.ru'
  gem 'rack', '>= 1.1.0'
  require 'rack'
  ENV["CLOSURE_SCRIPT_WELCOME"] = 'true'
  server = Rack::Server.new :config => File.join(base_path, 'scripts', 'config.ru')
  # Make a phony request so options[:Port] gets set from config.ru
  Rack::MockRequest.new(server.app).request
  port = server.options[:Port] || server.default_options[:Port]
  print "Closure Script Welcome Server: http://localhost:#{port}/\n"
  server.start
end