Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/DmitryTsepelev/rubocop-graphql
Rubocop extension for enforcing graphql-ruby best practices
https://github.com/DmitryTsepelev/rubocop-graphql
best-practices graphql linter rubocop rubocop-graphql ruby static-code-analysis
Last synced: 3 months ago
JSON representation
Rubocop extension for enforcing graphql-ruby best practices
- Host: GitHub
- URL: https://github.com/DmitryTsepelev/rubocop-graphql
- Owner: DmitryTsepelev
- License: mit
- Created: 2020-05-18T14:57:41.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-08-03T11:40:36.000Z (3 months ago)
- Last Synced: 2024-08-04T12:03:44.349Z (3 months ago)
- Topics: best-practices, graphql, linter, rubocop, rubocop-graphql, ruby, static-code-analysis
- Language: Ruby
- Homepage:
- Size: 335 KB
- Stars: 220
- Watchers: 8
- Forks: 50
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# RuboCop::GraphQL 
[Rubocop](https://github.com/rubocop-hq/rubocop) extension for enforcing [graphql-ruby](https://github.com/rmosolgo/graphql-ruby) best practices.
## Installation
Install the gem:
```bash
gem install rubocop-graphql
```
If you use bundler put this in your Gemfile:
```ruby
gem 'rubocop-graphql', require: false
```
## Usage
You need to tell RuboCop to load the GraphQL extension. There are three ways to do this:
### RuboCop configuration file
Put this into your `.rubocop.yml`.
```yaml
require: rubocop-graphql
```
Alternatively, use the following array notation when specifying multiple extensions.
```yaml
require:
- rubocop-other-extension
- rubocop-graphql
```
Now you can run `rubocop` and it will automatically load the RuboCop GraphQL cops together with the standard cops.
### Command line
```sh
rubocop --require rubocop-graphql
```
### Rake task
```ruby
RuboCop::RakeTask.new do |task|
task.requires << 'rubocop-graphql'
end
```
## The Cops
All cops are located under [`lib/rubocop/cop/graphql`](lib/rubocop/cop/graphql), and contain examples and documentation.
In your `.rubocop.yml`, you may treat the GraphQL cops just like any other cop. For example:
```yaml
GraphQL/ResolverMethodLength:
Max: 3
```
## Credits
Initially sponsored by [Evil Martians](http://evilmartians.com).
## Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/DmitryTsepelev/rubocop-graphql.
## License
The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).