Project

eslint-rails

0.06
Repository is archived
No commit activity in last 3 years
No release in over 3 years
There's a lot of open issues
eslint-railsappfolio/eslint-railsHomepageDocumentationSource CodeBug TrackerWiki
A Rails wrapper for ESLint.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
1,060,664
Stars
39
Forks
21
Watchers
139
 Releases
Current version
1.3.0
Total releases
11
First release
2015-03-16
Latest release
2017-05-07
 Issues
Open Issues
11
Closed Issues
8
Total Issues
19
Issue Closure Rate
42%
 Pull Requests
Open Pull Requests
6
Closed Pull Requests
4
Merged Pull Requests
12
Pull Request Acceptance Rate
54%
 Development
Primary Language
Ruby
Licenses
MIT
Average date of last 50 commits
2016-05-16
Reverse Dependencies
0

 Dependencies

Development

bundler
~> 1.7
rake
~> 10.0
therubyracer
>= 0

Runtime

colorize
>= 0
execjs
>= 0
railties
>= 3.2
 Project Readme

eslint-rails

Run ESLint against your Rails repo. The supported javascript file extensions are the following:

  • .js
  • .jsx
  • .es6

Installation

Add this line to your application's Gemfile:

gem 'eslint-rails'

Configuration

To customize configuration, place an eslint config file in your app's config/eslint.json.

You can print the configuration thusly:

# Print the configuration that we're using. If there's a custom configuration
# present, print that; if not, print the default configuration.
rake eslint:print_config

# Or print the default configuration even if a custom one exists.
rake eslint:print_config[true]

You can also retrieve the current eslint.json by visiting /eslint/eslint.json in your browser. To force retrieval of the default conguration, use /eslint/eslint.json?force_default=true.

Usage

CLI

rake-eslint-rails-run

This will analyze all of the javascript files in the project:

rake eslint:run_all

Or you can run it on a single file. This will analyze application.js:

rake eslint:run

Or, you can supply a filename to the task, using several different formats, and it will lint just that file. For example, to analyze app/assets/javascripts/components/utilities.js, you can run any of the following:

rake eslint:run[components/utilities]
rake eslint:run[components/utilities.js]
rake eslint:run[app/assets/javascripts/components/utilities]
rake eslint:run[app/assets/javascripts/components/utilities.js]

Web interface

On non-production environments, visit these URLs on your application:

Path Description
/eslint Optionally supply a filename parameter to analyze a file other than application.js, e.g. /eslint?filename=foo to analyze foo.js.
/eslint/source?filename=application Optionally replace application with the name of another JavaScript file, e.g. eslint/source?filename=button_stuff can show you button_stuff.js, and eslint/source?filename=components/buttons/icon_button can show you components/buttons/icon_button.js.coffee.erb.

eslint-rails-web

eslint-rails-web-source

Contributing

It's easiest to contribute by forking the repo and creating a pull request. For help with this, see this helpful article.

For all of the example shell commands below, I'm going to assume that you've set these two variables, so go ahead and customize these and set them before you start.

ESLINT=~/src/eslint
ESLINT_RAILS=~/src/eslint-rails

Cloning the repository

git clone https://github.com/appfolio/eslint-rails $ESLINT_RAILS

Updating ESLint version

Summary

  1. Clone the ESLint repository
  2. Install dependencies
  3. Render eslint.js
  4. Copy eslint.js into eslint-rails
  5. Update the file in git
  6. Commit, push, and create a pull request

Step-by-step instructions

First, make sure you set the environment variables as suggested above.

Clone the ESLint repository

I would recommend only trying this with a released version unless you have a good reason to. In this example, I'm going to check out v1.10.1 and work with that.

git clone https://github.com/eslint/eslint $ESLINT
cd $ESLINT
git checkout v1.10.1

Install dependencies

cd $ESLINT
npm install

Render eslint.js 

cd $ESLINT
shjs Makefile.js browserify

Copy eslint.js into eslint-rails 

# Assuming you cloned eslint into a repository next to eslint-rails
cp $ESLINT/build/eslint.js $ESLINT_RAILS/vendor/assets/javascripts/eslint.js

Update the file in git

cd $ESLINT_RAILS
git add vendor/assets/javascripts/eslint.js

Commit, push, and create a pull request

The details of how to create your own branch, commit, push, and create a pull request are outside the scope of this README. If you need help with this part, here's a helpful article. This is the gist.

cd $ESLINT_RAILS
# Make your changes
git add :/
git commit
git push origin master
# Open a pull request

Authors

License

[MIT License][].

[MIT License]: http://www.opensource.org/licenses/MIT)