Share
Embed
RuboCop Under a Microscope
Lint Night #1
https://lintnight.connpass.com/event/263931/
Koichi ITO
November 18, 2022
Transcript
76 slides
-
ҏ౻ߒҰ&4. *OD Lint Night #1 3VCP$PQͷ͘͠Έ RuboCop Under a Microscope
% ruby -v ruby 3.2.0dev % rubocop -v 1.39.0 -
5IFpSTUDPNNJU % git log -p --reverse commit afbead34db54506c12a21dbd4ce04fada0f8b9a4 Author: Bozhidar
Batsov <[email protected]> Date: Sat Apr 21 13:06:42 2012 +0300 Initial commit to rubocop. --- .document | 5 +++++ .gitignore | 49 +++++++++++++++++++++++++++++++++++++++ ++++++++++ .rspec | 1 + Gemfile | 16 ++++++++++++++++ LICENSE.txt | 20 ++++++++++++++++++++ README.rdoc | 19 +++++++++++++++++++ Rakefile | 45 +++++++++++++++++++++++++++++++++++++++ ++++++ features/rubocop.feature | 9 +++++++++ features/step_definitions/rubocop_steps.rb | 0 features/support/env.rb | 13 +++++++++++++ -
5IFpSTUDPNNJU % git log -p --reverse commit afbead34db54506c12a21dbd4ce04fada0f8b9a4 Author: Bozhidar
Batsov <[email protected]> Date: Sat Apr 21 13:06:42 2012 +0300 Initial commit to rubocop. --- .document | 5 +++++ .gitignore | 49 +++++++++++++++++++++++++++++++++++++++ ++++++++++ .rspec | 1 + Gemfile | 16 ++++++++++++++++ LICENSE.txt | 20 ++++++++++++++++++++ README.rdoc | 19 +++++++++++++++++++ Rakefile | 45 +++++++++++++++++++++++++++++++++++++++ ++++++ features/rubocop.feature | 9 +++++++++ features/step_definitions/rubocop_steps.rb | 0 features/support/env.rb | 13 +++++++++++++ 👈 -
w 3VCZຊମ͕ߏจఆ͍ٛͯ͠ΔQBSTFZͷมߋ Λ͍ͬͯΔ ͍ΘΏΔSEύʔςΟ w 3VCZຊମͰ৽͍͠ߏจՃ͕͋ͬͯ 1BSTFSHFNଆͷߏจఆٛʹಉ༷ͷύονΛ खΛೖΕͳ͍ͱɺ৽͍͠ߏจΛղੳͰ͖ͳ͍ w
ݱࡏ0QBMίϛολʔ͕Ϧʔυ͍ͯ͠Δ 3VCZߏจղੳͷ࣮ͷͻͱͭ -
ߏจղੳͱͦͷઌ ੩తղੳ 3VCP$PQ 1PMZpMM 3VCZ/FYU τϥϯεύΠϥ 0QBM ߏจղੳ 1BSTFS 3VCZίʔυ
"45 ݹ͍ϥϯλΠϜ 3VCZίʔυ +BWB4DSJQUίʔυ ੩తղੳޙͷमਖ਼ 3VCZίʔυ 1SPDFTTFE4PVSDF -
w ίϩϯ ͷࠨลͷ୯ Ұͷه߸͕ӈลʹߏ ͞Ε͍ͯΔه߸ͷฒͼ Ͱஔ͞ΕΔ w 1BSTFSHFNͰ3BDD ͱ͍͏ύʔαδΣω
ϨʔλΛ͍ͬͯΔ Zͷ#/'αϯϓϧ -
% cd ghq/github.com/whitequark/parser % bundle exec rake generate # Generate
the Ragel lexer and Racc parser (snip) % ls lib/parser/ all.rb macruby.rb ruby22.y ruby32.rb ast macruby.y ruby23.rb ruby32.y base.rb max_numparam_stack.rb ruby23.y rubymotion.rb builders messages.rb ruby24.rb rubymotion.y clobbering_error.rb meta.rb ruby24.y runner color.rb rewriter.rb ruby25.rb runner.rb context.rb ruby18.rb ruby25.y source current.rb ruby18.y ruby26.rb static_environment.rb current_arg_stack.rb ruby19.rb ruby26.y syntax_error.rb deprecation.rb ruby19.y ruby27.rb tree_rewriter.rb diagnostic ruby20.rb ruby27.y variables_stack.rb diagnostic.rb ruby20.y ruby30.rb version.rb lexer ruby21.rb ruby30.y lexer.rb ruby21.y ruby31.rb lexer.rl ruby22.rb ruby31.y Z͔Β SC͕ੜ͞ΕΔ -
DEdTSDHJUIVCDPNSVCZSVCZ HJUMPHQQBSTFZ DPNNJUEBGEDFBEBCBBGCBDDF "VUIPS,B[VLJ5TVKJNPUPLB[VLJ!DBMMDDOFU %BUF4VO.BS "MMPXUSBJMJOHDPNNBJOIBTIQBUUFSO EJ⒎HJUBQBSTFZCQBSTFZ JOEFYDDGCG BQBSTFZ
CQBSTFZ !! !!Q@LXBSHTQ@LXBSH Q@LXSFTU \ OFX@IBTI@QBUUFSO@UBJM Q OFX@VOJRVF@LFZ@IBTI Q ! ! ^ 3VCZͷQBSTFZ -
SVCZQBSTFW SVCZQBSTFCBTFEPOQBSTFSWFSTJPO SVCZQBSTFFDBTFQBUUFSOJO\B ^UIFOUSVF FOE DBTFNBUDI TFOEOJMQBUUFSO
JOQBUUFSO IBTIQBUUFSO QBJS TZNB JOU OJM USVF OJM SVCZQBSTFW SVCZQBSTFCBTFEPOQBSTFSWFSTJPO SVCZQBSTFFDBTFQBUUFSOJO\B^UIFOUSVF FOE DBTFNBUDI TFOEOJMQBUUFSO JOQBUUFSO IBTIQBUUFSO QBJS TZNB JOU OJM USVF OJM ߏจΤϥʔʹͳΒͣॲཧͰ͖Δ ΧϯϚ͕͋ͬͯͳͯ͘"45ಉ͡ -
w 1BSTFSHFNύʔαδΣωϨʔλ ʹ3BDDΛ͍ͬͯΔ w #/' όοΧεɾφΞه๏ Ͱ ॻ͔Ε͍ͯΔ w 3BDDΛͬͨߏจղੳ͍ͭͯ
ʰຊແಓฤʱͳͲࢀরͷ͜ͱ ߏจղੳೖ -
֦ுϧʔϧ(FN ϥϯλΠϜͱίΞϧʔϧ 5SBWFSTBMϊʔυ֦ு 3VCZͷߏจղੳ 1BSTFSHFN 3VCP$PQ"45 3VCP$PQDPSF 3VCP$PQ 34QFD 3VCP$PQ
1FSGPSNBODF 3VCP$PQ 3BJMT 3VCP$PQͷґଘελοΫ -
require 'rubocop-ast' RuboCop::AST::ProcessedSource.new( 'puts "hello"', 3.1 ) 3VCP$PQ"451SPDFTTFE4PVSDF w ྫ͑"45ιʔείϝϯτΛදݱͤͣɺ
ॲཧ͍ͯ͠ΔιʔείʔυͦͷͷͷใΛ ද͢ͷ͕1SPDFTTFE4PVSDFΦϒδΣΫτͰ͢ w 1SPDFTTFE4PVSDFޙड़͢Δ$PQ ϧʔϧ࣮ ͔ΒΞΫηεՄೳͳΦϒδΣΫτͰ͢ -
require 'rubocop-ast' ast = RuboCop::AST::ProcessedSource.new( 'puts "hello"', 3.1 ).ast #=>s(:send,
nil, :puts, s(:str, "hello")) ast.class 3VCP$PQ"451SPDFTTFE4PVSDFBTU -
require 'rubocop-ast' ast = RuboCop::AST::ProcessedSource.new( 'puts "hello"', 3.1 ).ast #=>s(:send,
nil, :puts, s(:str, "hello")) ast.class #=> RuboCop::AST::SendNode ast.class <= RuboCop::AST::Node # true 3VCP$PQ"454FOE/PEF -
w 1BSTFSఏڙͷ/PEF Λܧঝͨ͠ศར"1* w 3VCP$PQ"45ͷ શϊʔυ͕ܧঝ͢Δ εʔύʔΫϥε w 3VCP$PQϧʔϧ࣮ ͷࡍʹʑࢀর͢Δ
IUUQTHJUIVCDPNSVCPDPQIRSVCPDPQBTUCMPCNBTUFSMJCSVCPDPQBTUOPEFSC 3VCP$PQ"45/PEF -
ast.class #=> RuboCop::AST::SendNode ast.source #=> "puts \"hello\"" ast.location.line #=> 1
ast.loc.line #=> 1 ast.loc.column #=> 0 ast.loc.last_column #=> 12 ast.loc.source_range #=> ast.method_name #=> :puts ast.first_argument.basic_literal? #=> true 3VCP$PQ"454FOE/PEF -
3VCP$PQ"455SBWFSTBM require 'rubocop-ast' include RuboCop::AST::Traversal # Event handler for `send`
node def on_send(node) puts node.source end walk(ast) #=> puts "hello" -
3VCP$PQ"455SBWFSTBM require 'rubocop-ast' include RuboCop::AST::Traversal # Event handler for `send`
node def on_send(node) puts node.source end walk(ast) XBML BTU ຊฤͰͷݤͰ͢💡 -
3VCP$PQઃܭུ֓ 3VOOFS 5FBN 3FHJTUSZ $PQ#BTF NPCJMJ[F DPQ@DMBTTFT %FQU$VTUPN$PQ OFX DPEF
SVCZ@WFSTJPO OFX FOBCMFE $PNNJTTJPOFS JOWFTUJHBUF QSPDFTTFE@TPVSDF "455SBWFSTBM XBML BTU NJYJO JOWFTUJHBUF QSPDFTTFE@TPVSDF "45 1SPDFTTFE4PVSDF OFX OFX DPQT PO@YYY DBMMCBDL EFMFHBUFNFUIPET -
3VCP$PQઃܭུ֓ 3VOOFS 5FBN 3FHJTUSZ $PQ#BTF NPCJMJ[F DPQ@DMBTTFT %FQU$VTUPN$PQ OFX DPEF
SVCZ@WFSTJPO OFX FOBCMFE $PNNJTTJPOFS JOWFTUJHBUF QSPDFTTFE@TPVSDF "455SBWFSTBM XBML BTU NJYJO JOWFTUJHBUF QSPDFTTFE@TPVSDF "45 1SPDFTTFE4PVSDF OFX OFX DPQT ৭ͳ͠3VCP$PQϥϯλΠϜ 3VCP$PQ"45 ϧʔϧ֦ுϙΠϯτ PO@YYY DBMMCBDL EFMFHBUFNFUIPET -
$PNNJTTJPOFS XBML ⭐ JOWFTUJHBUFʹ͞Εͨ 1SPDFTTFE4PVSDFΛͱʹ͠ ͨ"45ΛҾʹXBMLϝιου ΛݺͿ XBML͔ΒίʔϧόοΫ͞Εͨ PO@YYYϝιουͱಉ໊Ͱ$PQʹ ఆٛ͞Ε͍ͯΔPO@YYYʹҠৡ͢Δ
IUUQTHJUIVCDPNSVCPDPQSVCPDPQCMPCWMJCSVCPDPQDPQDPNNJTTJPOFSSC 🔎 -
3VCP$PQઃܭུ֓ ࠶ܝ 3VOOFS 5FBN 3FHJTUSZ $PQ#BTF NPCJMJ[F DPQ@DMBTTFT %FQU$VTUPN$PQ OFX
DPEF SVCZ@WFSTJPO OFX FOBCMFE $PNNJTTJPOFS JOWFTUJHBUF QSPDFTTFE@TPVSDF "455SBWFSTBM XBML BTU NJYJO JOWFTUJHBUF QSPDFTTFE@TPVSDF "45 1SPDFTTFE4PVSDF OFX OFX DPQT ৭ͳ͠3VCP$PQϥϯλΠϜ 3VCP$PQ"45 ϧʔϧ֦ுϙΠϯτ PO@YYY DBMMCBDL EFMFHBUFNFUIPET -
module Cop module Style class MixinUsage < Base MSG =
'`%<statement>s` is used at the top level.' \ 'Use inside `class` or `module`.'.freeze RESTRICT_ON_SEND = %i[include extend prepend].freeze def_node_matcher :include_statement, <<~PATTERN (send nil? ${:include :extend :prepend} const) PATTERN def on_send(node) return unless (statement = include_statement(node)) return unless top_level_node?(node) add_offense(node, message: format(MSG, statement: statement)) end $PQ ϧʔϧ ͷ࣮ྫ -
4VQQPSUNBUSJY W
❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ❌ ❌ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ❌ ❌ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ❌ ❌ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ❌ ❌ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ "OBMZTJT3VCZWFSTJPOT TargetRubyVersionJOSVCPDPQZNM 3VOUJNF3VCZWFSTJPOT ruby -v