User:Hashar/cli-js
Note taking mostly. Do not quote me on this stuff!
This page covers installing nodejs and qunit port under Mac OS X and GNU/Linux Debian.
new node-qunit edit
qunit-port is being refactored under github branch 'refactoring'. This include the original QUnit source code but require unstable NodeJS version > 0.5
Possible node modules prerequisites:
- argsparser
- bunker
- cli-table
- chainer
- underscore
- tracejs
- jsdom
- jquery
With home brew, to install them globally with all dependencies use:
$ npm-g install argsparser bunker cli-table chainer underscore tracejs jsdom jquery
More prerequisites might be needed.
nodejs 0.5.9 (homebrew) edit
As of October 18th, homebrew does not ship a NodeJS 0.5 version which is unstable.
NodeJS 0.5.7 and 0.5.8 is missing child_process.fork on Mac OS X 10.7.
You have to add a node-unstable node-unstable formula for this. The provided version come from a Github commit in bramswenson/homebrew fork. I have manually updated it to install version v0.5.9, thus you can add it to your homebrew formula with the command:
Grab the formula from github at https://gist.github.com/1295768 and add it as node-unstable.rb in your brew directory. You will then be able to install NodeJS 0.5.9. Then install that NodeJS using the downloaded formula:
$ brew install node-unstable
Note: you might want to uninstall the previous, stable, node installation with 'brew uninstall node'.
Once installed, make sure you have a v0.5.x node installed:
$ node --version v0.5.9 $
Mac OS X install edit
prerequisites edit
Install language interpreters python 2.7 and node.js. On a Mac OS X Computer, it will be with the port command (see MacPorts):
$ sudo port install python2.7 $ sudo port install node # got me node 0.4.8
Then install "Node Package Manager" (npm) with a small risk of getting hacked in the way:
# curl http://npmjs.org/install.sh | sh
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 3874 100 3874 0 0 8970 0 --:--:-- --:--:-- --:--:-- 13451
fetching: http://registry.npmjs.org/npm/-/npm-1.0.6.tgz
/tmp/npm.50407/package
0.4.8
1.0.6
prefix=/opt/local
This script will find and eliminate any shims, symbolic
links, and other cruft that was installed by npm 0.x.
Is this OK? enter 'yes' or 'no'
yes <--- enter 'yes' and press return :)
All clean!
! [ -d .git ] || git submodule update --init
node cli.js cache clean
node cli.js rm npm -g -f --loglevel error
node cli.js install -g -f
/opt/local/bin/npm -> /opt/local/lib/node_modules/npm/bin/npm.js
node-uuid@1.1.0 /opt/local/lib/node_modules/npm/node_modules/node-uuid
npm@1.0.6 /opt/local/lib/node_modules/npm
It worked
#
Then install node-qunit ( https://github.com/kof/node-qunit ) using the node package manager:
$ sudo npm install qunit > qunit@0.1.5 install ~/node_modules/qunit > make install ... output of ./configure && make && make install argsparser@0.0.5 ./node_modules/qunit/node_modules/argsparser uglify-js@1.0.2 ./node_modules/qunit/node_modules/sharedjs/node_modules/uglify-js sharedjs@0.0.2 ./node_modules/qunit/node_modules/sharedjs qunit@0.1.5 ./node_modules/qunit
setup profile and check installation edit
You should have something like:
$ sudo npm list
/path/to/home
└─┬ qunit@0.1.5
├── argsparser@0.0.5
└─┬ sharedjs@0.0.2
└── uglify-js@1.0.2
$
NPM actually install the requested modules under /path/to/home/node_modules/ and then use a symbolic link to publish the binary. The folder can be found by using npm bin:
$ npm bin /path/to/home/node_modules/.bin $
You might want to append that binary path to your PATH environment variable:
# node.js NODE_PATH="/Users/hashar/node_modules" export PATH=$PATH:"$NODE_PATH/.bin"
At this step, you should be ready to run qunit :
$ which qunit /path/to/home/node_modules/.bin/qunit $ qunit -h Usage: cli [options] value (boolean value can be used) ...
Please use the -h switch when invoking qunit or it might just throw an exception.
Mac OS X (with homebrew) edit
$ brew install node $ brew install npm
Make sure to update your NODE_PATH env variable in your .bashrc. Brew use /usr/local as a prefix, so you should add:
export NODE_PATH="/usr/local/lib/node_modules"
Then install the node module globally with npm-g (alias set up by homebrew):
$ npm-g install qunit
This will install the stable version. As of October 18th 2011, this mean using an outdated QUnit port which do not support stop(timeout) method.
GNU/Linux (Debian) edit
As of July 2011, you have to use unstable release to install node and npm. You can backport unstable packages in your testing release by adding unstable in your /etc/apt/sources.list and updating your /etc/apt/preferences:
/etc/apt/sources.list
# Please note the URL http://ftp.free.fr/mirrors/ftp.debian.org/ might be different # for your local setup. The important thing is adding a line with 'unstable' :) # Testing source list: deb http://ftp.free.fr/mirrors/ftp.debian.org/ testing main contrib non-free # Unstable source list: deb http://ftp.free.fr/mirrors/ftp.debian.org/ unstable main contrib non-free
/etc/apt/preferences
Package: * Pin: release a=testing Pin-Priority: 900 Package: * Pin: release o=debian Pin-Priority: -10
Then update using apt-get update and install the package with the target unstable:
$ apt-get install -t unstable nodejs npm
Debian should take care of everything for you. Then install qunit:
$ npm install qunit <snip> $
Debian install symbolic links in your ~/bin . Make sure it is in your PATH. You will end up with something like:
$ ls -l ~/bin/qunit* lrwxrwxrwx 1 hashar hashar 13 16 juil. 19:46 /home/hashar/bin/qunit -> ./qunit@0.1.5* -rwxr-xr-x 1 hashar hashar 708 16 juil. 19:46 /home/hashar/bin/qunit@0.1.5* $
Jquery and DOM edit
Install Jquery and a javascript DOM for node is really easy, using the Node Package Manager of course!
jQuery for node:
$ npm install jquery htmlparser@1.7.3 ./node_modules/jquery/node_modules/htmlparser mjsunit.runner@0.1.3 ./node_modules/jquery/node_modules/jsdom/node_modules/mjsunit.runner request@1.9.5 ./node_modules/jquery/node_modules/jsdom/node_modules/request jsdom@0.1.20 ./node_modules/jquery/node_modules/jsdom jquery@1.5.1 ./node_modules/jquery $
DOM in node:
$ npm install jsdom request@1.9.5 ./node_modules/jsdom/node_modules/request htmlparser@1.7.3 ./node_modules/jsdom/node_modules/htmlparser jsdom@0.2.0 ./node_modules/jsdom $
Verifying install edit
We will do the first node run and verify jQuery and DOM seems fine.
Create a JavaScript file with the following content (From https://github.com/coolaj86/node-jquery) :
var jsdom = require( 'jsdom' ).jsdom,
newWindow = jsdom().createWindow(),
$ = require( 'jquery' ),
jQuery = require( 'jquery' ).create( newWindow );
$("<h1>test passes</h1>").appendTo("body");
console.log( $("body").html() )
Then run the above code using node:
$ node qunit_start.js <h1>test passes</h1> $
Congratulations! You have everything needed :-)