neuronjs

Neuron is a very simple CommonJS module loader.

npm install neuronjs
20 downloads in the last day
152 downloads in the last week
689 downloads in the last month

Neuron Build Status

First of all, neuron is not designed for human developers to use directly. Most usually, it works together with cortex.

Neuron is a very simple CommonJS module loader which is used by dianping.com, and will be more powerful if working with Cortex.

  • Implements commonjs Module/1.0 standard.
  • Fully supports SemVer and SemVer ranges: '^a.b.c', '~a.b.c', '>=a.b.c', etc.
  • Implements require.resolve() which is similar to node.js.

Neurons are the core components of the nervous system. They processes and transmits chemical signals to others as well as javascript modules work with others by passing runtime objects.

With Cortex and Neuron, we write web modules exactly the same as we work with node.js, with no Module/Wrappings, no *MD, etc.

You could remove all those annoying and noisy things out of your mind, and, just focus on the origin and code your web modules like node.js.

Neuron is designed to run in the background without your concern, UNLIKE RequireJS and many other loaders.

We're trying to return to the origin of commonjs. There should be only ONE standard, that is, Module/1.0.


NPM module: neuronjs

A package to get the JavaScript file of neuron.

var neuron = require('neuronjs');
neuron.version(); // 6.0.0
neuron.content(function(err, content){
  content; // The file content of neuron.js
});

neuron.version();

Returns String the version of neuron for browsers, not the version of npm module neuronjs

neuron.write(dest, callback)

  • dest path
  • callback function(err)

Writes the content of neuron.js to the dest

neuron.content(callback)

  • callback function(err, content)
  • content Buffer the buffer of the content of neuron.js

Gets the content of neuron.js


Neuron Loader for Browsers

Getting Started

Installation

npm install
grunt

Usage

Frequent configurations, for more, just see Configuration Hierarchies section.

<script src="/dist/neuron.js"></script>
<script>
neuron.config({
    path: 'http://localhost/mod'
});
</script>

For the example above:

module 'abc@0.1.1' will be located at 'http://localhost/mod/abc/0.1.1/abc.js'

Methods

require(id)

  • id String module identifier.

To require modules. See CommonJS Module/1.0

require.async(id, callback)

  • id String module identifier.
  • callback function(exports) callback must be passed, or require.async will do nothing.

Asynchronously loads a module by id, and then passes the module exports to callback.

You should always pass the callback parameter because neuron can not make sure the exact time when a module is loaded asynchronously.

It is NOT a good practice if the logic of your code relies on the result of the require.async()d module without a callback.

require.resolve(path)

  • path String the relative path to be resolved according to the current module.

Returns the resolved absolute path of the resource.

Returns undefined if path is not a relative path.

Returns undefined if path is even outside the current package.

define()

With cortex, you might NEVER use this method.

define(identifier, dependencies, factory, options);

facade()

facade(identifier);

facade({
    mod: identifier,
    data: data
});

Method facade loads a module. If the module.exports has a method named init, facade method will run the init method.

We call this kind of modules as facade modules

identifier String

module name with version, seperated with '@'. For example: 'async@0.1.0'

data Object

If data is defined, data will be passed as the parameter of the init method.


Developer Guide

Neuron CORE supplies no high-level APIs, which means that neuron core only cares about module dependencies and module wrapping while will do nothing about things such as fetching modules from remote server and injecting them into the current document, and never cares about where a specific module should come from.

You could do all these things in your will (by write your own lib/load.js and adjust Gruntfile.js). Nevertheless, neuron have a basic configuration file which located at lib/load.js.

Configuration

neuron.config(settings);

settings.path String

CommonJS module path, like NODE_PATH, default to 'the root directory of neuronjs'.

Pay attension that path will not be resolved to absolute url. So if you don't want a relative path, don't forget 'http://'.

settings.loaded String|Array.<id>

To tell neuron loader that those modules are already loaded, and prevent duplicate loading.

If String, we can separate different ids with '|' (comma).

neuron.config({
    loaded: ['jquery@1.9.2', 'async@0.2.9']
});

settings.tree Object

Tree of the simple shrinkwrap, could be parsed by neuron-tree.

<name>: {
  <version>: {
    <dep-name>: [
      {
        <sync-dep-range>: <sync-dep-version>
      },
      {
        <async-dep-range>: <async-dep-version>
      }
    ]
  }
}

settings.ext String

Defines the file extension of the module file, default to '.js'.

Sometimes you want to load compressed files, then you can set it to '.min.js' or something.

npm loves you