jax 1.1.1 → 2.0.0

data/spec/generators/jax/application_generator_spec.rb

@@ -0,0 +1,18 @@
+require 'spec_helper'
+require 'fileutils'
+
+describe "jax:application" do
+  with_args "welcome", "--skip-bundle" do
+    it "should generate application controller" do
+      subject.should generate("welcome/app/assets/jax/controllers/application_controller.js.coffee")
+      subject.should_not generate("welcome/app/assets/jax/controllers/application_controller.js")
+    end
+    
+    with_args "--without-coffeescript" do
+      it "should generate application controller" do
+        subject.should generate("welcome/app/assets/jax/controllers/application_controller.js")
+        subject.should_not generate("welcome/app/assets/jax/controllers/application_controller.js.coffee")
+      end
+    end
+  end
+end

data/spec/generators/jax/controller_generator_spec.rb

@@ -0,0 +1,102 @@
+require 'spec_helper'
+require 'fileutils'
+
+describe "jax:controller" do
+  before_generation do
+    FileUtils.mkdir_p "config"
+    File.open("config/routes.rb", "w") do |f|
+      f.puts "Rails.application.routes.draw do"
+      f.puts "end"
+    end
+  end
+  
+  shared_examples_for "generator with coffee" do
+    it "should generate coffee file" do
+      subject.should generate("app/assets/jax/controllers/welcome_controller.js.coffee")
+    end
+
+    it "should generate coffee spec" do
+      subject.should generate("spec/javascripts/jax/controllers/welcome_controller_spec.js.coffee")
+    end
+    
+    it "should generate coffee view" do
+      subject.should generate("app/assets/jax/views/welcome/index.js.coffee")
+      subject.should generate("app/assets/jax/views/welcome/other.js.coffee")
+    end
+    
+    it "should not generate JS file" do
+      subject.should_not generate("app/assets/jax/controllers/welcome_controller.js")
+    end
+    
+    it "should not generate JS spec" do
+      subject.should_not generate("spec/javascripts/jax/controllers/welcome_controller_spec.js")
+    end
+
+    it "should not generate JS view" do
+      subject.should_not generate("app/assets/jax/views/welcome/index.js")
+      subject.should_not generate("app/assets/jax/views/welcome/other.js")
+    end
+  end
+  
+  shared_examples_for 'generator without coffee' do
+    it "should not generate coffee file" do
+      subject.should_not generate("app/assets/jax/controllers/welcome_controller.js.coffee")
+    end
+
+    it "should not generate coffee spec" do
+      subject.should_not generate("spec/javascripts/jax/controllers/welcome_controller_spec.js.coffee")
+    end
+    
+    it "should not generate coffee view" do
+      subject.should_not generate("app/assets/jax/views/welcome/index.js.coffee")
+      subject.should_not generate("app/assets/jax/views/welcome/other.js.coffee")
+    end
+    
+    it "should generate JS file" do
+      subject.should generate("app/assets/jax/controllers/welcome_controller.js")
+    end
+    
+    it "should generate JS spec" do
+      subject.should generate("spec/javascripts/jax/controllers/welcome_controller_spec.js")
+    end
+
+    it "should generate JS view" do
+      subject.should generate("app/assets/jax/views/welcome/index.js")
+      subject.should generate("app/assets/jax/views/welcome/other.js")
+    end
+  end
+
+  # ===
+
+  with_arguments 'welcome' do
+    it "should generate a default index action" do
+      subject.should generate("app/assets/jax/controllers/welcome_controller.js.coffee") { |c|
+        c.should match(/\s+index:/)
+      }
+    end
+  end
+
+  with_arguments 'welcome', 'index', 'other' do
+    it_should_behave_like "generator with coffee"
+    
+    it "should not generate Rails files" do
+      subject.should_not generate("app/controllers/welcome_controller.rb")
+    end
+  end
+  
+  with_arguments 'welcome', 'index', 'other', '-j' do
+    it_should_behave_like 'generator without coffee'
+  end
+
+  with_arguments 'welcome', 'index', 'other', '--without-coffeescript' do
+    it_should_behave_like 'generator without coffee'
+  end
+
+  with_arguments 'welcome', 'index', 'other', '--rails' do
+    it_should_behave_like "generator with coffee"
+    
+    it "should generate Rails files" do
+      subject.should generate("app/controllers/welcome_controller.rb")
+    end
+  end
+end

data/spec/generators/jax/helper_generator_spec.rb

@@ -0,0 +1,55 @@
+require 'spec_helper'
+
+describe 'jax:helper' do
+  with_args 'user_input' do
+    it "should generate Coffee helper" do
+      subject.should generate("app/assets/jax/helpers/user_input_helper.js.coffee")
+    end
+  
+    it "should generate Coffee spec" do
+      subject.should generate("spec/javascripts/jax/helpers/user_input_helper_spec.js.coffee")
+    end
+  end
+
+  with_args "user_input", "--without-coffeescript" do
+    it "should generate JS helper" do
+      subject.should generate("app/assets/jax/helpers/user_input_helper.js")
+    end
+  
+    it "should generate JS spec" do
+      subject.should generate("spec/javascripts/jax/helpers/user_input_helper_spec.js")
+    end
+  end
+  
+  with_args "user_input_helper" do
+    it "should generate 'user_input_helper' and not 'user_input_helper_helper'" do
+      subject.should generate("app/assets/jax/helpers/user_input_helper.js.coffee") { |c|
+        c.should     match(/UserInputHelper/)
+        c.should_not match(/UserInputHelperHelper/)
+      }
+      subject.should generate("spec/javascripts/jax/helpers/user_input_helper_spec.js.coffee") { |c|
+        c.should     match(/UserInputHelper/)
+        c.should_not match(/UserInputHelperHelper/)
+      }
+
+      subject.should_not generate("app/assets/jax/helpers/user_input_helper_helper.js.coffee")
+      subject.should_not generate("spec/javascripts/jax/helpers/user_input_helper_helper_spec.js.coffee")
+    end
+    
+    with_args "--without-coffeescript" do
+      it "should generate 'user_input_helper' and not 'user_input_helper_helper'" do
+        subject.should generate("app/assets/jax/helpers/user_input_helper.js") { |c|
+          c.should     match(/UserInputHelper/)
+          c.should_not match(/UserInputHelperHelper/)
+        }
+        subject.should generate("spec/javascripts/jax/helpers/user_input_helper_spec.js") { |c|
+          c.should     match(/UserInputHelper/)
+          c.should_not match(/UserInputHelperHelper/)
+        }
+
+        subject.should_not generate("app/assets/jax/helpers/user_input_helper_helper.js")
+        subject.should_not generate("spec/javascripts/jax/helpers/user_input_helper_helper_spec.js")
+      end
+    end
+  end
+end

data/spec/generators/jax/install_generator_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+
+describe 'jax:install' do
+  before_generation do
+    FileUtils.mkdir_p "config"
+    FileUtils.touch "config/routes.rb"
+  end
+  
+  it "should mount Jax::Engine in routes" do
+    subject.should generate(:route)
+  end
+  
+  it "should generate Coffee application helper" do
+    subject.should generate("app/assets/jax/helpers/application_helper.js.coffee")
+  end
+  
+  it "should generate Coffee application controller" do
+    subject.should generate("app/assets/jax/controllers/application_controller.js.coffee")
+  end
+  
+  with_args "--without-coffeescript" do
+    it "should generate JS application controller" do
+      subject.should generate("app/assets/jax/controllers/application_controller.js")
+    end
+    
+    it "should generate JS application helper" do
+      subject.should generate("app/assets/jax/helpers/application_helper.js")
+    end
+  end
+end

data/spec/generators/jax/jax_generator_spec.rb

@@ -0,0 +1,21 @@
+require 'spec_helper'
+require 'fileutils'
+
+describe "jax" do
+  before_generation do
+    FileUtils.mkdir_p "config"
+    File.open("config/routes.rb", "w") do |f|
+      f.puts "Rails.application.routes.draw do"
+      f.puts "end"
+    end
+  end
+  
+  it "should output generator list" do
+    subject.should output("controller")
+    subject.should output("helper")
+    subject.should output("install")
+    subject.should output("light")
+    subject.should output("model")
+    subject.should output("shader")
+  end
+end

data/spec/generators/jax/light_generator_spec.rb

@@ -0,0 +1,27 @@
+require 'spec_helper'
+
+describe 'jax:light' do
+  with_args 'candle', 'point' do
+    it "should generate a point light" do
+      subject.should generate("app/assets/jax/resources/light_sources/candle.resource") { |c|
+        c.should =~ /type: POINT_LIGHT/
+      }
+    end
+  end
+
+  with_args 'sun', 'directional' do
+    it "should generate a point light" do
+      subject.should generate("app/assets/jax/resources/light_sources/sun.resource") { |c|
+        c.should =~ /type: DIRECTIONAL_LIGHT/
+      }
+    end
+  end
+
+  with_args 'flashlight', 'spot' do
+    it "should generate a point light" do
+      subject.should generate("app/assets/jax/resources/light_sources/flashlight.resource") { |c|
+        c.should =~ /type: SPOT_LIGHT/
+      }
+    end
+  end
+end

data/spec/generators/jax/material_generator_spec.rb

@@ -0,0 +1,62 @@
+require 'spec_helper'
+
+describe 'jax:material' do
+  context "with an existing material manifest" do
+    before :each do
+      FileUtils.mkdir_p ::Rails.application.root.join("app/assets/jax/shaders/brick").to_s
+      File.open ::Rails.application.root.join("app/assets/jax/shaders/brick/manifest.yml").to_s, "w" do |f|
+        f.puts({ :description => "shader description" }.to_yaml)
+      end
+    end
+    
+    it "should list the shader and its description in output" do
+      shell = ::GenSpec::Shell.new
+      ::Rails::Generators.invoke("jax:material", [], :shell => shell)
+      shell.stderr.string.should match(/brick/)
+      shell.stderr.string.should match(/shader description/)
+    end
+  end
+  
+  with_args "brick" do
+    it "should generate brick material" do
+      subject.should generate("app/assets/jax/resources/materials/brick.resource")
+    end
+    
+    with_args "--append" do
+      describe "with a missing file" do
+        it "should add default lighting layer" do
+          subject.should generate("app/assets/jax/resources/materials/brick.resource") { |content|
+            content.should =~ /Lighting/
+          }
+        end
+      end
+      
+      describe "with a pre-existing file" do
+        before_generation do
+          FileUtils.mkdir_p "app/assets/jax/resources/materials"
+          FileUtils.touch "app/assets/jax/resources/materials/brick.resource"
+        end
+      
+        it "should not add default lighting layer" do
+          subject.should generate("app/assets/jax/resources/materials/brick.resource") { |content|
+            content.should_not =~ /Lighting/
+          }
+        end
+      end
+    end
+    
+    with_args "normalMap", "--append" do
+      before_generation do
+        FileUtils.mkdir_p "app/assets/jax/resources/materials"
+        File.open("app/assets/jax/resources/materials/brick.resource", "w") { |f| f.puts '###' }
+      end
+      
+      it "should add normalmap without replacing original copy" do
+        subject.should generate("app/assets/jax/resources/materials/brick.resource") { |content|
+          content.lines.first.strip.should == '###'
+          content.should =~ /type: NormalMap/
+        }
+      end
+    end
+  end
+end

data/spec/generators/jax/model_generator_spec.rb

@@ -0,0 +1,72 @@
+require 'spec_helper'
+
+describe "jax:model" do
+  with_args 'post', 'subject:string', 'body:text' do
+    it "should generate coffee file" do
+      subject.should generate("app/assets/jax/models/post.js.coffee")
+    end
+    
+    it "should generate coffee spec" do
+      subject.should generate("spec/javascripts/jax/models/post_spec.js.coffee") { |fi|
+        fi.should =~ /expect\(model.subject\)/
+        fi.should =~ /expect\(model.body\)/
+      }
+    end
+
+    it "should not generate JS file" do
+      subject.should_not generate("app/assets/jax/models/post.js")
+    end
+    
+    it "should not generate JS spec" do
+      subject.should_not generate("spec/javascripts/jax/models/post_spec.js")
+    end
+    
+    it "should generate resource file" do
+      subject.should generate("app/assets/jax/resources/posts/default.resource") { |f|
+        f.should =~ /subject:/
+        f.should =~ /body:/
+      }
+    end
+  end
+  
+  with_args 'post', 'subject:string', 'body:text', '-j' do
+    it "should not generate coffee file" do
+      subject.should_not generate("app/assets/jax/models/post.js.coffee")
+    end
+    
+    it "should not generate coffee spec" do
+      subject.should_not generate("spec/javascripts/jax/models/post_spec.js.coffee")
+    end
+
+    it "should generate JS file" do
+      subject.should generate("app/assets/jax/models/post.js")
+    end
+    
+    it "should generate JS spec" do
+      subject.should generate("spec/javascripts/jax/models/post_spec.js") { |fi|
+        fi.should =~ /expect\(model.subject\)/
+        fi.should =~ /expect\(model.body\)/
+      }
+    end
+
+    it "should generate resource file" do
+      subject.should generate("app/assets/jax/resources/posts/default.resource") { |f|
+        f.should =~ /subject:/
+        f.should =~ /body:/
+      }
+    end
+  end
+  
+  with_args 'post', 'subject:string', 'body:text', '--rails' do
+    it "should generate rails model" do
+      subject.should generate('app/models/post.rb')
+    end
+
+    it "should generate resource file" do
+      subject.should generate("app/assets/jax/resources/posts/default.resource") { |f|
+        f.should =~ /subject:/
+        f.should =~ /body:/
+      }
+    end
+  end
+end

data/spec/generators/jax/plugin_generator_spec.rb

@@ -0,0 +1,143 @@
+require 'spec_helper'
+
+describe 'jax:plugin' do
+  EXPECTED_FILES = %w(
+    vendor/plugins/cloud/app/assets/jax/controllers
+    vendor/plugins/cloud/app/assets/jax/models
+    vendor/plugins/cloud/app/assets/jax/helpers
+    vendor/plugins/cloud/app/assets/jax/views
+    vendor/plugins/cloud/app/assets/jax/resources
+    vendor/plugins/cloud/spec
+    vendor/plugins/cloud/manifest.yml
+    vendor/plugins/cloud/init.rb
+    vendor/plugins/cloud/install.rb
+    vendor/plugins/cloud/uninstall.rb
+  )
+  
+  before :each do
+    Jax.config.plugin_repository_url = Jax.config.default_plugin_repository_url
+  end
+  
+  before_generation do |dir|
+    ::Rails.application.stub!(:root).and_return(Pathname.new dir)
+  end
+  
+  with_args "cloud" do
+    context "remote repo unavailable" do
+      before :each do
+        Jax.config.plugin_repository_url = "http://nowhere.example.com"
+      end
+      
+      with_input "y\n" do
+        it "with confirmation" do
+          subject.should output(/an error occurred/i)
+          EXPECTED_FILES.each do |fi|
+            subject.should generate(fi)
+          end
+        end
+      end
+      
+      with_input "n\n" do
+        it "with abort" do
+          subject.should output(/aborted/)
+          EXPECTED_FILES.each do |fi|
+            # FIXME this is outputting empty lines into the test results. Why?
+            subject.should_not generate(fi)
+          end
+        end
+      end
+    end
+  end
+  
+  context "new plugin not in repo" do
+    with_args "missing" do
+      it "should generate expected files" do
+        # is this not a double of 'clean new plugin'? why does that one not fail?
+        # probably screwed up the fixture somehow. wutevs, this test is the real
+        # deal.
+        EXPECTED_FILES.each do |fi|
+          subject.should generate(fi.gsub(/cloud/, 'missing'))
+        end
+      end
+    end
+  end
+  
+  with_args "cloud" do
+    context "a clean new plugin" do
+      it "should generate expected files" do
+        EXPECTED_FILES.each do |fi|
+          subject.should generate(fi)
+        end
+      end
+    end
+  
+    context "overwriting a locally conflicting name" do
+      with_input "y\n" do
+        before_generation do |d|
+          FileUtils.mkdir_p File.join(d, "vendor/plugins/cloud")
+          File.open(File.join(d, "vendor/plugins/cloud/custom"), "w") { |f| f.print "file contents" }
+        end
+
+        it "should remove the offending file" do
+          subject.should_not generate("vendor/plugins/cloud/custom")
+        end
+      
+        it "should not abort generating the plugin" do
+          subject.should generate("vendor/plugins/cloud")
+        end
+      end
+    end
+
+  end
+
+  context "using a conflicting name with --local" do
+    with_args "clouds", "--local"
+    
+    it "should not abort" do
+      subject.should_not output(/aborted/)
+    end
+    
+    it "should generate the plugin" do
+      subject.should generate("vendor/plugins/clouds")
+    end
+  end
+
+
+  context "without remote name conflicts" do
+    with_args "cloud"
+    
+    it "should not abort" do
+      subject.should_not output(/aborted/)
+    end
+    
+    it "should generate the plugin" do
+      subject.should generate("vendor/plugins/cloud")
+    end
+  end
+  
+  context "aborting remote name conflicts" do
+    with_input "n\n"
+    with_args "clouds"
+    
+    it "should abort" do
+      subject.should output(/aborted/)
+    end
+    
+    it "should not generate the plugin" do
+      subject.should_not generate('vendor/plugins/clouds')
+    end
+  end
+      
+  context "allowing remote name conflicts" do
+    with_input "y\n"
+    with_args "clouds"
+    
+    it "should not abort" do
+      subject.should_not output(/aborted/)
+    end
+    
+    it "should generate the plugin" do
+      subject.should generate("vendor/plugins/clouds")
+    end
+  end
+end

data/spec/generators/jax/scaffold_generator_spec.rb

@@ -0,0 +1,35 @@
+require 'spec_helper'
+
+describe 'jax:scaffold' do
+  with_args "dungeon" do
+    it "should generate dungeon model" do
+      subject.should generate("app/assets/jax/models/dungeon.js.coffee")
+      subject.should generate("spec/javascripts/jax/models/dungeon_spec.js.coffee")
+    end
+
+    it "should generate dungeon controller" do
+      subject.should generate("app/assets/jax/controllers/dungeon_controller.js.coffee")
+      subject.should generate("spec/javascripts/jax/controllers/dungeon_controller_spec.js.coffee")
+    end
+    
+    it "should generate default dungeon resource" do
+      subject.should generate("app/assets/jax/resources/dungeons/default.resource")
+    end
+    
+    it "should generate dungeon material" do
+      subject.should generate("app/assets/jax/resources/materials/dungeon.resource")
+    end
+    
+    with_args "--without-coffeescript" do
+      it "should generate dungeon model" do
+        subject.should generate("app/assets/jax/models/dungeon.js")
+        subject.should generate("spec/javascripts/jax/models/dungeon_spec.js")
+      end
+
+      it "should generate dungeon controller" do
+        subject.should generate("app/assets/jax/controllers/dungeon_controller.js")
+        subject.should generate("spec/javascripts/jax/controllers/dungeon_controller_spec.js")
+      end
+    end
+  end
+end

data/spec/generators/jax/shader_generator_spec.rb

@@ -0,0 +1,37 @@
+require 'spec_helper'
+
+describe 'jax:shader' do
+  with_args "clouds" do
+    it "should generate manifest file" do
+      subject.should generate("app/assets/jax/shaders/clouds/manifest.yml")
+    end
+
+    it "should generate GLSL files" do
+      subject.should generate("app/assets/jax/shaders/clouds/common.glsl")
+      subject.should generate("app/assets/jax/shaders/clouds/fragment.glsl")
+      subject.should generate("app/assets/jax/shaders/clouds/vertex.glsl")
+    end
+
+    it "should not generate JS files" do
+      subject.should_not generate("app/assets/jax/shaders/clouds/material.js")
+      subject.should_not generate("spec/javascripts/jax/shaders/clouds_spec.js")
+    end
+    
+    it "should generate coffee files" do
+      subject.should generate("app/assets/jax/shaders/clouds/material.js.coffee")
+      subject.should generate("spec/javascripts/jax/shaders/clouds_spec.js.coffee")
+    end
+  end
+  
+  with_args "clouds", "-j" do
+    it "should generate JS files" do
+      subject.should generate("app/assets/jax/shaders/clouds/material.js")
+      subject.should generate("spec/javascripts/jax/shaders/clouds_spec.js")
+    end
+    
+    it "should not generate coffee files" do
+      subject.should_not generate("app/assets/jax/shaders/clouds/material.js.coffee")
+      subject.should_not generate("spec/javascripts/jax/shaders/clouds_spec.js.coffee")
+    end
+  end
+end

data/spec/javascripts/helpers/jasmine_webgl_helper.js

@@ -0,0 +1,13 @@
+function glit() {
+  // If testing with node.js, the GL context will (currently) be fake, making it impossible
+  // to do proper picking. TODO make the GL context real! (Yes, it can be done -- see
+  // https://github.com/pufuwozu/node-webgl.) For now, disable GL-specific tests under node.
+  if (Jax.getGlobal().SPEC_CONTEXT && !Jax.getGlobal().SPEC_CONTEXT.gl.fake) {
+    it.apply(this, arguments);
+  } else {
+    xit.apply(this, arguments);
+  }
+}
+
+if (typeof(exports) != "undefined")
+  exports.glit = glit;

data/{lib/jax/generators/app/templates/spec/javascripts/support/spec_helpers → spec/javascripts/helpers}/jax_spec_environment_helper.js

@@ -1,3 +1,5 @@
+var jsApiReporter;
+
 function setupJaxTestEnvironment() {
   var jasmineEnv = jasmine.getEnv();
 
@@ -25,7 +27,8 @@ function setupJaxSpecContext() {
   canvas.setAttribute("width", 600);
   canvas.setAttribute("height", 400);
   canvas.setAttribute("id", "spec-canvas");
-  canvas.style.display = "none";
+  if (canvas.style)
+    canvas.style.display = "none";
   document.body.appendChild(canvas);
   
   beforeEach(function() {
@@ -37,5 +40,7 @@ function setupJaxSpecContext() {
   })
 }
 
-if (typeof(global) != 'undefined')
+if (typeof(global) != 'undefined') {
+  global.setupJaxTestEnvironment = setupJaxTestEnvironment;
   global.setupJaxSpecContext = setupJaxSpecContext;
+}

data/spec/javascripts/jax/builtin/meshes/cube_spec.js

@@ -0,0 +1,10 @@
+describe("Cube", function() {
+  var cube;
+  
+  beforeEach(function() { cube = new Jax.Mesh.Cube() });
+  
+  it("should build successfully", function() {
+    var verts = [], colors = [], texes = [], norms = [];
+    cube.init(verts, colors, texes, norms);
+  });
+});

data/spec/javascripts/jax/builtin/meshes/plane_spec.js

@@ -0,0 +1,8 @@
+describe("Jax.Mesh.Plane", function() {
+  var plane;
+  
+  describe("with no options", function() {
+    beforeEach(function() { plane = new Jax.Mesh.Plane(); });
+    it("should initialize", function() { });
+  });
+});