@dpwolfe/dos2unix

A Node.js module to convert text files with DOS line breaks to Unix line breaks, i.e. like using `dos2unix`.

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
@dpwolfe/dos2unix
1671.1.37 years ago7 years agoMinified + gzip package size for @dpwolfe/dos2unix in KB

Readme

Build Status
dos2unix
A Node.js module to convert text files with DOS line breaks to Unix line breaks, i.e. like using dos2unixdos2unix. The module also supports cross-platform globbing patterns.

Getting Started

Install the module with: npm install dos2unix
var D2UConverter = require('dos2unix').dos2unix;
var d2u = new D2UConverter({ glob: { cwd: __dirname } })
  .on('error', function(err) {
    console.error(err);
  })
  .on('end', function(stats) {
    console.log(stats);
  });
d2u.process(['docs/*']);

Examples

// Reference the module
var D2UConverter = new require('dos2unix').dos2unix;

// Setup default options
var defaultOptions = {
  glob: {
    cwd: __dirname
  },
  maxConcurrency: 50
};

// Create a new `dos2unix` instance and add important event listeners
var d2u = new D2UConverter(defaultOptions)
  .on('error', function(err) {
    console.error(err);
  })
  .on('end', function(stats) {
    console.log(stats);
  });

// Convert line endings of a single non-binary, non-irregular file from
// '\r\n' to '\n'.
d2u.process(['docs/README.txt']);

// Convert the line endings of multiple non-binary, non-irregular files from
// '\r\n' to '\n'.
d2u.process(['docs/README.txt', 'examples/HelloWorld.js']);

// Convert the line endings of all non-binary and non-irregular files in the
// 'docs' directory (non-recursively) from '\r\n' to '\n'.
d2u.process(['docs/*']);

// Convert the line endings of all non-binary and non-irregular files under the
// 'examples' directory (RECURSIVELY) from '\r\n' to '\n'.
d2u.process(['examples/**/*']);

// Convert the line endings of all non-binary and non-irregular files in the
// 'docs' directory (non-recursively) AND the same type of files under the
// 'examples' directory (RECURSIVELY) from '\r\n' to '\n'.
d2u.process(['docs/*', 'examples/**/*']);

// Override the globbing options (per the `glob` module's documentation)
var globOptions = {
  glob: {
    cwd: 'docs'
  }
};
d2u.process(['*.txt'], globOptions);

Events

- start - processing.start - processing.skip - convert.start - convert.error / convert.end - processing.error / processing.end - error / end

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.

Release History

- 1.1.1: Published to NPM on 2013-05-31.
- Set the `maxConcurrency` config default value to `0` ("unlimited"). Also updated a little code
  so that a `maxConcurrency` config value of `0` or less will result in "unlimited", i.e. process
  the whole array of globbed files at once.
- 1.1.0: Published to NPM on 2013-05-31.
- Added the `maxConcurrency` config options to throttle how many files can be processed
  simultaneously. This helps avoid issues across the board as most systems have an implicit
  number of file handles that can be opened as once. It also provides those running on
  hardware with limited resources to maintain better control of consumption.
- Under the covers: swapped in the `async` module to replace `q`, particularly for its
  `parallelLimit` function.
- 1.0.2: Published to NPM on 2013-05-25.
- Now omitting directories from the glob results as trying to convert their non-existent line
  endings throws errors.
- 1.0.1: Published to NPM on 2013-05-01.
- Converted 1 stray `console.error` call to an event emission as intended.
- 1.0.0: Published to NPM on 2013-05-01.
- Completely remade: redid the whole API to be an EventEmitter, gutted the implementation, etc.
- 0.3.0: Published to NPM on 2013-04-03.
- Hardened the unit tests, which led to exposing and fixing a critical bug in the `dos2unix`
  conversion implementation.
- 0.2.2: Published to NPM on 2013-04-02.
- Changed tests to write to the OS tmpdir instead of local to the repo, hopefully this fixes
  the Travis-CI build.
- Also patched a globbing issue where all paths were relative to the CWD even if the `glob`
  command was executed relative to a different directory.
- 0.2.1: Published to NPM on 2013-04-02.
- README fixes.
- 0.2.0: Published to NPM on 2013-04-02.
- Initial release.

License

Copyright (c) 2013 James M. Greene
Licensed under the MIT license.