jax 1.1.1 → 2.0.0

data/spec/lib/jax/commands/plugin_manager/credentials_spec.rb

@@ -0,0 +1,56 @@
+require 'spec_helper'
+require 'generators/jax/all'
+
+describe Jax::Plugin::Credentials do
+  def shell
+    @shell ||= GenSpec::Shell.new
+  end
+  
+  subject do
+    Jax::Plugin::Credentials.new :home => local("."), :shell => shell
+  end
+  
+  it "with new account" do
+    shell.input.stub!(:gets).and_return 'missing@gmail.com', 'password', 'password'
+    subject.api_key.should == "WXTzIXC2ODdbLAyvVL9p"
+  end
+  
+  context "with missing config file and valid existing credentials" do
+    before :each do
+      shell.input.stub!(:gets).and_return 'sinisterchipmunk@gmail.com', 'password'
+    end
+    
+    it "should return api key" do
+      subject.api_key.should == "WXTzIXC2ODdbLAyvVL9p"
+    end
+    
+    it "should create config file" do
+      subject.api_key
+      File.should exist(local "./.jax")
+    end
+  end
+  
+  it "with missing config file and invalid credentials for an existing account" do
+    shell.input.stub!(:gets).and_return 'missing@gmail.com', 'invalid'
+    proc { subject.api_key }.should raise_error(RuntimeError)
+  end
+  
+  it "with missing api key" do
+    shell.input.stub!(:gets).and_return 'missing@gmail.com', 'password', 'password'
+    subject.api_key
+    shell.output.string.should =~ /email/i
+  end
+  
+  it "with api key" do
+    create_file(".jax") { |f| f.print 'api_key: "1234"' }
+    subject.api_key.should == "1234"
+  end
+  
+  it "default home" do
+    Jax::Plugin::Credentials.new.home.should == Thor::Util.user_home
+  end
+  
+  it "override home" do
+    Jax::Plugin::Credentials.new(:home => ".").home.should == File.expand_path(".")
+  end
+end

data/spec/lib/jax/commands/plugin_manager/push_spec.rb

@@ -0,0 +1,62 @@
+require 'spec_helper'
+
+describe Jax::PluginManager do
+  def shell
+    @shell ||= GenSpec::Shell.new
+  end
+  
+  def input(str)
+    shell.new shell.output, str
+  end
+  
+  def destination_root
+    @destination_root ||= ::Rails.application.root.to_s
+  end
+
+  def generate(*args)
+    Jax::PluginManager.start args, :shell => shell, :destination_root => destination_root
+    shell.output.string.tap { shell.new }
+  end
+  
+  def generate_plugin(name)
+    Jax::Generators::PluginGenerator.start([name], :shell => shell, :destination_root => ::Rails.application.root)
+    shell.new
+    @destination_root = ::Rails.application.root.join('vendor/plugins', name).to_s
+    Jax::Plugin::Manifest.new(name)
+  end
+  
+  it "push plugin with edited manifest" do
+    manifest = generate_plugin 'cloud'
+    manifest.description = "a cloudy day"
+    manifest.save
+  
+    # how to test success? A file has been uploaded. For now we'll just verify nothing raised...
+    input "sinisterchipmunk@gmail.com\npassword\n"
+    proc { generate 'push' }.should_not raise_error
+  end
+
+  it "push plugin with default manifest" do
+    generate_plugin 'cloud'
+    result = generate "push"
+    result.should =~ /enter a plugin description/
+  end
+
+  it "push plugin without manifest" do
+    generate_plugin 'cloud'
+    manifest = local "vendor/plugins/cloud/manifest.yml"
+    FileUtils.rm manifest if File.file?(manifest)
+
+    result = generate "push"
+
+    result.should =~ /manifest is missing/i
+    result.should =~ /create/
+    File.should be_file(manifest)
+  end
+
+  it "push plugin outside plugin dir" do
+    generate_plugin 'cloud'
+    @destination_root = local(".")
+    result = generate "push"
+    result.should =~ /aborted/i
+  end
+end

data/spec/lib/jax/commands/plugin_manager_spec.rb

@@ -0,0 +1,204 @@
+require 'spec_helper'
+
+describe Jax::PluginManager do
+  def shell
+    @shell ||= GenSpec::Shell.new
+  end
+  
+  def input(str)
+    shell.new shell.output, str
+  end
+
+  def generate(*args)
+    Jax::PluginManager.start args, :shell => shell, :destination_root => ::Rails.application.root
+    shell.output.string.tap { shell.new }
+  end
+  
+  it "uninstall plugin with install.rb and uninstall.rb calls uninstall.rb but not install.rb" do
+    $install_loaded = $uninstall_loaded = 0
+    create_file "vendor/plugins/clouds/install.rb", "$install_loaded = 1"
+    create_file "vendor/plugins/clouds/uninstall.rb", "$uninstall_loaded = 1"
+    
+    generate "uninstall", "clouds"
+    $install_loaded.should == 0
+    $uninstall_loaded.should == 1
+  end
+  
+  it "uninstall missing plugin" do
+    result = generate "uninstall", "clouds"
+    
+    result.should =~ /aborted/
+    result.should =~ /Plugin 'clouds' does not seem to be installed./
+  end
+
+  it "uninstall previously installed with inexact multiple matches, selecting all" do
+    generate 'install', 'clouds'
+    generate 'install', 'vertex-height-map'
+    generate 'install', 'vertex-blob'
+    
+    input "0\n"
+    generate "uninstall", "vertex"
+    
+    File.should_not be_directory(local "vendor/plugins/vertex-height-map")
+    File.should_not be_directory(local "vendor/plugins/vertex-blob")
+    File.should be_directory(local "vendor/plugins/clouds") # because it doesn't match 'vertex*'
+  end
+
+  it "uninstall previously installed with inexact multiple matches, selecting one" do
+    generate 'install', 'clouds'
+    generate 'install', 'vertex-height-map'
+    generate 'install', 'vertex-blob'
+    
+    input "2\n"
+    generate "uninstall", "vertex"
+    
+    File.should_not be_directory(local "vendor/plugins/vertex-height-map")
+    File.should be_directory(local "vendor/plugins/vertex-blob")
+    File.should be_directory(local "vendor/plugins/clouds")
+  end
+  
+  it "uninstall previously installed with inexact single match aborted" do
+    generate 'install', 'clouds'
+    generate 'install', 'vertex-height-map'
+    generate 'install', 'vertex-blob'
+    
+    input "n\n"
+    generate "uninstall", "cloud"
+    
+    File.should be_directory(local "vendor/plugins/clouds")
+  end
+  
+  it "uninstall previously installed with inexact single match confirmed" do
+    generate 'install', 'clouds'
+    generate 'install', 'vertex-height-map'
+    generate 'install', 'vertex-blob'
+    
+    input "y\n"
+    generate "uninstall", "cloud"
+    
+    File.should_not be_directory(local "vendor/plugins/clouds")
+  end
+      
+  it "uninstall exact match" do
+    generate 'install', 'clouds'
+    generate 'install', 'vertex-height-map'
+    generate 'install', 'vertex-blob'
+    generate "uninstall", "clouds"
+  
+    File.should be_directory(local "vendor/plugins/vertex-height-map")
+    File.should be_directory(local "vendor/plugins/vertex-blob")
+    File.should_not be_directory(local "vendor/plugins/clouds")
+  end
+  
+  it "install with install.rb and uninstall.rb" do
+    $install_loaded = $uninstall_loaded = 0
+    generate "install", "clouds"
+    
+    $install_loaded.should == 1
+    $uninstall_loaded.should == 0
+  end
+  
+  it 'install with default multiple matches' do
+    input "2"
+    generate "install", "vert"
+    
+    File.should_not be_directory(local "vendor/plugins/vertex-height-map")
+    File.should be_directory(local "vendor/plugins/vertex-blob")
+  end
+    
+  it 'install with default single inexact match confirmed' do
+    input "y\n"
+    generate "install", "cloud"
+
+    File.should be_directory(local "vendor/plugins/clouds")
+  end
+    
+  it 'install with default single inexact match aborted' do
+    input "n\n"
+    generate 'install', 'cloud'
+    
+    File.should_not be_directory(local "vendor/plugins/clouds")
+  end
+  
+  it "install with default exact match" do
+    result = generate 'install', 'clouds'
+  
+    File.should be_directory(local "vendor/plugins/clouds")
+    result.should =~ /1\.0\.2/
+  end
+  
+  it "install with old version exact match" do
+    result = generate 'install', 'clouds', '--version=1.0.0'
+  
+    File.should be_directory(local "vendor/plugins/clouds")
+    result.should =~ /1\.0\.0/
+  end
+
+  it "install with old version shorthand exact match" do
+    result = generate 'install', 'clouds', '-v=1.0.0'
+  
+    File.should be_directory(local "vendor/plugins/clouds")
+    result.should =~ /1\.0\.0/
+  end
+
+  it 'list local only with plugins installed with a filter' do
+    generate 'install', 'vertex-blob', 'vertex-height-map'
+    result = generate 'list', 'vertex-b', '--local'
+  
+    result.should =~ /vertex-blob/
+    result.should =~ /#{Regexp::escape 'Adds a shader that deforms meshes, producing "blobs".'}/
+    result.should_not =~ /vertex-height-map/
+    result.should_not =~ /#{Regexp::escape 'Adds a height map generated dynamically in the vertex sha'}/
+  end
+
+  it 'list local only with plugins installed' do
+    generate 'install', 'vertex-blob', 'vertex-height-map'
+    result = generate 'list', '--local'
+  
+    result.should =~ /vertex-blob/
+    result.should =~ /#{Regexp::escape 'Adds a shader that deforms meshes, producing "blobs".'}/
+    result.should =~ /vertex-height-map/
+    result.should =~ /#{Regexp::escape 'Adds a height map generated dynamically in the vertex sha'}/
+    result.should_not =~ /clouds/
+    result.should_not =~ /#{Regexp::escape 'Adds a shader for dynamic cloud generation.'}/
+  end
+
+  it "list local only with no plugins installed" do
+    result = generate "list", "--local"
+  
+    result.should =~ /There do not seem to be any plugins installed for this application./
+  end
+
+  it "list summary" do  
+    result = generate 'list'
+
+    result.should =~ /Adds a height map generated dynamically in the vertex sha\.\.\./
+  end
+  
+  it 'list detail' do
+    result = generate 'list', '--detailed'
+    
+    result.should =~ /Adds a height map generated dynamically in the vertex shader using Perlin noise\./
+  end
+
+  it 'list (all)' do
+    result = generate 'list'  
+  
+    result.should =~ /vertex-height-map/
+    result.should =~ /clouds/
+  end
+
+  it 'list vertex-height-map' do
+    result = generate 'list', 'vertex-height-map'
+  
+    result.should =~ /vertex-height-map/
+    result.should_not =~ /clouds/
+  end
+
+  it 'list clouds' do
+    result = generate 'list', 'clouds'
+  
+    result.should_not =~ /vertex-height-map/
+    result.should =~ /clouds/
+  end
+end

data/spec/lib/jax/rails/application_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+
+# Tests Rails app mounted by the command `jax server`. See Jax::Rails::Application.
+# The app does nothing except mount Jax::Engine at "/".
+
+describe "Jax::Rails::Application" do
+  def app
+    Jax::Rails::Application
+  end
+  
+  it "should mount Jax dev suite at root" do
+    get '/'
+    follow_redirect! if last_response.redirect?
+    last_response.should be_ok
+    last_response.body.should match(/Jax Development Suite/)
+  end
+  
+  it "should include Jax spec helpers in jasmine" do
+    get '/jasmine'
+    last_response.should be_ok
+    last_response.body.should match(/src="\/spec\/jax_spec_environment_helper\.js"/)
+  end
+end

data/spec/lib/jax/shader_spec.rb

@@ -0,0 +1,67 @@
+# This spec tests the Jax::Shader preprocessor. For now, the preprocessor is in charge of handling standard
+# Sprockets JS directives (as it inherits from Sprockets::DirectiveProcessor), as well as preprocessing the
+# shader itself. For now, only `export` commands are processed. The rest of the preprocessing is currently
+# done on the JavaScript side.
+#
+
+require 'spec_helper'
+
+describe Jax::Shader do
+  # include MockAssets
+  
+  context "exports" do
+    context "with implicit value" do
+      before :each do
+        create_shader 'my_own_shader', :fragment => "void main(void) { vec4 ambient = vec4(1); export(vec4, ambient); }"
+      end
+      
+      it "should produce an exports assignment" do
+        asset('shaders/my_own_shader/fragment.glsl').should =~ /Jax\.shader_data\("my_own_shader"\)\["exports"\]\s*=/
+      end
+      
+      it "should have 'ambient' in exports list" do
+        asset('shaders/my_own_shader/fragment.glsl').should =~ /\["exports"\]\["ambient"\]\s*=\s*"vec4"/
+      end
+    end
+    
+    context "with explicit value" do
+      before :each do
+        create_shader 'my_own_shader', :fragment => "void main(void) { vec4 ambient = vec4(1); export(vec4, ambient, ambient * 0.5); }"
+      end
+
+      it "should produce an exports assignment" do
+        asset('shaders/my_own_shader/fragment.glsl').should =~ /Jax\.shader_data\("my_own_shader"\)\["exports"\]\s*=/
+      end
+      
+      it "should have 'ambient' in exports list" do
+        asset('shaders/my_own_shader/fragment.glsl').should =~ /\["exports"\]\["ambient"\]\s*=\s*"vec4"/
+      end
+    end
+  end
+  
+  context "requiring another shader library" do
+    before :each do
+      create_asset 'shaders/functions/lights.glsl', '1'
+      create_shader 'my_own_shader', :common => "//= require 'shaders/functions/lights'\n2"
+    end
+    
+    it "should set the shader data" do
+      asset('shaders/my_own_shader/common.glsl').should =~ /Jax\.shader_data\("my_own_shader"\)\["common"\]\s*=/
+    end
+    
+    it "should include a reference to required library but not the library's source itself" do
+      # This approach saves significantly on space, cutting down the amount of JavaScript to be generated.
+      asset('shaders/my_own_shader/common.glsl').should match(/#{Regexp::escape("<%= Jax.import_shader_code(\\\"functions\\\", \\\"lights\\\") %>\\n2")}/)
+    end
+    
+    context "twice" do
+      before :each do
+        create_shader 'my_own_shader', :common => "//= require 'shaders/functions/lights'\n//= require 'shaders/functions/lights'\n2"
+      end
+
+      it "should not reference libraries more than once" do
+        asset('shaders/my_own_shader/common.glsl').scan(/#{Regexp::escape("<%= Jax.import_shader_code(\\\"functions\\\", \\\"lights\\\") %>")}/).length.should == 1
+      end
+    end
+  end
+end

data/spec/lib/jax/util/tar_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+
+describe Jax::Util::Tar do
+  include Jax::Util::Tar
+  
+  it "should use relative paths, not absolute ones" do
+    src = File.expand_path("../../../../tmp/jax-tar", File.dirname(__FILE__))
+    dest = File.expand_path("../../../../tmp/jax-tar/dst", File.dirname(__FILE__))
+    
+    FileUtils.rm_rf src  if File.exist?(src)
+    FileUtils.rm_rf dest if File.exist?(dest)
+    
+    Dir.mkdir src unless File.directory?(src)
+    Dir.chdir src do
+      File.open "root-file", "w" do |f|
+        f.print "CONTENT"
+      end
+    end
+    
+    tarfile = tar src
+    untar tarfile, dest
+    
+    File.should exist(File.join(dest, "root-file"))
+    File.read(File.join(dest, "root-file")).should == "CONTENT"
+  end
+end

data/spec/{test_helper.rb → spec_helper.rb}

@@ -1,39 +1,37 @@
-require 'test/unit'
-require 'turn'
+require 'bundler/setup'
+require 'jax'
 
-$:.unshift File.expand_path("../lib", File.dirname(__FILE__))
-require File.join(File.dirname(__FILE__), "../lib/jax")
-require File.join(File.dirname(__FILE__), "../lib/jax/generators/app")
-require File.join(File.dirname(__FILE__), "../lib/jax/generators/commands")
+require 'rspec'
+require 'tmpdir'
 
-require 'fakeweb'
+# require 'rspec/isolation'
 
-Dir[File.join(File.dirname(__FILE__), 'support/**/*.rb')].each do |fi|
-  require fi
-end
+require 'genspec'
 
-class Test::Unit::TestCase
-  def assert_not_empty(ary)
-    assert_not_equal 0, ary.length, "Expected #{ary.inspect} to not be empty"
-  end
-  
-  def assert_empty(ary)
-    assert_equal 0, ary.length, "Expected #{ary.inspect} to be empty"
-  end
-  
-  def assert_contains(obj, ary)
-    assert_not_nil ary.index(obj), "Expected #{ary.inspect} to contain #{obj.inspect}"
-  end
-  
-  def assert_not_contains(obj, ary)
-    assert_nil ary.index(obj), "Expected #{ary.inspect} not to contain #{obj.inspect}"
+require 'fileutils'
+Dir[File.expand_path("support/**/*.rb", File.dirname(__FILE__))].each { |fi| require fi }
+
+require 'jax/rails/application'
+Jax::Rails::Application.config.assets.digest = false
+# IMPORTANT: it is necessary to set this _prior_ to app initialization in order to pick up asset dirs
+::Rails.application.config.root = File.expand_path("../../tmp/rails-specs", File.dirname(__FILE__))
+Jax::Rails::Application.initialize!
+
+# see support/test_model_generator.rb
+::Rails::Generators.options[:rails][:orm] = "test"
+
+require 'jax/testing/rails_environment'
+
+# Bypass rescue_action stuff in rails. This borrowed from rspec-rails.
+class ActionController::Base
+  def rescue_with_handler(exception)
+    raise exception
   end
-  
-  alias assert_contained assert_contains
-  alias assert_not_contained assert_not_contains
 end
 
 include FixturesHelper
+
+require 'fakeweb'
 FakeWeb.allow_net_connect = false
 FakeWeb.register_uri(:get, "http://nowhere.example.com/plugins/search/cloud", :response => fixture('web/plugins/404.http'))
 FakeWeb.register_uri(:get, "http://plugins.jaxgl.com/plugins", :response => fixture('web/plugins/all.xml'))
@@ -53,3 +51,14 @@ FakeWeb.register_uri(:post, "http://missing%40gmail.com:password@plugins.jaxgl.c
 FakeWeb.register_uri(:get, "http://sinisterchipmunk%40gmail.com:password@plugins.jaxgl.com/profile", :response => fixture('web/plugins/author/login_existing_account.xml.http'))
 # FakeWeb.register_uri(:post, "http://sinisterchipmunk%40gmail.com:password@plugins.jaxgl.com/author/plugins", :response => fixture('web/plugins/author/create_new_plugin.xml.http'))
 FakeWeb.register_uri(:post, "http://plugins.jaxgl.com/plugins", :response => fixture('web/plugins/author/create_new_plugin.xml.http'))
+
+RSpec.configure do |c|
+  c.include Jax::Testing::RailsEnvironment
+  c.include Rack::Test::Methods
+  c.include FixturesHelper
+  
+  c.before(:each) do
+    FileUtils.rm_rf File.expand_path("../tmp/cache", File.dirname(__FILE__))
+    setup_rails_environment
+  end
+end

data/spec/support/test_model_generator.rb

@@ -0,0 +1,14 @@
+# Stand-in for ActiveRecord, invoked by Jax::Generators::ModelGenerator when --rails is passed.
+# This lets us mock up the AR model generator so that we don't have to worry about what happens when
+# AR can't find a database. Ultimately, this keeps Jax loosely coupled to AR, so that other ORMs can
+# be used.
+
+module Test
+  module Generators
+    class ModelGenerator < ::Rails::Generators::NamedBase
+      def create_model
+        create_file "app/models/#{file_name}.rb"
+      end
+    end
+  end
+end

data/templates/app/Gemfile.tt

@@ -0,0 +1,17 @@
+source :gemcutter
+
+gem 'jax', '<%= Jax::Version::STRING %>'
+
+# Jax will generate files using CoffeeScript by default.
+# If you want to work in pure JavaScript, simply remove
+# this line:
+gem 'coffee-rails'
+
+# Used to minify the JavaScript files when you run
+# `rake assets:precompile`. Remove this gem and
+# change the environments/production.rb file
+# if you don't want the JavaScripts minified.
+gem 'uglifier'
+
+# Used to minify CSS files, if present
+gem 'sass-rails'

data/templates/app/Rakefile

@@ -0,0 +1,4 @@
+require File.expand_path('../config/application', __FILE__)
+require 'rake'
+
+Jax::Rails::Application.load_tasks

data/templates/app/config/application.rb

@@ -0,0 +1,16 @@
+require File.expand_path("boot", File.dirname(__FILE__))
+
+require 'rails'
+
+Bundler.require(:default, Rails.env) if defined?(Bundler)
+
+require 'jax/rails/application'
+
+# Hooks into Jax's built-in Rails application and sets
+# the root directory. You can set any other Rails
+# configuration options that you want here, too.
+
+class Jax::Rails::Application < ::Rails::Application
+  config.root = File.expand_path("..", File.dirname(__FILE__))
+  config.assets.cache_store = [:file_store, File.expand_path("../tmp/cache/assets", File.dirname(__FILE__))]
+end

data/templates/app/config/environment.rb

@@ -0,0 +1,5 @@
+# Load Jax's built-in Rails application
+require File.expand_path('../application', __FILE__)
+
+# Initialize Jax's built-in Rails application
+Jax::Rails::Application.initialize!

data/templates/app/config/environments/production.rb

@@ -0,0 +1,4 @@
+Jax::Rails::Application.configure do
+  # Compress JavaScripts and CSS
+  config.assets.compress = true
+end

data/templates/app/config.ru

@@ -0,0 +1,6 @@
+# This file is loaded when you run `jax server` and
+# is used to bootstrap the Jax environment using a
+# built-in Ruby on Rails application.
+
+require ::File.expand_path('../config/environment',  __FILE__)
+run Jax::Rails::Application

data/templates/app/script/jax

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+# When you run the `jax` command line tool, it actually invokes this file
+# behind the scenes. It's equivalent to just executing this file directly.
+
+APP_PATH = File.expand_path('../../config/application',  __FILE__)
+require File.expand_path('../../config/boot',  __FILE__)
+require 'jax/commands'

data/templates/application_controller.js.coffee.erb

@@ -0,0 +1,3 @@
+Jax.getGlobal()['ApplicationController'] = Jax.Controller.create "Application",
+  # you can list helpers to be mixed in here, if you like
+  helpers: []

data/templates/application_controller.js.erb

@@ -0,0 +1,6 @@
+(function() {
+  Jax.getGlobal()['ApplicationController'] = Jax.Controller.create("Application", {
+    // you can list helpers to be mixed in here, if you like
+    helpers: []
+  });
+})();

data/templates/application_helper.js.coffee.erb

@@ -0,0 +1,3 @@
+Jax.getGlobal().ApplicationHelper = Jax.Helper.create(
+  # methods added here will be automatically mixed into all Jax classes
+)

data/templates/application_helper.js.erb

@@ -0,0 +1,3 @@
+Jax.getGlobal().ApplicationHelper = Jax.Helper.create({
+  // methods added here will be automatically mixed into all Jax classes
+});

data/templates/controller.js.coffee.erb

@@ -0,0 +1,9 @@
+Jax.Controller.create "<%=class_name%>", ApplicationController,
+  <%- actions.each do |action| -%>
+  <%= action %>: ->
+    # Action body here
+  
+  <%- end -%>
+  # Some special actions are fired whenever the corresponding input is
+  # received from the user.
+  mouse_pressed: (event) ->

data/templates/controller.js.erb

@@ -0,0 +1,15 @@
+(function() {
+  Jax.Controller.create("<%=class_name%>", ApplicationController, {
+    <%- actions.each do |action| -%>
+    <%=action%>: function() {
+      
+    },
+
+    <%- end -%>
+    // Some special actions are fired whenever the corresponding input is
+    // received from the user.
+    mouse_clicked: function(event) {
+      
+    }
+  });
+})();