class Analyzer::Perl::Mojolicious

• Analyzer::Perl::Mojolicious
• Analyzer::Perl::PerlEngine
• FileScanEngine
• Analyzer
• Reference
• Object

Defined in:

Constant Summary

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 Method Summary

• .tech_name : String

Instance Method Summary

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

  Instance-side view of the same declaration.

Class Method Detail

Instance Method Detail