Features/NodeJS

Node.js

Summary

The Node.js JavaScript runtime and associated ecosystem, including the npm package manager.

Owner

• Name: Adrian Alves, Stephen Gallagher, T.C. Hollingsworth

• Email: alvesadrian@fedoraproject.org, sgallagh@fedoraproject.org, tchollingsworth@gmail.com

People Involved - Packagers/Volunteers/Contributors

Name	IRC	Current work	Additional info
Michael Scherer	misc	Maniac package reviewer	UTC+2
Miro Hrončok	mhroncok	Reviewer	UTC+1
Eduardo Echeverría	echevemaster	Reviewer	UTC-4:30
Jamie Nguyen	jamielinux	Reviewer	UTC
Marcelo Barbosa	firemanxbr	Reviewer	UTC-3

Current status

• Targeted release: Fedora 19
• Last updated: 2013-03-11
• Percentage of completion: 100%

Detailed Description

Node.js is a platform built on Chrome's JavaScript runtime for easily building fast, scalable network applications. Node.js uses an event-driven, non-blocking I/O model that makes it lightweight and efficient, perfect for data-intensive real-time applications that run across distributed devices.

Benefit to Fedora

Node.js is a very popular development and deployment ecosystem. By providing Node.js in Fedora, we increase our portfolio of software development tools. By catering to Node.js developers, we have an opportunity to bring in new developer talent to Fedora.

Scope

As of 2012-12-18, the major work for the runtime of Node.js is complete and committed to Rawhide. The remaining work is around building up the surrounding ecosystem, most notably with the addition of the npm (Node-packaged modules) package manager and developing packaging guidelines around it.

As of 2012-01-08, reviews for npm and its dependency chain and draft packaging guidelines are being composed.

As of 2013-03-08, packaging guidelines have been approved by FPC and npm is in Rawhide and F18 updates-testing. The unstable version currently packaged in Fedora is scheduled to be released stable on 2013-03-11, at which point this feature will be complete.

As of 2013-03-11 Node.js upstream has released 0.10.0 and it has been built for Rawhide, along with the accompanying versions of libuv, v8 and npm. I'm leaving the Feature at 95% until we confirm that none of the other node-* packages require rebuilding to consume this new stable release. Otherwise, I believe this Feature to be complete. Sgallagh (talk) 23:30, 11 March 2013 (UTC)

How To Test

Once complete, testing should be as simple as running npm install <module> and verifying that it behaves in the way the documentation for that module indicates. The npm registry homepage has lists of new and popular packages you can try out.

Test that a simple javascript program can be run

 # yum install nodejs

 $ echo 'console.log("Hello World");' > /tmp/hello.js
 $ node /tmp/hello.js

This should display "Hello World!"

Test that npm work and that rpm package are seen by npm

 # yum install npm  nodejs-mkdirp

 $ npm list -g | grep mkdirp

This should show mkdirp version

Test that modules installed by rpm are usable by nodejs

 # yum install npm  nodejs-mkdirp

 $ mkdir /tmp/hello

 $ cd /tmp/hello

 $ npm link mkdirp

 $ cat > hello.js <<EOF
 var mkdirp = require('mkdirp');
 
 mkdirp('/tmp/foo/bar/baz', function (err) {
   if (err) console.error(err)
   else console.log('pow!')
 });
 EOF

 $ node hello.js

A folder /tmp/foo/bar/baz should now exist

User Experience

The availability of the Node.js runtime and the npm package manager will be visible to developers, who will now have the opportunity to deploy Node.js applications on their Fedora systems. And this will also benefit to users, who will be able to use more easyly software like etherpad-lite or ethercalc directly on Fedora with the tradional security support offered by the distribution.

Dependencies

No other existing packages depend on this, though there are many Node-packaged modules such as less.js and some newer JQuery modules that will become available to Fedora now that we have the framework.

Contingency Plan

No contingency plan necessary. If it's not ready, the feature can be removed from the documentation until a future release. It does not impact any core functionality of the system.

Documentation

• Node.js API documentation: http://nodejs.org/api/ or in the nodejs-docs RPM.
• npm documentation: https://npmjs.org/doc/ or man npm

Release Notes

Fedora 19 now includes the Node.js JavaScript runtime environment for developing fast, scalable network applications using the JavaScript programming language. Also included is the npm package manager that provides access to over 20,000 libraries and applications available under free and open source licenses.

Comments and Discussion

• See Talk:Features/NodeJS