Skip to content

Repository files navigation

The canonical location of this project is now gulp-community/gulp-header.

gulp-header

npm versionActions StatusCode CoverageDependency StatusGithub IssuesMIT License

gulp-header is a Gulp extension to add a header to file(s) in the pipeline. Gulp is a streaming build system utilizing node.js.

Install

npminstall--save-devgulp-header

Usage

// assign the module to a local variablevarheader=require('gulp-header');// literal string// NOTE: a line separator will not be added automaticallygulp.src('./foo/*.js').pipe(header('Hello')).pipe(gulp.dest('./dist/'))// ejs style templatinggulp.src('./foo/*.js').pipe(header('Hello <%= name %>\n',{name : 'World'})).pipe(gulp.dest('./dist/'))// ES6-style template stringgulp.src('./foo/*.js').pipe(header('Hello ${name}\n',{name : 'World'})).pipe(gulp.dest('./dist/'))// using data from package.jsonvarpkg=require('./package.json');varbanner=['/**',' * <%= pkg.name %> - <%= pkg.description %>',' * @version v<%= pkg.version %>',' * @link <%= pkg.homepage %>',' * @license <%= pkg.license %>',' */',''].join('\n');gulp.src('./foo/*.js').pipe(header(banner,{pkg : pkg})).pipe(gulp.dest('./dist/'))// reading the header file from diskvarfs=require('fs');gulp.src('./foo/*.js').pipe(header(fs.readFileSync('header.txt','utf8'),{pkg : pkg})).pipe(gulp.dest('./dist/'))// for use with coffee-scriptreturngulp.src(['src/*.coffee',]).pipe(header(banner,{pkg : pkg})).pipe(sourcemaps.init())// init sourcemaps *after* header.pipe(coffee({bare: true})).pipe(sourcemaps.write('.')).pipe(gulp.dest('dist/js'))

Issues and Alerts

My handle on twitter is @tracker1 - If there is an urgent issue, I get twitter notifications sent to my phone.

API

header(text, data)

text

Type: String Default: ''

The template text.

data

Type: Object Default: {}

The data object used to populate the text.

In addition to the passed in data, file will be the stream object for the file being templated against and filename will be the path relative from the stream's basepath.

NOTE: using false will disable template processing of the header

About

Gulp extension to add a header to file(s) in the pipeline

Resources

Stars

106 stars

Watchers

9 watching

Forks

Releases

Packages

Used by

Contributors

Languages