Fala galera!! Realmente precisei do mês de setembro para resolver outras pendências, e isso me impossibilitou de continuar o mini-curso, mas enfim, vamos ao que interessa!
Hoje o assunto será mais light, será sobre uma biblioteca nativa do Node.js responsável por manipular arquivos e diretórios do sistema operacional – File System.

Uma das vantagens dessa API e também de muitas outras nativas do Node.js é a possibilidade de trabalhar tanto de forma bloqueante (sync) quanto não-bloqueante (async), lembrando que é altamente recomendável trabalhar de forma não-bloqueante, afinal essa é a característica principal do Node.js, mas caso queira trabalhar de forma bloqueantes com essa API, simplesmente utilize os métodos com sufixo Sync, por exemplo: fs.openSync() – faz leitura de arquivos em modo bloqueante, ou seja, de forma síncrona.

Veja um exemplo prático abaixo:

var fs = require("fs"); // utilizando API File System

// Lendo conteúdo de um diretório, retornando um array com nome dos arquivos.
// Obs.: Essa função esta lendo de forma Não-Bloqueante, nisso o retorno é via callback.
fs.readdir("/home/user", function(err, files){
    console.log(files);
});

// A mesma função sendo executada de forma Bloqueante.
var files = fs.readdirSync("/home/user");
console.log(files);

Como disse antes e volto a afirmar, para se tirar melhor proveito do processamento I/O do servidor, é recomendado trabalhar com funções não-bloqueantes, afinal, pensem comigo no seguinte cenário: é criado um sistema em Node.js para realizar upload intensivo de arquivos, com isso se utilizar métodos bloqueantes (métodos síncronos), quando houver um erro de leitura ou escrita dos arquivos o sistema todo irá travar, já a utilização dos métodos não-bloqueantes garantirão um processamento assíncrono, fazendo com que qualquer erro não trave o sistema inteiro e permitirá que os demais usuários utilizem normalmente o sistema. Outro detalhe neste cenário é que a resposta será mais rápida para os usuários, afinal o processamento será feito em background, semelhante as requisições AJAX.

No File System muitos dos seus métodos são inspirados em comandos do sistema UNIX, ou seja, algumas funções não funcionarão em um ambiente Windows, por exemplo, realizar a função fs.chown() não funcionará no Windows, visto é uma particularidade do Unix.
Tirando esse detalhe, o essencial da api é compatível com qualquer ambiente operacional.

O que podemos fazer com tudo isso?
Sistemas para upload intesivo de arquivos, Sincronizadores de arquivos, Streaming de audio ou vídeo, muita coisa é possível com essa API, vai depender da sua necessidade e principalmente da sua criatividade.

Vou mostrar em código, um exemplo bacana, uma galeria de fotos, nela o usuário faz upload de fotos e depois são visualizados todas as fotos na página principal.

Primeiro instale as dependências que serão usados neste exemplo:

---

npm install express jade

---

Arquivo app.js

// Utilizaremos apenas as libs: Express, Jade e File System.
var express = require('express');
var fs      = require('fs');
var app     = express();

// Path da pasta pública que armazenará os uploads de fotos.
var path_public = __dirname + '/public';

// Configurações mínimas do Express
app.configure(function(){
	app.set('views', __dirname + '/views');
	app.set('view engine', 'jade');
	app.set('view options', {layout: false});
	app.use(express.static(path_public));
	app.use(express.bodyParser());
	app.use(express.methodOverride());
	app.use(app.router);
});

// Rota principal para renderizar a página inicial.
app.get('/', function(req, res){
	// Retorna um array com os nomes de todos os arquivos
	// da pasta pública.
	fs.readdir(path_public, function(err, fotos){
		res.render('index', {fotos: fotos});
	});
});

// Rota que recebe upload de fotos.
app.post('/enviar-foto', function(req, res){
	var path_atual = req.files.foto.path;
	var path_image = path_public + '/' + req.files.foto.name;
	// Move a foto atual para a pasta pública que recebe os uploads.
	fs.rename(path_atual, path_image, function(err){
		// Exclui a foto de seu local temporário, para evitar duplicidade.
		fs.unlink(path_atual, function(err){
			res.redirect('/');
		});		
	});	
});

app.listen(3000, function() {
   console.log('Galeria de fotos em execucao...');
});

Arquivo index.jade, neste exemplo coloque este arquivo na pasta views:

!!! 5
html
	head
		title Galeria de fotos
		style
			.galeria{
				width: 90%
				margin: 0 auto;
				text-align: center;
			}
			.foto {
				padding: 10px;
				float: left;
			}
	body
		.galeria
			h3 Galeria de fotos
			fieldset
				legend Adicionar foto
				form(action='/enviar-foto', method='post', enctype='multipart/form-data')
					label Foto:
						input(type='file', name='foto')
					button(type='submit') Enviar
			each foto, i in fotos
				.foto
					img(src='/#{foto}', width='240', height='120', border='0', alt='#{foto}')

Pronto e feito! Esse foi mais um capítulo do mini-curso Node.js para leigos, espero que tenham gostado desse artigo, e para melhores detalhes sobre o File System, segue o link da documentação: http://nodejs.org/api/fs.html

Até a próxima!