vinyl-http

Unreleased v0.0.0

Information

Package	vinyl-http
Description	Vinyl adapter for HTTP
Node Version	>= 0.10

Purpose

This vinyl adapter allows you to either either post or receive streams of vinyl from an HTTP server.

This enables the ability to quickly push or retrieve streams of files to or from remote sources.

An HTTP server component is require and shipped with this module, it can be used as a stand-alone server or as middleware for your existing http server.

Alternatives to using this module could be gulp-sftp, but that would necessitate an open ssh server while vinyl-http requires only an open http server.

Usage

Start the server

var server = require('vinyl-http').createServer();
server.listen(8888);

Sending files

var map = require('map-stream');
var fs = require('vinyl-fs');
var vhttp = require('vinyl-http');
 
var log = function(file, cb) {
  console.log(file.path);
  cb(null, file);
};
 
fs.src('test/fixtures/*.js') 
.pipe(vhttp.dest('/upload', {
  uri: "http://localhost:8888/"
}))
.pipe(map(log))

Retrieving files

var map = require('map-stream');
var fs = require('vinyl-fs');
 
var log = function(file, cb) {
  console.log(file.path);
  cb(null, file);
};
 
vhttp.src('test/fixtures/*.js', {
  uri: "http://localhost:8888/"
})
.pipe(map(log))
.pipe(vfs.dest('./download'));
 

API

src(globs[, opt])

• Takes a glob string or an array of glob strings as the first argument.
  • uri - Specify the base uri
• Returns a Readable/Writable stream.
• On write the stream will simply pass items through.
• This stream emits matching [vinyl] File objects

watch(globs[, opt, cb])

As of v0.0.0, not implemented yet.

dest(folder[, opt])

• Takes a folder path as the first argument.
• Possible options for the second argument:
  • uri - Specify the base uri
• Returns a Readable/Writable stream.

TODO

• Add Tests
• Investigate adding compression
• Investigate implementing watch method
• Add protection for directory traversals on server