nibjs 1.0.0 → 1.1.0

data/lib/nibjs/version.rb

@@ -2,7 +2,7 @@ module NibJS
   module Version
   
     MAJOR = 1
-    MINOR = 0
+    MINOR = 1
     TINY  = 0
   
     def self.to_s

data/nibjs.noespec

@@ -14,7 +14,7 @@ variables:
   upper:
     NibJS
   version:
-    1.0.0
+    1.1.0
   summary: 
     nib.js - Package and embed node.js or coffeescript libraries in the browser
   description: |-

data/src/nibjs.coffee

@@ -1,124 +1,121 @@
 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: []
+  #
+  # 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: []
 
-    # 
-    # Built packages.
-    #
-    # Once the package are built (lazily, at first 'require' invocation), the
-    # results is put in the following array for subsequent requiring.
-    #
-    packages: []
+  #
+  # Checks if a package is known.
+  #
+  hasPackage: (name)->
+    NibJS.pkgBuilders[name]? || NibJS.packages[name]?
+
+  #
+  # 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
 
-    #
-    # 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)
   
-    #
-    # 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)->
+  #
+  # Internal implementation of require, when invoked the first time on
+  # a given library.
+  #  
+  _build_one: (name)->
+    if NibJS.pkgBuilders[name]
       builder = new Builder
       NibJS.pkgBuilders[name](builder)
+    else
+      throw new Exception("NibJS error: no module '#{name}' has been previously registered.")
 
-    # Application control
-    pending: []
+}
 
-    running: []
+class Exception extends Error
+  constructor: (@message)->
 
-    ready: (fn)->
-      NibJS.pending.push(fn)
+#
+# 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
 
-    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
-    
-  }
+  #
+  # Builds a builder instance
+  #
+  constructor: ()->
+    @builders = []
+    @built = []
 
   #
-  # Intra-package builder, passed as first argument of NibJS.define
+  # Register a builder function for _file_.
   #
-  # This builder helps registrering functions for building individual
-  # files, as well as requiring them.
+  # 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.
   #
-  class Builder
+  register: (file, builder)=>
+    @builders[file] = 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)
 
-    #
-    # 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
+  #
+  # Private functions that ensures the building of a file.
+  #
+  build_file: (file)=>
+    if @builders[file]?
+      file_exp = {}
+      @builders[file](file_exp, this.require)
+      file_exp
+    else
+     throw new Exception("NibJS error: no such file #{file}")

data/tasks/analytics.txt

@@ -0,0 +1,10 @@
+<script type="text/javascript">
+  var _gaq = _gaq || [];
+  _gaq.push(['_setAccount', 'UA-16520635-4']);
+  _gaq.push(['_trackPageview']);
+  (function() {
+    var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+    ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+    var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+  })();
+</script>

data/tasks/examples.rake

@@ -0,0 +1,25 @@
+def each_example
+  Dir[_('examples/*')].each{|dir|
+    next unless File.directory?(dir)
+    next if File.basename(dir) == "public"
+    File.basename(dir) =~ /\d-(.*)$/
+    js_file = File.join(dir, "#{$1}.js")
+    yield(dir, js_file)
+  }
+end
+
+desc "Cleans the examples test suite"
+task :"examples:clean" do
+  require 'fileutils'
+  FileUtils.rm_rf _('examples/public/TestSuite.js')
+  each_example{|dir, js_file| FileUtils.rm_rf js_file}
+end
+
+desc "Rebuilds the whole examples test suite" 
+task :"examples:build" => :"examples:clean" do
+  shell_safe_exec("coffee --compile --bare #{_('examples/public/TestSuite.coffee')}")
+  dist(_('examples/public/nibjs.js'))
+  each_example do |dir, js_file|
+    shell_safe_exec(File.join(dir, "build"))
+  end
+end

data/tasks/gh-pages.rake

@@ -0,0 +1,15 @@
+desc "Builds the github pages"
+task :pages do
+  shell_safe_exec("cp -R #{_('examples/*')} #{_('gh-pages')}")
+  shell_safe_exec("rm -rf #{_('gh-pages/illustrations.graffle')}")
+  
+  analytics = File.read(File.expand_path('../analytics.txt', __FILE__))
+  analytics.gsub!(/^/m, '    ')
+  Dir[_("gh-pages/**/index.html")].each{|file|
+    puts "On #{file}"
+    content = File.read(file)
+    content.gsub!(/^\s*<\/body>/, analytics + "  </body>")
+    File.open(file, 'w'){|io| io << content}
+  }
+  shell_safe_exec("cd #{_('gh-pages')} && git commit -a -m 'Regenerated doc.' && git push origin")
+end

data/tasks/test.rake

@@ -42,12 +42,11 @@ begin
   end
 
   desc "Run integration tests"
-  task :"test:integration" do
-    shell_safe_exec("coffee --compile #{_('test/integration')}")
+  task :"test:integration" => :"examples:build" do
     puts "#"*100
     puts "Please open the URL below in your browser"
     puts "#"*100
-    puts shell_safe_exec("ruby #{_('test/integration/integration_test.rb')}").inspect
+    puts shell_safe_exec("ruby #{_('examples/handler.rb')}").inspect
   end
   
   desc "Bootstrap the test suite (rebuild command/*.exp)"

data/test/command/footer.js

@@ -0,0 +1 @@
+/* and this is a footer */

data/test/command/sc_coffee_6.exp

@@ -0,0 +1,106 @@
+/**
+ * nib.js - [Java/Coffee]script application packager from node.js conventions
+ * 
+ * Copyright 2011, Bernard Lambeau
+ * Released under the MIT License
+ * http://github.com/blambeau/nib.js
+ */
+(function(exports){
+  var Builder, Exception;
+  var __hasProp = Object.prototype.hasOwnProperty, __extends = function(child, parent) {
+    for (var key in parent) { if (__hasProp.call(parent, key)) child[key] = parent[key]; }
+    function ctor() { this.constructor = child; }
+    ctor.prototype = parent.prototype;
+    child.prototype = new ctor;
+    child.__super__ = parent.prototype;
+    return child;
+  }, __bind = function(fn, me){ return function(){ return fn.apply(me, arguments); }; };
+  exports.NibJS = {
+    pkgBuilders: [],
+    packages: [],
+    hasPackage: function(name) {
+      return (NibJS.pkgBuilders[name] != null) || (NibJS.packages[name] != null);
+    },
+    define: function(name, buildFn) {
+      return NibJS.pkgBuilders[name] = buildFn;
+    },
+    require: function(name) {
+      var _base, _ref;
+      return (_ref = (_base = NibJS.packages)[name]) != null ? _ref : _base[name] = NibJS._build_one(name);
+    },
+    _build_one: function(name) {
+      var builder;
+      if (NibJS.pkgBuilders[name]) {
+        builder = new Builder;
+        return NibJS.pkgBuilders[name](builder);
+      } else {
+        throw new Exception("NibJS error: no module '" + name + "' has been previously registered.");
+      }
+    }
+  };
+  Exception = (function() {
+    __extends(Exception, Error);
+    function Exception(message) {
+      this.message = message;
+    }
+    return Exception;
+  })();
+  Builder = (function() {
+    function Builder() {
+      this.build_file = __bind(this.build_file, this);;
+      this.require = __bind(this.require, this);;
+      this.register = __bind(this.register, this);;    this.builders = [];
+      this.built = [];
+    }
+    Builder.prototype.register = function(file, builder) {
+      return this.builders[file] = builder;
+    };
+    Builder.prototype.require = function(file) {
+      var _base, _ref;
+      return (_ref = (_base = this.built)[file]) != null ? _ref : _base[file] = this.build_file(file);
+    };
+    Builder.prototype.build_file = function(file) {
+      var file_exp;
+      if (this.builders[file] != null) {
+        file_exp = {};
+        this.builders[file](file_exp, this.require);
+        return file_exp;
+      } else {
+        throw new Exception("NibJS error: no such file " + file);
+      }
+    };
+    return Builder;
+  })();
+}).call(this, this);
+
+NibJS.define('fixture', function(nibjs) {
+  nibjs.register('./app', function(exports, require) {
+    var App;
+    exports.App = App = (function() {
+      function App() {}
+      App.prototype.say_hello = function() {
+        return "Hello from App";
+      };
+      return App;
+    })();
+    return exports;
+  });
+  nibjs.register('./dependent', function(exports, require) {
+    var App, Dependent;
+    App = require('./app').App;
+    exports.Dependent = Dependent = (function() {
+      function Dependent() {}
+      Dependent.prototype.say_hello = function() {
+        return "Hello from Dependent";
+      };
+      return Dependent;
+    })();
+    return exports;
+  });
+  nibjs.register('./index', function(exports, require) {
+    exports.App = require('./app').App;
+    exports.Dependent = require('./dependent').Dependent;
+    return exports;
+  });
+  return nibjs.require('./index');
+});

data/test/command/sc_coffee_7.exp

@@ -0,0 +1,151 @@
+NibJSBuild = (exports)->
+  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: []
+  
+    #
+    # Checks if a package is known.
+    #
+    hasPackage: (name)->
+      NibJS.pkgBuilders[name]? || NibJS.packages[name]?
+  
+    #
+    # 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)->
+      if NibJS.pkgBuilders[name]
+        builder = new Builder
+        NibJS.pkgBuilders[name](builder)
+      else
+        throw new Exception("NibJS error: no module '#{name}' has been previously registered.")
+  
+  }
+  
+  class Exception extends Error
+    constructor: (@message)->
+  
+  #
+  # 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)=>
+      if @builders[file]?
+        file_exp = {}
+        @builders[file](file_exp, this.require)
+        file_exp
+      else
+       throw new Exception("NibJS error: no such file #{file}")
+NibJSBuild(this)
+
+
+NibJS.define 'fixture', (nibjs)->
+  nibjs.register './app', (exports, require)->
+    exports.App = class App
+      
+      say_hello: ->
+        "Hello from App"
+    
+    return exports
+  
+  nibjs.register './dependent', (exports, require)->
+    {App} = require('./app')
+    
+    exports.Dependent = class Dependent
+      
+      say_hello: ->
+        "Hello from Dependent"
+    
+    return exports
+  
+  nibjs.register './index', (exports, require)->
+    exports.App = require('./app').App
+    exports.Dependent = require('./dependent').Dependent
+    return exports
+
+  nibjs.require './index'
+fixture = NibJS.require 'fixture'