class

Analyzer::Perl::Mojolicious

Inherits Analyzer::Perl::PerlEngine < FileScanEngine < Analyzer < FileHelper < Reference < Object

Constants

ANGLE_PLACEHOLDER_RE = /<([:#*]?)([A-Za-z_]\w*)(?::[^<>]*)?>/

Mojolicious angle-bracket placeholders: <id>, <:id>, <#id>, <*id>, and the type-constrained <id:num> / <id:[^/]+>. Normalize them to the sigil form (:id, #id, *id) so URLs read consistently and the path-param scanner picks them up.

ASSIGNMENT_HEAD_RE = /^\s*(?:my|our|local)?\s*\$([A-Za-z_]\w*)\s*=\s*(.+)$/
CHAIN_RECEIVER_RE = /\$([A-Za-z_]\w*)\s*->/
CHAIN_ROUTE_CALL_RE = /->\s*(?:under|any|route)\s*\(/

A receiver chain that is already building a route: $r->under('/v2')->get(…).

CONVENTIONAL_ROUTE_VARS = Set {"r", "route", "routes", "router"}

Mojolicious names its route object $r (or $routes/$route/$router) by universal convention, including in helper subs that receive it as an argument (sub _api ($r) { $r->get('/x') }) where no assignment exists for build_prefix_maps to record. Accepted on top of the assignments it does see.

FULL_ANY_RE = /->\s*any\s*\(\s*(?:\[([^\]]+)\]\s*,?\s*=?>?\s*)?['"]([^'"]*)['"]/
FULL_ROUTE_RE = /->\s*route\s*\(\s*['"]([^'"]*)['"]\s*\)(?:\s*->\s*via\s*\(\s*([^)]+)\))?/
FULL_VERB_RE = /->\s*(get|post|put|patch|delete|del|options|head|websocket)\s*\(\s*['"]([^'"]*)['"]/

Leaf path may be empty ($r->get('')) — a Mojolicious idiom for a route that is its receiver's prefix (e.g. $auth->get('')), so the capture is [^'"]* rather than +.

A quoted argument does NOT make the call a route: $cache->get("ttl") and $self->stash->get("current_user") are ordinary data accessors and are the common shape, not an exotic one. Every ->verb(...) match is therefore additionally gated on route_receiver?.

HTTP_VERBS = ["get", "post", "put", "delete", "patch", "options", "head"] of ::String
LITE_ANY_RE = /^\s*any\s+(?:\[([^\]]+)\]\s*=>\s*)?['"]([^'"]+)['"]/
LITE_VERB_RE = /^\s*(get|post|put|patch|delete|del|options|head|websocket)\s+['"]([^'"]+)['"]/
MOJO_MARKERS = ["Mojolicious", "Mojo::Base"]

The file has to be Mojolicious before any of its ->get(…) calls can be a Mojolicious route. Mojolicious covers use Mojolicious, Mojolicious::Lite, Mojo::Base 'Mojolicious…', and the Plugin/Controller base classes; Mojo::Base covers a controller that subclasses another one of the app's controllers.

NAMED_TO_ARG_PATTERNS = {"controller" => /(?:^|[,\s])controller\s*=>\s*['"]([A-Za-z_][A-Za-z0-9_:\/-]*)['"]/, "action" => /(?:^|[,\s])action\s*=>\s*['"]([A-Za-z_][A-Za-z0-9_:\/-]*)['"]/}

Crystal recompiles an interpolated regex literal on every evaluation (a full PCRE2 JIT compile). Only controller and action are looked up, so precompile their matchers once at load time.

PATH_VAR_RE = /^\s*(?:my|our|local)?\s*\$([A-Za-z_]\w*)\s*=\s*(['"])(\/[^'"]*)\2\s*;?\s*$/
PREFIX_SEGMENT_RE = /->\s*(?:under|any|route)\s*\(\s*(?:\[[^\]]+\]\s*,?\s*=?>?\s*)?(?:(['"])([^'"]*)\1|\$([A-Za-z_]\w*))/

A prefix-building segment (->under/->any/->route) whose argument is either a quoted literal or a $var resolved against path_vars (a scalar holding a path string, e.g. my $p = '/tests/<id:num>').

PRELUDE_VAR_RE = /\$([A-Za-z_]\w*)/
ROUTES_ACCESSOR_RE = /->\s*routes\b/

A receiver chain that names the router itself: $self->routes->get(…), $app->routes->any(…), shift->routes->under(…).

TRAILING_VAR_RE = /\$([A-Za-z_]\w*)\s*$/

The bare $var sitting immediately left of the call, with nothing between it and the ->: the $cache of $cache->get("ttl").

Class methods

tech_name
Source

Instance methods

analyze
Source
analyze_content(content : String, file_path : String, include_callee : Bool = false, controller_callees : ControllerCalleeIndex = ControllerCalleeIndex.new) : Array(Endpoint)
Source
analyze_file(path : String) : Array(Endpoint)
Source
line_to_endpoints(line : String, var_prefix : Hash(String, String), path_vars : Hash(String, String), route_vars : Set(String)) : Array(Endpoint)
Source
line_to_endpoints(line : String, var_prefix : Hash(String, String), path_vars : Hash(String, String)) : Array(Endpoint)
Source
line_to_endpoints(line : String, var_prefix : Hash(String, String)) : Array(Endpoint)
Source
line_to_endpoints(line : String) : Array(Endpoint)
Source
tech

Instance-side view of the same declaration. The per-file rescues live on this base class, which has no way to name the analyzer that is running inside them, so a skipped file could not be attributed to a tech. Deriving it from analyzer_for keeps the name written exactly once.

Source

Nested types