jspec-jquery-sandbox 0.2.0

data/LICENSE

@@ -0,0 +1,18 @@
+Copyright (c) 2010 Yann Lugrin <yann.lugrin@sans-savoir.net>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,71 @@
+= jSpec Sandbox - a window sandbox for jQuery applications testing
+
+* jSpec Sandbox website: https://github.com/yannlugrin/jspec-sandbox
+* jSpec Sandbox on github: https://github.com/yannlugrin/jspec-sandbox
+* jSpec website: http://jspec.info
+* jQuery website: http://jquery.com
+
+== Documentation
+
+After sandbox is installed, all jQuery call is redirected in sandbox context
+(an iframe) and be reset after each test. You can use `_jQuery()' or `_$()' to
+call jQuery in jspec context.
+
+Utility `sandbox()' return a jQuery object from sandbox:
+
+ * sandbox() => return sandbox body
+ * sandbox('<p></p>') => append to sandboy body an `p' element and return it
+ * sandbox('my-fixture') => append a sandbox body the content of fixture file and return it (child of body element)
+
+=== install with jspec command tool
+
+First install [gem](http://gemcutter.org/) then execute:
+
+  $ sudo gem install jspec-jquery-sandbox
+
+At which point go into your projext folder and execute:
+
+  $ echo "require 'jspec/jquery/sandbox/installable'" > spec/commands/jquery_sandbox_command.rb
+  $ jspec install jquerysandbox
+
+This command add `jspec.jquery.sandbox.js' and `jspec.jquery.sandbox.html' files
+into your `spec/support' folder.
+
+After this step edit `dom.html' file to require sanbox lib after jquery and
+add iframe with sandbox source.
+
+  ...
+	<script src="./lib/jquery.js"></script>
+  <script src="./support/jspec.jquery.sandbox.js"></script>
+  <script>
+    function runSuites() {
+  ...
+    <iframe id="sandbox" name="sandbox" src="./support/jspec.jquery.sandbox.html" style="display:none"></iframe>
+  </body>
+  ...
+
+=== install manually
+
+Just copy `jspec.jquery.sandbox.js' and `jspec.jquery.sandbox.html' files
+lib folder to your project `spec/support' folder.
+
+After this step edit `dom.html' file to require sanbox lib after jquery and
+add iframe with sandbox source.
+
+  ...
+	<script src="./lib/jquery.js"></script>
+  <script src="./support/jspec.jquery.sandbox.js"></script>
+  <script>
+    function runSuites() {
+  ...
+    <iframe id="sandbox" name="sandbox" src="./support/jspec.jquery.sandbox.html" style="display:none"></iframe>
+  </body>
+  ...
+
+== Copyright and Licenses
+
+Licensed under the MIT license (read LICENSE file). This library depends on
+jSpec, also licensed under the MIT licence.
+
+* jSpec Sandbox - Copyright (c) 2010 Yann Lugrin
+* jSpec - Copyright (c) 2010 TJ Holowaychuk

data/Rakefile

@@ -0,0 +1,32 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = 'jspec-jquery-sandbox'
+    gem.summary = %Q{a window sandbox for jQuery application testing with jSpec}
+    gem.email = 'yann.lugrin@sans-savoir.net'
+    gem.homepage = 'http://github.com/yannlugrin/jspec-jquery-sandbox'
+    gem.authors = ['Yann Lugrin']
+    gem.files = FileList["[A-Z]*", "{lib,src}/**/*"]
+    gem.require_paths = ['src']
+    gem.add_dependency 'jspec'
+    gem.add_development_dependency 'rspec', '>= 2.0.0.beta'
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+RSpec::Core::RakeTask.new(:rdoc) do |spec|
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+

data/VERSION

@@ -0,0 +1 @@
+0.2.0

data/lib/jspec.jquery.sandbox.html

@@ -0,0 +1,10 @@
+<!DOCTYPE HTML>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <title></title>
+</head>
+	<body class="sandbox">
+
+  </body>
+</html>

data/lib/jspec.jquery.sandbox.js

@@ -0,0 +1,83 @@
+
+// jQuery is required
+JSpec.requires('jQuery', 'when using jspec.jquery.sandbox.js');
+
+/*
+ *  jQuery Sandbox
+ */
+(function(JSpec, jQuery, undefined) {
+
+var $ = jQuery;
+
+// jQuery with jSpec context
+var jQueryInit = jQuery.fn.init;
+
+var _$ = _jQuery = function(selector, context) {
+  jQuery.fn.init = jQueryInit;
+  var result = jQuery(selector, context);
+  jQuery.fn.init = jQuerySandboxInit;
+
+  return result;
+}
+
+// jQuery with sandbox context (default)
+var jQuerySandboxInit = function (selector, context) {
+  if (_$('iframe[name=sandbox]').length === 0) {
+    throw 'need a iframe named `sandbox\' when using jspec.jquery.sandbox.js';
+  }
+
+  context = (frames['sandbox'] && frames['sandbox'].document) || context;
+  return jQueryInit.apply(this, [selector, context]);
+}
+jQuerySandboxInit.prototype = jQueryInit.prototype;
+
+jQuery.fn.init = jQuerySandboxInit;
+
+/*
+ *  Module
+ */
+JSpec.include({
+  name: 'jQuerySandbox',
+
+  /*
+   * Initialization
+   */
+
+  init: function() {
+  },
+
+  /*
+   *  Utilities
+   */
+
+  utilities: {
+    // sandbox return a jQuery object for box element of sandbox
+    // or for passed element (this element can be a html string or
+    // fixture name.
+    sandbox: function(content) {
+      if (content && content.match(/^[ ]*<.+>[ ]*$/mi)) {
+        content = $(content).appendTo('body');
+      } else if (content) {
+        content = $(this.fixture(content)).appendTo('body');
+      }
+
+      return content || $('body');
+    },
+
+    // alias to jQuery with jspec context
+    _$: _jQuery,
+    _jQuery: _jQuery,
+  },
+
+  /*
+   *  Hooks
+   */
+
+  // clear sandbox
+  afterSpec: function(spec) {
+    $('body').html('');
+  },
+
+});
+
+})(JSpec, jQuery);

data/spec/commands/example_commands.rb

@@ -0,0 +1,19 @@
+
+# uncomment and call with `$ jspec example `
+
+# command :example do |c|
+#   c.syntax = 'jspec example [options]'
+#   c.description = 'Just an example command'
+#   c.option '-f', '--foo string', 'Does some foo with <string>'
+#   c.option '-b', '--bar [string]', 'Does some bar with [string]'
+#   c.example 'Do some foo', 'jspec example --foo bar'
+#   c.example 'Do some bar', 'jspec example --bar'
+#   c.when_called do |args, options|
+#     p args
+#     p options.__hash__
+#     # options.foo
+#     # options.bar
+#     # options.__hash__[:foo]
+#     # options.__hash__[:bar]
+#   end 
+# end

data/spec/commands/jquery_sandbox_command.rb

@@ -0,0 +1 @@
+require 'jspec/jquery/sandbox/installable'

data/spec/ruby/installable_spec.rb

@@ -0,0 +1,38 @@
+require File.expand_path('../spec_helper', __FILE__)
+include FileUtils
+
+describe 'jspec' do
+  describe 'install' do
+    before :each do
+      @dest = File.expand_path('../test', __FILE__)
+      mkdir @dest
+      jspec(:init, @dest)
+      File.open(File.join(@dest, 'spec', 'commands', 'jquery_sandbox_command.rb'), 'w+') do |file|
+        file.write "require '#{File.expand_path('../../../src/jspec/jquery/sandbox/installable', __FILE__)
+}'"
+      end
+    end
+
+    after :each do
+      rm_rf @dest
+    end
+
+    describe 'jquery sandbox' do
+      it "should install to spec/support/jspec.jquery.sandbox.js by default" do
+        Dir.chdir @dest do
+          jspec(:install, 'jquerysandbox')
+          File.exists?('spec/support/jspec.jquery.sandbox.js').should be_true
+          File.exists?('spec/support/jspec.jquery.sandbox.html').should be_true
+        end
+      end
+
+      it 'should install to the destination passed' do
+        jspec(:install, 'jquerysandbox', "#{@dest}/spec")
+        File.exists?("#{@dest}/spec/jspec.jquery.sandbox.js").should be_true
+        File.exists?("#{@dest}/spec/jspec.jquery.sandbox.html").should be_true
+      end
+
+    end
+
+  end
+end

data/spec/ruby/spec_helper.rb

@@ -0,0 +1,9 @@
+require 'rubygems'
+require 'rspec'
+require 'rspec/autorun'
+require 'fileutils'
+
+def jspec *args
+  `jspec #{args.join(' ')}`
+end
+

data/src/jspec/jquery/sandbox/installable.rb

@@ -0,0 +1,42 @@
+require 'open-uri'
+
+module JSpec
+  class Installable
+    class Jquerysandbox < self
+
+      def before
+        warn 'jQuery Sandbox does not yet support --release' if options[:release]
+      end
+
+      def lib_source
+        File.expand_path('../../../../../lib/jspec.jquery.sandbox.js', __FILE__)
+      end
+
+      def sandbox_source
+        File.expand_path('../../../../../lib/jspec.jquery.sandbox.html', __FILE__)
+      end
+
+      def lib_dest
+        options[:to] + '/jspec.jquery.sandbox.js'
+      end
+
+      def sandbox_dest
+        options[:to] + '/jspec.jquery.sandbox.html'
+      end
+
+      def install
+        File.open(lib_dest, 'w+') do |file|
+          file.write open(lib_source).read
+        end
+        File.open(sandbox_dest, 'w+') do |file|
+          file.write open(sandbox_source).read
+        end
+      end
+
+      def install_message
+        "jQuery Sandbox  installed to #{lib_dest} and #{sandbox_dest}"
+      end
+
+    end
+  end
+end

metadata

@@ -0,0 +1,111 @@
+--- !ruby/object:Gem::Specification 
+name: jspec-jquery-sandbox
+version: !ruby/object:Gem::Version 
+  hash: 23
+  prerelease: false
+  segments: 
+  - 0
+  - 2
+  - 0
+  version: 0.2.0
+platform: ruby
+authors: 
+- Yann Lugrin
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-06-30 00:00:00 +02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: jspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 31098209
+        segments: 
+        - 2
+        - 0
+        - 0
+        - beta
+        version: 2.0.0.beta
+  type: :development
+  version_requirements: *id002
+description: 
+email: yann.lugrin@sans-savoir.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/jspec.jquery.sandbox.html
+- lib/jspec.jquery.sandbox.js
+- src/jspec/jquery/sandbox/installable.rb
+- spec/ruby/spec_helper.rb
+- spec/ruby/installable_spec.rb
+- spec/commands/jquery_sandbox_command.rb
+- spec/commands/example_commands.rb
+has_rdoc: true
+homepage: http://github.com/yannlugrin/jspec-jquery-sandbox
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- src
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: a window sandbox for jQuery application testing with jSpec
+test_files: 
+- spec/ruby/spec_helper.rb
+- spec/ruby/installable_spec.rb
+- spec/commands/jquery_sandbox_command.rb
+- spec/commands/example_commands.rb