sabat-rubocop 0.9.0

data/.gitignore

@@ -0,0 +1,50 @@
+# rcov generated
+coverage
+coverage.data
+
+# rdoc generated
+rdoc
+
+# yard generated
+doc
+.yardoc
+
+# bundler
+.bundle
+Gemfile.lock
+
+# jeweler generated
+pkg
+
+# Have editor/IDE/OS specific files you need to ignore? Consider using a global gitignore: 
+#
+# * Create a file at ~/.gitignore
+# * Include files you want ignored
+# * Run: git config --global core.excludesfile ~/.gitignore
+#
+# After doing this, these files will be ignored in all your git projects,
+# saving you from having to 'pollute' every project you touch with them
+#
+# Not sure what to needs to be ignored for particular editors/OSes? Here's some ideas to get you started. (Remember, remove the leading # of the line)
+#
+# For MacOS:
+#
+#.DS_Store
+
+# For TextMate
+#*.tmproj
+#tmtags
+
+# For emacs:
+#*~
+#\#*
+#.\#*
+
+# For vim:
+#*.swp
+
+# For redcar:
+#.redcar
+
+# For rubinius:
+#*.rbc

data/.rspec

@@ -0,0 +1 @@
+--color

data/.rubocop.yml

@@ -0,0 +1,7 @@
+# This is the configuration used to check the rubocop source code.
+
+inherit_from: config/default.yml
+
+# Avoid methods longer than 30 lines of code
+MethodLength:
+  Max: 30

data/.travis.yml

@@ -0,0 +1,7 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - jruby-19mode
+  - rbx-19mode
+script: bundle exec rspec

data/.yardopts

@@ -0,0 +1,2 @@
+--markup markdown
+--hide-void-return

data/CHANGELOG.md

@@ -0,0 +1,268 @@
+# Changelog
+
+## master (unreleased)
+
+### New features
+
+* Added `-l/--lint` option to allow doing only linting with no style checks (similar to running `ruby -wc`).
+
+### Changes
+
+* Removed the `BlockAlignSchema` configuration option from `EndAlignment`. We now support only the default alignment schema - `StartOfAssignment`.
+
+### Bugs fixed
+
+* [#318](https://github.com/bbatsov/rubocop/issues/318) - correct some special cases of block end alignment
+* [#317](https://github.com/bbatsov/rubocop/issues/317) - fix a false positive in `LiteralInCondition`
+* [#321](https://github.com/bbatsov/rubocop/issues/321) - Ignore variables whose name start with `_` in `ShadowingOuterLocalVariable`
+* [#322](https://github.com/bbatsov/rubocop/issues/322) - Fix exception of `UnusedLocalVariable` and `ShadowingOuterLocalVariable` when inspecting keyword splat argument
+* [#316](https://github.com/bbatsov/rubocop/issues/316) - Correct nested postfix unless in `MultilineIfThen`
+* [#327](https://github.com/bbatsov/rubocop/issues/327) - Fix false offences for block expression that spawn on two lines in `EndAlignment`
+
+## 0.9.0 (01/07/2013)
+
+### New features
+
+* Introduced formatter feature, enables custom formatted output and multiple outputs.
+* Added progress formatter and now it's the default. (`--format progress`)
+* Added JSON formatter. (`--format json`)
+* Added clang style formatter showing the offending source
+  code. (`--format clang`). The `clang` formatter marks a whole range
+  rather than just the starting position, to indicate more clearly
+  where the problem is.
+* Added `-f`/`--format` option to specify formatter.
+* Added `-o`/`--out` option to specify output file for each formatter.
+* Added `-r/--require` option to inject external Ruby code into RuboCop.
+* Added `-V/--verbose-version` option that displays Parser version and Ruby version as well.
+* Added `-R/--rails` option that enables extra Rails-specific cops.
+* Added support for auto-correction of some offences with `-a`/`--auto-correct`.
+* New cop `CaseEquality` checks for explicit use of `===`
+* New cop `AssignmentInCondition` checks for assignment in conditions.
+* New cop `EndAlignment` tracks misaligned `end` keywords.
+* New cop `Void` tracks uses of literals/variables/operators in possibly void context.
+* New cop `Documentation` checks for top level class/module doc comments.
+* New cop `UnreachableCode` tracks unreachable code segments.
+* New cop `MethodCallParentheses` tracks unwanted braces in method calls.
+* New cop `UnusedLocalVariable` tracks unused local variables for each scope.
+* New cop `ShadowingOuterLocalVariable` tracks use of the same name as outer local variables for block arguments or block local variables.
+* New cop `WhileUntilDo` tracks uses of `do` with multi-line `while/until`.
+* New cop `CharacterLiteral` tracks uses of character literals (`?x`).
+* New cop `EndInMethod` tracks uses of `END` in method definitions.
+* New cop `LiteralInCondition` tracks uses of literals in the conditions of `if/while/until`.
+* New cop `BeginBlock` tracks uses of `BEGIN` blocks.
+* New cop `EndBlock` tracks uses of `END` blocks.
+* New cop `DotPosition` tracks the dot position in multi-line method calls.
+* New cop `Attr` tracks uses of `Module#attr`.
+
+### Changes
+
+* Deprecated `-e`/`--emacs` option. (Use `--format emacs` instead)
+* Made `progress` formatter the default.
+* Most formatters (`progress`, `simple` and `clang`) now print relative file paths if the paths are under the current working directory.
+* Migrate all cops to new namespaces. `Rubocop::Cop::Lint` is for cops that emit warnings. `Rubocop::Cop::Style` is for cops that do not belong in other namespaces.
+* Merge `FavorPercentR` and `PercentR` into one cop called `RegexpLiteral`, and add configuration parameter `MaxSlashes`.
+* Add `CountKeywordArgs` configuration option to `ParameterLists` cop.
+
+### Bugs fixed
+
+* [#239](https://github.com/bbatsov/rubocop/issues/239) - fixed double quotes false positives
+* [#233](https://github.com/bbatsov/rubocop/issues/233) - report syntax cop offences
+* Fix off-by-one error in favor_modifier.
+* [#229](https://github.com/bbatsov/rubocop/issues/229) - recognize a line with CR+LF as a blank line in AccessControl cop.
+* [#235](https://github.com/bbatsov/rubocop/issues/235) - handle multiple constant assignment in ConstantName cop
+* [#246](https://github.com/bbatsov/rubocop/issues/246) - correct handling of unicode escapes within double quotes
+* Fix crashes in Blocks, CaseEquality, CaseIndentation, ClassAndModuleCamelCase, ClassMethods, CollectionMethods, and ColonMethodCall.
+* [#263](https://github.com/bbatsov/rubocop/issues/263) - do not check for space around operators called with method syntax
+* [#271](https://github.com/bbatsov/rubocop/issues/271) - always allow line breaks inside hash literal braces
+* [#270](https://github.com/bbatsov/rubocop/issues/270) - fixed a false positive in ParenthesesAroundCondition
+* [#288](https://github.com/bbatsov/rubocop/issues/288) - get config parameter AllCops/Excludes from highest config file in path
+* [#276](https://github.com/bbatsov/rubocop/issues/276) - let columns start at 1 instead of 0 in all output of column numbers
+* [#292](https://github.com/bbatsov/rubocop/issues/292) - don't check non-regular files (like sockets, etc)
+* Fix crashes in WordArray on arrays of character literals such as `[?\r, ?\n]`
+* Fix crashes in Documentation on empty modules
+
+## 0.8.3 (18/06/2013)
+
+### Bug fixes
+
+* Lock Parser dependency to version 2.0.0.beta5.
+
+## 0.8.2 (06/05/2013)
+
+### New features
+
+* New cop `BlockNesting` checks for excessive block nesting
+
+### Bug fixes
+
+* Correct calculation of whether a modifier version of a conditional statement will fit.
+* Fix an error in `MultilineIfThen` cop that occurred in some special cases.
+* [#231](https://github.com/bbatsov/rubocop/issues/231) - fix a false positive for modifier if
+
+## 0.8.1 (05/30/2013)
+
+### New features
+
+* New cop `Proc` tracks uses of `Proc.new`
+
+### Changes
+
+* Renamed `NewLambdaLiteral` to `Lambda`.
+* Aligned the `Lambda` cop more closely to the style guide - it now
+  allows the use of `lambda` for multi-line blocks.
+
+### Bugs fixed
+
+* [#210](https://github.com/bbatsov/rubocop/issues/210) - fix a false positive for double quotes in regexp literals
+* [#211](https://github.com/bbatsov/rubocop/issues/211) - fix a false positive for `initialize` method looking like a trivial writer
+* [#215](https://github.com/bbatsov/rubocop/issues/215) - Fixed a lot of modifier `if/unless/while/until` issues
+* [#213](https://github.com/bbatsov/rubocop/issues/213) - Make sure even disabled cops get their configuration set
+* [#214](https://github.com/bbatsov/rubocop/issues/214) - Fix SpaceInsideHashLiteralBraces to handle string interpolation right
+
+## 0.8.0 (05/28/2013)
+
+### Changes
+
+* Folded `ArrayLiteral` and `HashLiteral` into `EmptyLiteral` cop
+* The maximum number of params `ParameterLists` accepts in now configurable
+* Reworked `SymbolSnakeCase` into `SymbolName`, which has an option `AllowCamelCase` enabled by default.
+* Migrated from `Ripper` to the portable [Parser](https://github.com/whitequark/parser).
+
+### New features
+
+* New cop `ConstantName` checks for constant which are not using `SCREAMING_SNAKE_CASE`.
+* New cop `AccessControl` checks private/protected indentation and surrounding blank lines.
+* New cop `Loop` checks for `begin/end/while(until)` and suggests the use of `Kernel#loop`.
+
+## 0.7.2 (05/13/2013)
+
+### Bugs fixed
+
+* [#155](https://github.com/bbatsov/rubocop/issues/155) 'Do not use semicolons to terminate expressions.' is not implemented correctly
+* `OpMethod` now handles definition of unary operators without crashing.
+* `SymbolSnakeCase` now handles aliasing of operators without crashing.
+* `RescueException` now handles the splat operator `*` in a `rescue` clause without crashing.
+* [#159](https://github.com/bbatsov/rubocop/issues/159) AvoidFor cop misses many violations
+
+## 0.7.1 (05/11/2013)
+
+### Bugs fixed
+
+* Added missing files to the gemspec
+
+## 0.7.0 (05/11/2013)
+
+### New features
+
+* Added ability to include or exclude files/directories through `.rubocop.yml`
+* Added option --only for running a single cop.
+* Relax semicolon rule for one line methods, classes and modules
+* Configuration files, such as `.rubocop.yml`, can now include configuration from other files through the `inherit_from` directive. All configuration files implicitly inherit from `config/default.yml`.
+* New cop `ClassMethods` checks for uses for class/module names in definitions of class/module methods
+* New cop `SingleLineMethods` checks for methods implemented on a single line
+* New cop `FavorJoin` checks for usages of `Array#*` with a string argument
+* New cop `BlockComments` tracks uses of block comments(`=begin/=end` comments)
+* New cop `EmptyLines` tracks consecutive blank lines
+* New cop `WordArray` tracks arrays of words.
+* [#108](https://github.com/bbatsov/rubocop/issues/108) New cop `SpaceInsideHashLiteralBraces` checks for spaces inside hash literal braces - style is configurable
+* New cop `LineContinuation` tracks uses of the line continuation character (`\`)
+* New cop `SymbolArray` tracks arrays of symbols.
+* Print warnings for unrecognized names in configuration files.
+* New cop `TrivialAccessors` tracks method definitions that could be automatically generated with `attr_*` methods.
+* New cop `LeadingCommentSpace` checks for missing space after `#` in comments.
+* New cop `ColonMethodCall` tracks uses of `::` for method calls.
+* New cop `AvoidGlobalVars` tracks uses of non built-in global variables.
+* New cop `SpaceAfterControlKeyword` tracks missing spaces after `if/elsif/case/when/until/unless/while`.
+* New cop `Not` tracks uses of the `not` keyword.
+* New cop `Eval` tracks uses of the `eval` function.
+
+### Bugs fixed
+
+* [#101](https://github.com/bbatsov/rubocop/issues/101) `SpaceAroundEqualsInParameterDefault` doesn't work properly with empty string
+* Fix `BraceAfterPercent` for `%W`, `%i` and `%I` and added more tests
+* Fix a false positive in the `Alias` cop. `:alias` is no longer treated as keyword
+* `ArrayLiteral` now properly detects `Array.new`
+* `HashLiteral` now properly detects `Hash.new`
+* `VariableInterpolation` now detects regexp back references and doesn't crash.
+* Don't generate pathnames like some/project//some.rb
+* [#151](https://github.com/bbatsov/rubocop/issues/151) Don't print the unrecognized cop warning several times for the same `.rubocop.yml`
+
+### Misc
+
+* Renamed `Indentation` cop to `CaseIndentation` to avoid confusion
+* Renamed `EmptyLines` cop to `EmptyLineBetweenDefs` to avoid confusion
+
+## 0.6.1 (04/28/2013)
+
+### New features
+
+* Split `AsciiIdentifiersAndComments` cop in two separate cops
+
+### Bugs fixed
+
+* [#90](https://github.com/bbatsov/rubocop/issues/90) Two cops crash when scanning code using `super`
+* [#93](https://github.com/bbatsov/rubocop/issues/93) Issue with `whitespace?': undefined method`
+* [#97](https://github.com/bbatsov/rubocop/issues/97) Build fails
+* [#100](https://github.com/bbatsov/rubocop/issues/100) `OpMethod` cop doesn't work if method arg is not in braces
+* `SymbolSnakeCase` now tracks Ruby 1.9 hash labels as well as regular symbols
+
+### Misc
+
+* [#88](https://github.com/bbatsov/rubocop/issues/88) Abort gracefully when interrupted with Ctrl-C
+* No longer crashes on bugs within cops. Now problematic checks are skipped and a message is displayed.
+* Replaced `Term::ANSIColor` with `Rainbow`.
+* Add an option to disable colors in the output.
+* Cop names are now displayed alongside messages when `-d/--debug` is passed.
+
+## 0.6.0 (04/23/2013)
+
+### New features
+
+* New cop `ReduceArguments` tracks argument names in reduce calls
+* New cop `MethodLength` tracks number of LOC (lines of code) in methods
+* New cop `RescueModifier` tracks uses of `rescue` in modifier form.
+* New cop `PercentLiterals` tracks uses of `%q`, `%Q`, `%s` and `%x`.
+* New cop `BraceAfterPercent` tracks uses of % literals with
+  delimiters other than ().
+* Support for disabling cops locally in a file with rubocop:disable comments.
+* New cop `EnsureReturn` tracks usages of `return` in `ensure` blocks.
+* New cop `HandleExceptions` tracks suppressed exceptions.
+* New cop `AsciiIdentifiersAndComments` tracks uses of non-ascii
+  characters in identifiers and comments.
+* New cop `RescueException` tracks uses of rescuing the `Exception` class.
+* New cop `ArrayLiteral` tracks uses of Array.new.
+* New cop `HashLiteral` tracks uses of Hash.new.
+* New cop `OpMethod` tracks the argument name in operator methods.
+* New cop `PercentR` tracks uses of %r literals with zero or one slash in the regexp.
+* New cop `FavorPercentR` tracks uses of // literals with more than one slash in the regexp.
+
+### Bugs fixed
+
+* [#62](https://github.com/bbatsov/rubocop/issues/62) - Config files in ancestor directories are ignored if another exists in home directory
+* [#65](https://github.com/bbatsov/rubocop/issues/65) - Suggests to convert symbols `:==`, `:<=>` and the like to snake_case
+* [#66](https://github.com/bbatsov/rubocop/issues/66) - Does not crash on unreadable or unparseable files
+* [#70](https://github.com/bbatsov/rubocop/issues/70) - Support `alias` with bareword arguments
+* [#64](https://github.com/bbatsov/rubocop/issues/64) - Performance issue with Bundler
+* [#75](https://github.com/bbatsov/rubocop/issues/75) - Make it clear that some global variables require the use of the English library
+* [#79](https://github.com/bbatsov/rubocop/issues/79) - Ternary operator missing whitespace detection
+
+### Misc
+
+* Dropped Jeweler for gem release management since it's no longer
+  actively maintained.
+* Handle pluralization properly in the final summary.
+
+## 0.5.0 (04/17/2013)
+
+### New features
+
+* New cop `FavorSprintf` that checks for usages of `String#%`
+* New cop `Semicolon` that checks for usages of `;` as expression separator
+* New cop `VariableInterpolation` that checks for variable interpolation in double quoted strings
+* New cop `Alias` that checks for uses of the keyword `alias`
+* Automatically detect extensionless Ruby files with shebangs when search for Ruby source files in a directory
+
+### Bugs fixed
+
+* [#59](https://github.com/bbatsov/rubocop/issues/59) - Interpolated variables not enclosed in braces are not noticed
+* [#42](https://github.com/bbatsov/rubocop/issues/42) - Received malformed format string ArgumentError from rubocop

data/CONTRIBUTING.md

@@ -0,0 +1,16 @@
+# Contributing to RuboCop
+
+* Check out the latest master to make sure the feature hasn't been
+  implemented or the bug hasn't been fixed yet.
+* Check out the issue tracker to make sure someone already hasn't
+  requested it and/or contributed it.
+* Fork the project.
+* Start a feature/bugfix branch.
+* Commit and push until you are happy with your contribution.
+* Make sure to add tests for it. This is important so I don't break it
+  in a future version unintentionally.
+* Update the [Changelog](CHANGELOG.md) accordingly.
+* Please try not to mess with the Rakefile, version, or history. If
+  you want to have your own version, or is otherwise necessary, that
+  is fine, but please isolate to its own commit so I can cherry-pick
+  around it.

data/Gemfile

@@ -0,0 +1,7 @@
+source 'http://rubygems.org'
+
+gemspec
+
+group :test do
+  gem 'coveralls', require: false
+end

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Bozhidar Batsov
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,324 @@
+[![Gem Version](https://badge.fury.io/rb/rubocop.png)](http://badge.fury.io/rb/rubocop)
+[![Build Status](https://travis-ci.org/bbatsov/rubocop.png?branch=master)](https://travis-ci.org/bbatsov/rubocop)
+[![Coverage Status](https://coveralls.io/repos/bbatsov/rubocop/badge.png?branch=master)](https://coveralls.io/r/bbatsov/rubocop)
+
+# RuboCop
+
+> Role models are important. <br/>
+> -- Officer Alex J. Murphy / RoboCop
+
+**RuboCop** is a Ruby code style checker based on the
+[Ruby Style Guide](https://github.com/bbatsov/ruby-style-guide).
+
+## Installation
+
+**RuboCop**'s installation is pretty standard:
+
+```bash
+$ gem install rubocop
+```
+
+## Basic Usage
+
+Running `rubocop` with no arguments will check all Ruby source files
+in the current folder:
+
+```bash
+$ rubocop
+```
+
+Alternatively you can pass `rubocop` a list of files and folders to check:
+
+```bash
+$ rubocop app spec lib/something.rb
+```
+
+For more details check the available command-line options:
+
+```bash
+$ rubocop -h
+```
+
+Command flag           | Description
+-----------------------|------------------------------------------------------------
+`-v/--version`         | Displays the current version and exits
+`-V/--verbose-version` | Displays the current version plus the version of Parser and Ruby
+`-d/--debug`           | Displays some extra debug output
+`-c/--config`          | Run with specified config file
+`-f/--format`          | Choose a formatter
+`-o/--out`             | Write output to a file instead of STDOUT
+`-r/--require`         | Require Ruby file
+`-R/--rails`           | Run extra Rails cops
+`-l/--lint`            | Run only lint cops
+`-a/--auto-correct`    | Auto-correct certain offences.
+`-s/--silent`          | Suppress the final summary
+`--only`               | Run only the specified cop
+
+## Configuration
+
+The behavior of RuboCop can be controlled via the
+[.rubocop.yml](https://github.com/bbatsov/rubocop/blob/master/.rubocop.yml)
+configuration file. The file can be placed either in your home folder
+or in some project folder.
+
+RuboCop will start looking for the configuration file in the directory
+where the inspected file is and continue its way up to the root folder.
+
+The file has the following format:
+
+```yaml
+inherit_from: ../.rubocop.yml
+
+Encoding:
+  Enabled: true
+
+LineLength:
+  Enabled: true
+  Max: 79
+```
+
+It allows to enable/disable certain cops (checks) and to alter their
+behavior if they accept any parameters.
+
+The optional `inherit_from` directive is used to include configuration
+from one or more files. This makes it possible to have the common
+project settings in the `.rubocop.yml` file at the project root, and
+then only the deviations from those rules in the subdirectories. The
+included files can be given with absolute paths or paths relative to
+the file where they are referenced. The settings after an
+`inherit_from` directive override any settings in the included
+file(s). When multiple files are included, the first file in the list
+has the lowest precedence and the last one has the highest. The format
+for multiple inclusion is:
+
+```yaml
+inherit_from:
+  - ../.rubocop.yml
+  - ../conf/.rubocop.yml
+```
+
+### Defaults
+
+The file `config/default.yml` under the RuboCop home directory
+contains the default settings that all configurations inherit
+from. Project and personal `.rubocop.yml` files need only make
+settings that are different from the default ones. If there is no
+`.rubocop.yml` file in the project or home directory,
+`config/default.yml` will be used.
+
+### Disabling Cops within Source Code
+
+One or more individual cops can be disabled locally in a section of a
+file by adding a comment such as
+
+```ruby
+# rubocop:disable LineLength, StringLiterals
+[...]
+# rubocop:enable LineLength, StringLiterals
+```
+
+You can also disable *all* cops with
+
+```ruby
+# rubocop:disable all
+[...]
+# rubocop:enable all
+```
+
+One or more cops can be disabled on a single line with an end-of-line
+comment.
+
+```ruby
+for x in (0..19) # rubocop:disable AvoidFor
+```
+
+### Including/Excluding files
+
+RuboCop checks all files recursively within the directory it is run
+on.  However, it does not recognize some files as Ruby(only files
+ending with `.rb` or extensionless files with a `#!.*ruby` declaration
+are automatically detected) files, and if you'd like it to check these
+you'll need to manually pass them in.  Files and directories can
+also be ignored through `.rubocop.yml`.
+
+Here is an example that might be used for a Rails project:
+
+```yaml
+AllCops:
+  Includes:
+    - Rakefile
+    - config.ru
+  Excludes:
+    - db/**
+    - config/**
+    - script/**
+
+# other configuration
+# ...
+```
+
+Note: Files and directories are specified relative to the
+`.rubocop.yml` file. The `Excludes` parameter is special. It is valid
+for the directory tree starting where it is defined. It is not
+shadowed by the setting of `Excludes` in other `.rubocop.yml` files in
+subdirectories.
+
+## Formatters
+
+### JSON Formatter
+
+You can get RuboCop's inspection result in JSON format by passing `--format json` option in command line.
+The JSON structure is like the following example:
+
+```javascript
+{
+  "metadata": {
+    "rubocop_version": "0.9.0",
+    "ruby_engine": "ruby",
+    "ruby_version": "2.0.0",
+    "ruby_patchlevel": "195",
+    "ruby_platform": "x86_64-darwin12.3.0"
+  },
+  "files": [{
+      "path": "lib/foo.rb",
+      "offences": []
+    }, {
+      "path": "lib/bar.rb",
+      "offences": [{
+          "severity": "convention",
+          "message": "Line is too long. [81/79]",
+          "cop_name": "LineLength",
+          "location": {
+            "line": 546,
+            "column": 80
+          }
+        }, {
+          "severity": "warning",
+          "message": "Unreachable code detected.",
+          "cop_name": "UnreachableCode",
+          "location": {
+            "line": 15,
+            "column": 9
+          }
+        }
+      ]
+    }
+  ],
+  "summary": {
+    "offence_count": 2,
+    "target_file_count": 2,
+    "inspected_file_count": 2
+  }
+}
+```
+
+### Custom Formatters
+
+You can customize RuboCop's output format with custom formatter.
+
+#### Creating Custom Formatter
+
+To implement a custom formatter, you need to subclass
+`Rubocop::Formatter::BaseFormatter` and override some methods,
+or implement all formatter API methods by duck typing.
+
+Please see the documents below for more formatter API details.
+
+* [Rubocop::Formatter::BaseFormatter](http://rubydoc.info/gems/rubocop/Rubocop/Formatter/BaseFormatter)
+* [Rubocop::Cop::Offence](http://rubydoc.info/gems/rubocop/Rubocop/Cop/Offence)
+* [Parser::Source::Range](http://rubydoc.info/github/whitequark/parser/Parser/Source/Range)
+
+#### Using Custom Formatter in Command Line
+
+You can tell RuboCop to use your custom formatter with a combination of
+`--format` and `--require` option.
+For example, when you have defined `MyCustomFormatter` in
+`./path/to/my_custom_formatter.rb`, you would type this command:
+
+```bash
+$ rubocop --require ./path/to/my_custom_formatter --format MyCustomFormatter
+```
+
+Note: The path passed to `--require` is directly passed to `Kernel.require`.
+If your custom formatter file is not in `$LOAD_PATH`,
+you need to specify the path as relative path prefixed with `./` explicitly,
+or absolute path.
+
+## Compatibility
+
+RuboCop supported only MRI 1.9 & MRI 2.0 prior to version 0.8. After
+RuboCop 0.8, JRuby and Rubinius in 1.9 modes are also supported.
+
+## Editor integration
+
+### Emacs
+
+[rubocop.el](https://github.com/bbatsov/rubocop-emacs) is a simple
+Emacs interface for RuboCop. It allows you to run RuboCop inside Emacs
+and quickly jump between problems in your code.
+
+[flycheck](https://github.com/lunaryorn/flycheck) > 0.9 also supports
+RuboCop and uses it by default when available.
+
+### Vim
+
+The [vim-rubocop](https://github.com/ngmy/vim-rubocop) plugin runs
+RuboCop and displays the results in Vim.
+
+There's also a RuboCop checker in
+[syntastic](https://github.com/scrooloose/syntastic).
+
+### Sublime Text 2
+
+If you're a ST2 user you might find the
+[Sublime RuboCop plugin](https://github.com/pderichs/sublime_rubocop)
+useful.
+
+### Other Editors
+
+Here's one great opportunity to contribute to RuboCop - implement
+RuboCop integration for your favorite editor.
+
+## Guard integration
+
+If you're fond of [Guard](https://github.com/guard/guard) you might
+like
+[guard-rubocop](https://github.com/yujinakayama/guard-rubocop). It
+allows you to automatically check Ruby code style with RuboCop when
+files are modified.
+
+## Contributors
+
+Here's a [list](https://github.com/bbatsov/rubocop/contributors) of
+all the people who have contributed to the development of RuboCop.
+
+I'm extremely grateful to each and every one of them!
+
+I'd like to single out [Jonas Arvidsson](https://github.com/jonas054)
+and [Yuji Nakayama](https://github.com/yujinakayama) for their many
+excellent code contributions as well as valuable feedback and ideas!
+
+If you'd like to contribute to RuboCop, please take the time to go
+through our short
+[contribution guidelines](CONTRIBUTING.md).
+
+Converting more of the Ruby Style Guide into RuboCop cops is our top
+priority right now. Writing a new cop is a great way to dive into RuboCop!
+
+Of course, bug reports and suggestions for improvements are always
+welcome. GitHub pull requests are even better! :-)
+
+## Mailing List
+
+If you're interested in everything regarding RuboCop's development,
+consider joining its
+[Google Group](https://groups.google.com/forum/?fromgroups#!forum/rubocop).
+
+## Changelog
+
+RuboCop's changelog is available [here](CHANGELOG.md).
+
+## Copyright
+
+Copyright (c) 2012-2013 Bozhidar Batsov. See [LICENSE.txt](LICENSE.txt) for
+further details.