ESLint is hosted at GitHub and uses Git for source control. In order to obtain the source code, you must first install Git on your system. Instructions for installing and setting up Git can be found at http://help.github.com/set-up-git-redirect.
If you simply want to create a local copy of the source to play with, you can clone the main repository using this command:
git clone git://github.com/eslint/eslint.git
If you’re planning on contributing to ESLint, then it’s a good idea to fork the repository. You can find instructions for forking a repository at http://help.github.com/fork-a-repo/. After forking the ESLint repository, you’ll want to create a local copy of your fork.
Before you can get started developing, you’ll need to have a couple of things installed:
Once you have a local copy and have Node.JS and npm installed, you’ll need to install the ESLint dependencies:
cd eslint npm install
Now when you run
eslint, it will be running your local copy and showing your changes.
Note: It’s a good idea to re-rerun
npm install whenever you pull from the main repository to ensure you have the latest development dependencies.
The ESLint directory and file structure is as follows:
bin- executable files that are available when ESLint is installed
conf- default configuration information
docs- documentation for the project
lib- contains the source code
formatters- all source files defining formatters
rules- all source files defining rules
tests- the main unit test folder
lib- tests for the source code
formatters- tests for the formatters
rules- tests for the rules