editorconfig

What is editorconfig?

The editorconfig npm package is used to parse and apply editor configuration from .editorconfig files. These files are designed to maintain consistent coding styles across different editors and IDEs for a project. The package helps in reading the .editorconfig file and applying the configurations to the code editor.

What are editorconfig's main functionalities?

Parse .editorconfig files

This feature allows you to parse an .editorconfig file to retrieve the configurations for a given file path. The parse function returns a promise that resolves with the configuration object.

const editorconfig = require('editorconfig');
editorconfig.parse(filePath).then(config => {
  console.log(config);
});

Parse from a specific position in a file

This feature is useful when you want to get the configuration that applies from a specific line number in a file. It can be helpful when dealing with files that may have different configurations at different positions.

const editorconfig = require('editorconfig');
editorconfig.parse(filePath, { start: lineNumber }).then(config => {
  console.log(config);
});

Generate editor configurations

This feature allows you to generate the contents of an .editorconfig file based on a given configuration object. The generate function returns a promise that resolves with the string content of the .editorconfig file.

const editorconfig = require('editorconfig');
const configs = {
  indent_style: 'space',
  indent_size: 2
};
editorconfig.generate(configs).then(content => {
  console.log(content);
});

Other packages similar to editorconfig

prettier

Prettier is an opinionated code formatter that supports many languages and integrates with most editors. Unlike editorconfig, which focuses on maintaining consistent coding styles, Prettier reformats your code according to its own set of rules, which can be customized.

eslint

ESLint is a tool for identifying and reporting on patterns found in ECMAScript/JavaScript code. It is more comprehensive than editorconfig as it can enforce coding standards and also find problematic patterns or code that doesn’t adhere to certain style guidelines.

stylelint

Stylelint is a modern linter that helps you avoid errors and enforce conventions in your stylesheets. It is similar to editorconfig but is specifically designed for CSS, SCSS, and other styling languages, offering more detailed control over style rules.

README

EditorConfig JavaScript Core

The EditorConfig JavaScript core will provide the same functionality as the EditorConfig C Core and EditorConfig Python Core.

Installation

You need node to use this package.

To install this package (system-wide):

sudo npm install -g .

Usage

Usage as a Node library:

$ node
> var editorconfig = require('./editorconfig');
undefined
> editorconfig.parse('/home/zoidberg/humans/anatomy.md');
{ charset: 'utf-8',
  insert_final_newline: 'true',
  end_of_line: 'lf',
  tab_width: '8',
  trim_trailing_whitespace: 'sometimes' }

Usage as a command line tool:

$ ./bin/editorconfig

  Usage: editorconfig [OPTIONS] FILEPATH1 [FILEPATH2 FILEPATH3 ...]

  EditorConfig Node.js Core Version 0.11.4-development

  FILEPATH can be a hyphen (-) if you want path(s) to be read from stdin.

  Options:

    -h, --help     output usage information
    -V, --version  output the version number
    -f <path>      Specify conf filename other than ".editorconfig"
    -b <version>   Specify version (used by devs to test compatibility)

Example:

$ ./bin/editorconfig /home/zoidberg/humans/anatomy.md
charset=utf-8
insert_final_newline=true
end_of_line=lf
tab_width=8
trim_trailing_whitespace=sometimes

Development

To install dependencies for this package run this in the package directory:

npm install

To test the command line interface:

./bin/editorconfig <filepath>

Testing

CMake must be installed to run the tests.

To run the tests:

npm test

To run the tests with increased verbosity (for debugging test failures):

ctest -VV --output-on-failure .