abstract class Analyzer::Ruby::RubyEngine

Direct Known Subclasses

Defined in:

analyzer/engines/ruby_engine.cr

Constant Summary

HTTP_VERBS = ["get", "post", "put", "delete", "patch", "head", "options"]
VERB_ROUTE_PATTERNS = HTTP_VERBS.map do |verb| {verb, /^#{verb}\s*\(?\s*['"](.+?)['"]/} end

Crystal recompiles an interpolated regex literal on every evaluation (a full PCRE2 JIT compile). The verb set is fixed, so precompile the <verb> "<path>" matchers once at load time.

Class Method Summary

Instance Method Summary

Instance methods inherited from class Analyzer

analyze analyze, base_path : String base_path, base_paths : Array(String) base_paths, callees_needed? : Bool callees_needed?, logger : NoirLogger logger, parallel_analyze(files : Array(String), &block : String -> Nil) parallel_analyze, read_file_content(path : String) : String read_file_content, result : Array(Endpoint) result, url : String url

Constructor methods inherited from class Analyzer

new(options : Hash(String, YAML::Any)) new

Macros inherited from class Analyzer

define_getter_methods(names) define_getter_methods

Instance methods inherited from module FileHelper

all_files : Array(String) all_files, get_files_by_extension(extension : String) : Array(String) get_files_by_extension, get_files_by_prefix(prefix : String) : Array(String) get_files_by_prefix, get_files_by_prefix_and_extension(prefix : String, extension : String) : Array(String) get_files_by_prefix_and_extension, get_public_dir_files(base_path : String, folder : String) : Array(String) get_public_dir_files, get_public_files(base_path : String, anchors : Array(String) = ["shard.yml", "Gemfile"]) : Array(String) get_public_files

Class Method Detail

def self.ruby_test_path?(path : String) : Bool #

Minitest's *_test.rb and RSpec's *_spec.rb conventions are rigid in Ruby — rake test / mri test only run files matching the first, and rspec discovers the second. Production Ruby never adopts either filename, so the suffix check is safe for every Ruby analyzer (sinatra, grape, roda, hanami). Promoted from Analyzer::Ruby::Sinatra (#1571) so the rest of the family stays in sync.

Test::Unit / Minitest equally support the inverse test_*.rb prefix (rake test globs test/test_*.rb). gollum, for instance, exercises its modular Sinatra app exclusively through test/test_app.rb-style files whose inline Rack::Test requests (get "/wiki/Home", post "/gollum/upload_file") are indistinguishable from real route registrations to a line-based matcher — ~70 phantom endpoints per scan. Production route files never carry the test_ prefix, so it is as safe as the suffix forms. We match on the basename only (never the full path) so a legitimate app that merely lives under a spec/-suffixed absolute path — e.g. noir's own fixtures — is untouched.


[View source]

Instance Method Detail

def line_to_endpoint(content : String, details : Details | Nil = nil) : Endpoint #

Match the <verb> "<path>" idiom on a single line and return the first endpoint found, or an empty endpoint if none match. Shared by Hanami and Sinatra (Rails uses a different per-line-multi-match shape).


[View source]