Module: RuboCop::Cop::CheckLineBreakable
- Included in:
- Metrics::LineLength
- Defined in:
- lib/rubocop/cop/mixin/check_line_breakable.rb
Overview
This mixin detects collections that are safe to “break” by inserting new lines. This is useful for breaking up long lines.
Let’s look at hashes as an example:
We know hash keys are safe to break across lines. We can add linebreaks into hashes on lines longer than the specified maximum. Then in further passes cops can clean up the multi-line hash. For example, say the maximum line length is as indicated below:
|
v
“0000000000”, bar: “0000000000”, baz: “0000000000”
In a LineLength autocorrection pass, a line is added before the first key that exceeds the column limit:
“0000000000”, bar: “0000000000”, baz: “0000000000”
In a MultilineHashKeyLineBreaks pass, lines are inserted before all keys:
“0000000000”, bar: “0000000000”, baz: “0000000000”
Then in future passes FirstHashElementLineBreak, MultilineHashBraceLayout, and TrailingCommaInHashLiteral will manipulate as well until we get:
foo: "0000000000",
bar: "0000000000",
baz: "0000000000",
(Note: Passes may not happen exactly in this sequence.)
Instance Method Summary collapse
Instance Method Details
#extract_breakable_node(node, max) ⇒ Object
45 46 47 48 49 50 51 52 53 |
# File 'lib/rubocop/cop/mixin/check_line_breakable.rb', line 45 def extract_breakable_node(node, max) if node.send_type? args = process_args(node.arguments) return extract_breakable_node_from_elements(node, args, max) elsif node.array_type? || node.hash_type? return extract_breakable_node_from_elements(node, node.children, max) end nil end |