nibjs 1.0.0

data/nibjs.gemspec

@@ -0,0 +1,194 @@
+# We require your library, mainly to have access to the VERSION number. 
+# Feel free to set $version manually.
+$LOAD_PATH.unshift File.expand_path('../lib', __FILE__)
+require "nibjs/version"
+$version = NibJS::Version.to_s
+
+#
+# This is your Gem specification. Default values are provided so that your library
+# should be correctly packaged given what you have described in the .noespec file.
+#
+Gem::Specification.new do |s|
+  
+  ################################################################### ABOUT YOUR GEM
+  
+  # Gem name (required) 
+  s.name = "nibjs"
+  
+  # Gem version (required)
+  s.version = $version
+  
+  # A short summary of this gem
+  #
+  # This is displayed in `gem list -d`.
+  s.summary = "nib.js - Package and embed node.js or coffeescript libraries in the browser"
+
+  # A long description of this gem (required)
+  #
+  # The description should be more detailed than the summary.  For example,
+  # you might wish to copy the entire README into the description.
+  s.description = "nib.js is a NibJS javascript library allowing to maintain javascript projects ala 'node.js'\n(modules, exports, require) while also targetting a web browser as execution platform. It\ncontains a simple packager command (nibjs) that will convert your sources to a single and\nminified .js file to be embedded in the browser. Node.js's exports and require are correctly\nbounded."
+  
+  # The URL of this gem home page (optional)
+  s.homepage = "http://github.com/blambeau/nib.js"
+
+  # Gem publication date (required but auto)
+  #
+  # Today is automatically used by default, uncomment only if
+  # you know what you do!
+  #
+  # s.date = Time.now.strftime('%Y-%m-%d')
+  
+  # The license(s) for the library.  Each license must be a short name, no
+  # more than 64 characters.
+  #
+  # s.licences = %w{}
+
+  # The rubyforge project this gem lives under (optional)
+  #
+  # s.rubyforge_project = nil
+
+  ################################################################### ABOUT THE AUTHORS
+  
+  # The list of author names who wrote this gem.
+  #
+  # If you are providing multiple authors and multiple emails they should be
+  # in the same order.
+  # 
+  s.authors = ["Bernard Lambeau"]
+  
+  # Contact emails for this gem
+  #
+  # If you are providing multiple authors and multiple emails they should be
+  # in the same order.
+  #
+  # NOTE: Somewhat strangly this attribute is always singular! 
+  #       Don't replace by s.emails = ...
+  s.email  = ["blambeau@gmail.com"]
+
+  ################################################################### PATHS, FILES, BINARIES
+  
+  # Paths in the gem to add to $LOAD_PATH when this gem is 
+  # activated (required).
+  #
+  # The default 'lib' is typically sufficient.
+  s.require_paths = ["lib"]
+  
+  # Files included in this gem.
+  #
+  # By default, we take all files included in the Manifest.txt file on root
+  # of the project. Entries of the manifest are interpreted as Dir[...] 
+  # patterns so that lazy people may use wilcards like lib/**/*
+  #
+  here = File.expand_path(File.dirname(__FILE__))
+  s.files = File.readlines(File.join(here, 'Manifest.txt')).
+                 inject([]){|files, pattern| files + Dir[File.join(here, pattern.strip)]}.
+                 collect{|x| x[(1+here.size)..-1]}
+
+  # Test files included in this gem.
+  #
+  s.test_files = Dir["test/**/*"] + Dir["spec/**/*"]
+
+  # The path in the gem for executable scripts (optional)
+  #
+  s.bindir = "bin"
+
+  # Executables included in the gem.
+  #
+  s.executables = (Dir["bin/*"]).collect{|f| File.basename(f)}
+
+  ################################################################### REQUIREMENTS & INSTALL
+  # Remember the gem version requirements operators and schemes:
+  #   =  Equals version
+  #   != Not equal to version
+  #   >  Greater than version
+  #   <  Less than version
+  #   >= Greater than or equal to
+  #   <= Less than or equal to
+  #   ~> Approximately greater than
+  #
+  # Don't forget to have a look at http://lmgtfy.com/?q=Ruby+Versioning+Policies 
+  # for setting your gem version.
+  #
+  # For your requirements to other gems, remember that
+  #   ">= 2.2.0"              (optimistic:  specify minimal version)
+  #   ">= 2.2.0", "< 3.0"     (pessimistic: not greater than the next major)
+  #   "~> 2.2"                (shortcut for ">= 2.2.0", "< 3.0")
+  #   "~> 2.2.0"              (shortcut for ">= 2.2.0", "< 2.3.0")
+  #
+
+  #
+  # One call to add_dependency('gem_name', 'gem version requirement') for each
+  # runtime dependency. These gems will be installed with your gem. 
+  # One call to add_development_dependency('gem_name', 'gem version requirement')
+  # for each development dependency. These gems are required for developers
+  #
+  s.add_development_dependency("rake", "~> 0.8.7")
+  s.add_development_dependency("rspec", "~> 2.4.0")
+  s.add_development_dependency("rcov", "~> 0.9")
+  s.add_development_dependency("yard", "~> 0.6.4")
+  s.add_development_dependency("bluecloth", "~> 2.0.9")
+  s.add_development_dependency("wlang", "~> 0.10.1")
+  s.add_development_dependency("sinatra", "> 0")
+  s.add_development_dependency("bundler", "~> 1.0")
+  s.add_development_dependency("quickl", "~> 0.2.0")
+  s.add_dependency("bundler", "~> 1.0")
+  s.add_dependency("quickl", "~> 0.2.0")
+
+  # The version of ruby required by this gem
+  #
+  # Uncomment and set this if your gem requires specific ruby versions.
+  #
+  # s.required_ruby_version = ">= 0"
+
+  # The RubyGems version required by this gem
+  #
+  # s.required_rubygems_version = ">= 0"
+
+  # The platform this gem runs on.  See Gem::Platform for details.
+  #
+  # s.platform = nil
+
+  # Extensions to build when installing the gem.  
+  #
+  # Valid types of extensions are extconf.rb files, configure scripts 
+  # and rakefiles or mkrf_conf files.
+  #
+  s.extensions = []
+  
+  # External (to RubyGems) requirements that must be met for this gem to work. 
+  # It’s simply information for the user.
+  #
+  s.requirements = nil
+  
+  # A message that gets displayed after the gem is installed
+  #
+  # Uncomment and set this if you want to say something to the user
+  # after gem installation
+  #
+  s.post_install_message = nil
+
+  ################################################################### SECURITY
+
+  # The key used to sign this gem.  See Gem::Security for details.
+  #
+  # s.signing_key = nil
+
+  # The certificate chain used to sign this gem.  See Gem::Security for
+  # details.
+  #
+  # s.cert_chain = []
+  
+  ################################################################### RDOC
+
+  # An ARGV style array of options to RDoc
+  #
+  # See 'rdoc --help' about this
+  #
+  s.rdoc_options = []
+
+  # Extra files to add to RDoc such as README
+  #
+  s.extra_rdoc_files = Dir["README.md"] + Dir["CHANGELOG.md"] + Dir["LICENCE.md"]
+
+end

data/nibjs.noespec

@@ -0,0 +1,41 @@
+# See 'noe help prepare' and 'noe help show-spec' for more information.
+template-info:
+  name: "ruby"
+  version: 1.3.0
+  manifest:
+    Rakefile:
+      safe-override: false
+
+# The following entries are template-related variables. Update to match your 
+# own configuration.
+variables:
+  lower: 
+    nibjs
+  upper:
+    NibJS
+  version:
+    1.0.0
+  summary: 
+    nib.js - Package and embed node.js or coffeescript libraries in the browser
+  description: |-
+    nib.js is a NibJS javascript library allowing to maintain javascript projects ala 'node.js'
+    (modules, exports, require) while also targetting a web browser as execution platform. It
+    contains a simple packager command (nibjs) that will convert your sources to a single and
+    minified .js file to be embedded in the browser. Node.js's exports and require are correctly
+    bounded.
+  authors:
+    - name: Bernard Lambeau
+      email: blambeau@gmail.com
+  links: 
+    - http://github.com/blambeau/nib.js
+  dependencies: 
+    # Rake is required for developers, as usual
+    - {name: rake,      version: "~> 0.8.7",  groups: [development]}
+    - {name: rspec,     version: "~> 2.4.0",  groups: [development]}
+    - {name: rcov,      version: "~> 0.9",    groups: [development]}
+    - {name: yard,      version: "~> 0.6.4",  groups: [development]}
+    - {name: bluecloth, version: "~> 2.0.9",  groups: [development]}
+    - {name: wlang,     version: "~> 0.10.1", groups: [development]}
+    - {name: sinatra,   version: "> 0",       groups: [development]}
+    - {name: bundler,   version: "~> 1.0",    groups: [development, runtime]}
+    - {name: quickl,    version: "~> 0.2.0",  groups: [development, runtime]}

data/src/nibjs.coffee

@@ -0,0 +1,124 @@
+exports.NibJS = {
+  
+    #
+    # Package builders.
+    #
+    # Package builders are simply unary functions registered via NibJS.define. 
+    # These functions are expected to build the package thanks to a Builder 
+    # instance that they receive as first argument.
+    #
+    # @see define
+    # @see Builder
+    #
+    pkgBuilders: []
+
+    # 
+    # Built packages.
+    #
+    # Once the package are built (lazily, at first 'require' invocation), the
+    # results is put in the following array for subsequent requiring.
+    #
+    packages: []
+
+    #
+    # Defines a package via a name and a builder function. 
+    #
+    # Builder functions are expected to build the package thanks to a Builder
+    # instance received as first argument. They are expected to make the first
+    # require to the package index file.
+    #
+    # Example:
+    #   NibJS.define('foo', function(nibjs){
+    #     nibjs.register('bar', function(exports, require){
+    #       /* content of bar.js comes here */
+    #     });
+    #     nibjs.register('index', function(exports, require){
+    #       /* content of index.js come here */
+    #     });
+    #     /* Load the package at end */
+    #     nibjs.require('index');
+    #   });
+    #
+    define: (name, buildFn)->
+      NibJS.pkgBuilders[name] = buildFn
+  
+    #
+    # Returns a package, building it if required (equivalent to Node's _require_).
+    #
+    # Example:
+    #   Foo = NibJS.require('foo')
+    #   Foo.Bar = ...
+    #
+    require: (name)->
+      NibJS.packages[name] ?= NibJS._build_one(name)
+    
+    #
+    # Internal implementation of require, when invoked the first time on
+    # a given library.
+    #  
+    _build_one: (name)->
+      builder = new Builder
+      NibJS.pkgBuilders[name](builder)
+
+    # Application control
+    pending: []
+
+    running: []
+
+    ready: (fn)->
+      NibJS.pending.push(fn)
+
+    start: ()->
+      for fn in NibJS.pending
+        NibJS.running.push(fn())
+      NibJS.pending = []
+
+    isRunning: (fn)->
+      for c in NibJS.running
+        return true if c is fn
+      return false
+    
+  }
+
+  #
+  # Intra-package builder, passed as first argument of NibJS.define
+  #
+  # This builder helps registrering functions for building individual
+  # files, as well as requiring them.
+  #
+  class Builder
+
+    #
+    # Builds a builder instance
+    #
+    constructor: ()->
+      @builders = []
+      @built = []
+
+    #
+    # Register a builder function for _file_.
+    #
+    # The builder function will be called when the file will be required later. 
+    # It takes two parameters as arguments, exports and require. The first one 
+    # allows the file to exports artifacts while the second one mimics the 
+    # Node's require function.
+    #
+    register: (file, builder)=>
+      @builders[file] = builder
+
+    #
+    # Mimics Node's require in the context of this building.
+    #
+    # This function returns the result of requiring _file_, building it with 
+    # the function previously registered (if not previously done).
+    #
+    require: (file)=>
+      @built[file] ?= this.build_file(file)
+  
+    #
+    # Private functions that ensures the building of a file.
+    #
+    build_file: (file)=>
+      exports = {}
+      @builders[file](exports, this.require)
+      exports

data/tasks/debug_mail.rake

@@ -0,0 +1,78 @@
+# Installs a rake task for debuging the announcement mail.
+#
+# This file installs the 'rake debug_mail' that flushes an announcement mail
+# for your library on the standard output. It is automatically generated 
+# by Noe from your .noespec file, and should therefore be configured there, 
+# under the variables/rake_tasks/debug_mail entry, as illustrated below:
+#
+# variables:
+#   rake_tasks:
+#     debug_mail:
+#       rx_changelog_sections: /^#/
+#       nb_changelog_sections: 1
+#       ...
+#
+# If you have specific needs requiring manual intervention on this file, 
+# don't forget to set safe-override to false in your noe specification:
+# 
+# template-info:
+#   manifest:
+#     tasks/debug_mail.rake:
+#       safe-override: false
+#
+# The mail template used can be found in debug_mail.txt. That file may be
+# changed to tune the mail you want to send. If you do so, don't forget to
+# add a manifest entry in your .noespec file to avoid overriding you 
+# changes. The mail template uses wlang, with parentheses for block 
+# delimiters.
+#
+# template-info:
+#   manifest:
+#     tasks/debug_mail.txt:
+#       safe-override: false
+#
+begin
+  require 'wlang'
+  require 'yaml'
+  
+  desc "Debug the release announcement mail"
+  task :debug_mail do 
+    # Check that a .noespec file exists
+    noespec_file = File.expand_path('../../nibjs.noespec', __FILE__)
+    unless File.exists?(noespec_file)
+      raise "Unable to find .noespec project file, sorry."
+    end
+    
+    # Load it as well as variables and options
+    noespec = YAML::load(File.read(noespec_file))
+    vars = noespec['variables'] || {}
+
+    # Changes are taken from CHANGELOG 
+    logs = Dir[File.expand_path("../../CHANGELOG.*", __FILE__)]
+    unless logs.size == 1
+      abort "Unable to find a changelog file"
+    end
+
+    # Load interesting changesets
+    changes, end_found = [], 0
+    File.readlines(logs.first).select{|line|
+      if line =~ /^#/
+        break if end_found >= 1
+        end_found += 1
+      end
+      changes << line
+    }
+    vars['changes'] = changes.join
+    
+    # WLang template
+    template = File.expand_path('../debug_mail.txt', __FILE__)
+    
+    # Let's go!
+    $stdout << WLang::file_instantiate(template, vars, "wlang/active-text")
+  end
+
+rescue LoadError 
+  task :debug_mail do
+    abort "wlang is not available. Try 'gem install wlang'"
+  end
+end

data/tasks/debug_mail.txt

@@ -0,0 +1,13 @@
+Subject: [ANN] !{lower} !{version} Released
+
+!{lower} version !{version} has been released!
+
+!{summary}
+
+*{links as l}{* <!{l}>}{!{"\n"}}
+
+!{description}
+
+Changes:
+
+!{changes}

data/tasks/dist.rake

@@ -0,0 +1,14 @@
+require "fileutils"
+
+desc "Build dist/nibjs-#{$gemspec.version}.js" 
+task :dist do
+
+  # compile
+  target = _("dist/nibjs-#{$gemspec.version}.js")
+  dist(target)
+  
+  # minimize now
+  target2 = _("dist/nibjs-#{$gemspec.version}.min.js")
+  shell_safe_exec("uglifyjs #{target} > #{target2}")
+  
+end

data/tasks/gem.rake

@@ -0,0 +1,68 @@
+# Installs rake tasks for gemming and packaging
+#
+# This file installs the 'rake package', 'rake gem' tasks and associates 
+# (clobber_package, repackage, ...). It is automatically generated by Noe 
+# from your .noespec file, and should therefore be configured there, under 
+# the variables/rake_tasks/gem entry, as illustrated below:
+#
+# variables:
+#   rake_tasks:
+#     gem:
+#       package_dir: pkg
+#       need_tar: false
+#       need_tar_gz: false
+#       need_tar_bz2: false
+#       need_zip: false
+#       ...
+#
+# If you have specific needs requiring manual intervention on this file, 
+# don't forget to set safe-override to false in your noe specification:
+# 
+# template-info:
+#   manifest:
+#     tasks/gem.rake:
+#       safe-override: false
+#
+begin
+  require 'rubygems/package_task'
+  Gem::PackageTask.new($gemspec) do |t|
+
+    # Name of the package
+    t.name = $gemspec.name
+
+    # Version of the package
+    t.version = $gemspec.version
+    
+    # Directory used to store the package files
+    t.package_dir = "pkg"
+    
+    # True if a gzipped tar file (tgz) should be produced
+    t.need_tar = false
+    
+    # True if a gzipped tar file (tar.gz) should be produced
+    t.need_tar_gz = false
+    
+    # True if a bzip2'd tar file (tar.bz2) should be produced
+    t.need_tar_bz2 = false
+    
+    # True if a zip file should be produced (default is false)
+    t.need_zip = false
+    
+    # List of files to be included in the package.
+    t.package_files = $gemspec.files
+    
+    # Tar command for gzipped or bzip2ed archives.
+    t.tar_command = "tar"
+    
+    # Zip command for zipped archives.
+    t.zip_command = "zip"
+
+  end
+rescue LoadError
+  task :gem do
+    abort 'rubygems/package_task is not available. You should verify your rubygems installation'
+  end
+  task :package do
+    abort 'rubygems/package_task is not available. You should verify your rubygems installation'
+  end
+end

data/tasks/test.rake

@@ -0,0 +1,72 @@
+begin
+  
+  desc "Compile test/nibjs.js"
+  task :"test:dist" do
+    dist(_('test/nibjs.js'))
+  end
+  
+  desc "Compile test/fixture.js" 
+  task :"test:fixture" do
+    shell_safe_exec("coffee --compile --bare -o #{_('test/fixture.js')} #{_('test/fixture.coffee')}")
+  end
+  
+  begin
+    require "rspec/core/rake_task"
+    desc "Run RSpec code examples"
+    RSpec::Core::RakeTask.new(:"test:rspec" => :"test:fixture") do |t|
+      t.pattern = "test/command/*_spec.rb"
+      t.rspec_opts = ["--color", "--backtrace"]
+    end
+  rescue LoadError => ex
+    task :"test:rspec" do
+      abort 'rspec is not available. In order to run spec, you must: gem install rspec'
+    end
+  end
+  
+  desc "Run spec coverage"
+  task :"test:coverage" do
+    shell_safe_exec("rcov #{_('test/command/run.rb')}")
+  end
+
+  desc "Compile test/fixture.min.js"
+  task :"test:fixture.min" => :"test:fixture" do
+    require "fileutils"
+    fix = _('test/fixture.min.js')
+    FileUtils.rm_rf fix
+    shell_safe_exec("./bin/nibjs --libname=fixture --output=#{fix} test/fixture.js")
+  end
+  
+  desc "Run Jasmine spec examples"
+  task :"test:jasmine" do
+    shell_safe_exec("coffee #{_('test/jasmine/run.coffee')}")
+  end
+
+  desc "Run integration tests"
+  task :"test:integration" do
+    shell_safe_exec("coffee --compile #{_('test/integration')}")
+    puts "#"*100
+    puts "Please open the URL below in your browser"
+    puts "#"*100
+    puts shell_safe_exec("ruby #{_('test/integration/integration_test.rb')}").inspect
+  end
+  
+  desc "Bootstrap the test suite (rebuild command/*.exp)"
+  task :"test:bootstrap" => :"test:fixture" do
+    require _("test/command/scenarios")
+
+    def boot_nibjs(options, i)
+      output = _("test/command/#{i}.exp")
+      nibjs(options, "--output=#{output}")
+    end
+    
+    scs = NibJS::Scenarios.new
+    scs.common_tests_with_index{|options, i| boot_nibjs(options, i) }
+    scs.coffee_tests_with_index{|options, i| boot_nibjs(options, i) }
+  end
+  
+ensure
+  task :test => :"test:dist"
+  task :test => :"test:fixture"
+  task :test => :"test:rspec"
+  task :test => :"test:jasmine"
+end

data/tasks/yard.rake

@@ -0,0 +1,51 @@
+# Installs a rake task to generate API documentation using yard.
+#
+# This file installs the 'rake yard' task. It is automatically generated by Noe from 
+# your .noespec file, and should therefore be configured there, under the 
+# variables/rake_tasks/yard entry, as illustrated below:
+#
+# variables:
+#   rake_tasks:
+#     yard:
+#       files: lib/**/*.rb
+#       options: []
+#       ...
+#
+# If you have specific needs requiring manual intervention on this file, 
+# don't forget to set safe-override to false in your noe specification:
+# 
+# template-info:
+#   manifest:
+#     tasks/yard.rake:
+#       safe-override: false
+#
+# This file has been written to conform to yard v0.6.4. More information about 
+# yard and the rake task installed below can be found on http://yardoc.org/
+#
+begin
+  require "yard"
+  desc "Generate yard documentation"
+  YARD::Rake::YardocTask.new(:yard) do |t|
+    # Array of options passed to yardoc commandline. See 'yardoc --help' about this
+    t.options = ["--output-dir", "doc/api", "-", "README.md", "CHANGELOG.md", "LICENCE.md"]
+    
+    # Array of ruby source files (and any extra documentation files 
+    # separated by '-')
+    t.files = ["lib/**/*.rb"]
+    
+    # A proc to call before running the task
+    # t.before = proc{ }
+    
+    # A proc to call after running the task
+    # r.after = proc{ }
+    
+    # An optional lambda to run against all objects being generated. 
+    # Any object that the lambda returns false for will be excluded 
+    # from documentation. 
+    # t.verifier = lambda{|obj| true}
+  end
+rescue LoadError
+  task :yard do
+    abort 'yard is not available. In order to run yard, you must: gem install yard'
+  end
+end

data/test/command/header.js

@@ -0,0 +1 @@
+/* this is a header */