|
1 | | -# Code Climate ESLint Engine |
| 1 | +# Try Qlty today, the newest edition of Code Climate Quality. |
| 2 | +#### This repository is deprecated and archived. |
2 | 3 |
|
3 | | -[![Code Climate][badge]][repo] |
| 4 | +This is a repository for a Code Climate Quality plugin which is packaged as a Docker image. |
4 | 5 |
|
5 | | -[badge]: https://codeclimate.com/github/codeclimate/codeclimate-eslint/badges/gpa.svg |
6 | | -[repo]: https://codeclimate.com/github/codeclimate/codeclimate-eslint |
| 6 | +Code Climate Quality is being replaced with the new [Qlty](qlty.sh) code quality platform. Qlty uses a new plugin system which does not require packaging plugins as Docker images. |
7 | 7 |
|
8 | | -`codeclimate-eslint` is a Code Climate engine that wraps [ESLint][]. You can run |
9 | | -it on your command line using the Code Climate CLI, or on our hosted analysis |
10 | | -platform. |
| 8 | +As a result, this repository is no longer maintained and has been archived. |
11 | 9 |
|
12 | | -ESLint is a tool for identifying and reporting on patterns found in |
13 | | -ECMAScript/JavaScript code. It can be configured using a [configuration |
14 | | -file][config]. |
| 10 | +## Advantages of Qlty plugins |
| 11 | +The new Qlty plugins system provides key advantages over the older, Docker-based plugin system: |
15 | 12 |
|
16 | | -[config]: http://eslint.org/docs/user-guide/configuring#using-configuration-files |
| 13 | +- Linting runs much faster without the overhead of virtualization |
| 14 | +- New versions of linters are available immediately without needing to wait for a re-packaged release |
| 15 | +- Plugins can be run with any arbitrary extensions (like extra rules and configs) without requiring pre-packaging |
| 16 | +- Eliminates security issues associated with exposing a Docker daemon |
17 | 17 |
|
18 | | -### Channels |
| 18 | +## Try out Qlty today free |
19 | 19 |
|
20 | | -There are a few major versions of ESLint out there. The latest major version |
21 | | -is 4. This engine provides a few [channels][] for major versions of ESLint. |
| 20 | +[Qlty CLI](https://docs.qlty.sh/cli/quickstart) is the fastest linter and auto-formatter for polyglot teams. It is completely free and available for Mac, Windows, and Linux. |
22 | 21 |
|
23 | | -This branch is for the `latest` (i.e. default) channel and provides ESLint 3 |
24 | | -support. |
| 22 | + - Install Qlty CLI: |
| 23 | +` |
| 24 | +curl https://qlty.sh | sh # Mac or Linux |
| 25 | +` |
| 26 | +or ` <windows install line> ` |
25 | 27 |
|
26 | | -For ESLint 4, please see [`channel/eslint-4`][] branch. |
| 28 | +[Qlty Cloud](https://docs.qlty.sh/cloud/quickstart) is a full code health platform for integrating code quality into development team workflows. It is free for unlimited private contributors. |
| 29 | + - [Try Qlty Cloud today](https://docs.qlty.sh/cloud/quickstart) |
27 | 30 |
|
28 | | -[channels]: https://docs.codeclimate.com/docs/engine-channels |
29 | | -[`channel/eslint-4`]: https://github.com/codeclimate/codeclimate-eslint/tree/channel/eslint-4 |
30 | | - |
31 | | -### Installation |
32 | | - |
33 | | -1. If you haven't already, [install the Code Climate CLI][CLI] |
34 | | - |
35 | | -2. Run `codeclimate engines:enable eslint`. This command both installs the |
36 | | - engine and enables it in your `.codeclimate.yml` file |
37 | | - |
38 | | -3. You're ready to analyze! Browse into your project's folder and run |
39 | | - `codeclimate analyze` |
40 | | - |
41 | | -[cli]: https://github.com/codeclimate/codeclimate |
42 | | - |
43 | | -### Configuration |
44 | | - |
45 | | -#### `ignore_warnings` |
46 | | - |
47 | | -By default, this engine will emit both ESLint errors and warnings as Code |
48 | | -Climate issues. If you prefer, you can ignore warning-level violations by |
49 | | -setting the `ignore_warnings` configuration option: |
50 | | - |
51 | | -```yaml |
52 | | -eslint: |
53 | | - enabled: true |
54 | | - config: |
55 | | - ignore_warnings: true |
56 | | -``` |
57 | | -
|
58 | | -#### `extensions` |
59 | | - |
60 | | -If you're using a plugin like `eslint-plugin-json` or `eslint-plugin-html`, you |
61 | | -will want to set this value to make sure the appropriate files are included: |
62 | | - |
63 | | -```yaml |
64 | | -eslint: |
65 | | - enabled: true |
66 | | - config: |
67 | | - extensions: |
68 | | - - .js |
69 | | - - .html |
70 | | -``` |
71 | | - |
72 | | -#### `sanitize_batch` |
73 | | - |
74 | | -By default, this engine will skip files that appear to be minified (average line |
75 | | -length over 100). This feature can be disabled to include all files for |
76 | | -analysis. |
77 | | - |
78 | | -```yaml |
79 | | -eslint: |
80 | | - enabled: true |
81 | | - config: |
82 | | - sanitize_batch: false |
83 | | -``` |
84 | | - |
85 | | - |
86 | | -### Need help? |
87 | | - |
88 | | -For help with ESLint, [check out their documentation][eslint-docs]. |
89 | | - |
90 | | -If you're running into a Code Climate issue, first look over this project's |
91 | | -[GitHub Issues][issues], as your question may have already been covered. If not, |
92 | | -[go ahead and open a support ticket with us][help]. |
93 | | - |
94 | | -[issues]: https://github.com/codeclimate/codeclimate-eslint/issues |
95 | | -[help]: https://codeclimate.com/help |
96 | | - |
97 | | -[eslint]: http://eslint.org |
98 | | -[eslint-docs]: http://eslint.org/docs/user-guide/ |
| 31 | +**Note**: For existing customers of Quality, please see our [Migration Guide](https://docs.qlty.sh/migration/guide) for more information and resources. |
0 commit comments