class Analyzer::Zig::Zap

• Analyzer::Zig::Zap
• Analyzer
• Reference
• Object

Overview

zap exposes routes two ways:

• Endpoint structs — a struct (often the whole file via pub const X = @This();) carrying a path slug and one verb method per supported HTTP method (pub fn get/post/put/delete/patch/options/ head). The slug is usually bound where the endpoint is instantiated (X.init("/users", …), .{ .path = "/stop" }), not inside the struct, so paths are resolved project-wide and keyed by struct type.
• zap.Router — router.handle_func("/p", &inst, &T.method) and router.handle_func_unbound("/p", handler) map a path to a handler for any method.

Defined in:

Constant Summary

ENDPOINT_INIT_RE = /(?:zap\s*\.\s*)?Endpoint\s*\.\s*init\s*\(\s*\.\s*\{/

Modern zap.Endpoint.init(.{ .path = …, .get = handler, … }) API: the supported HTTP methods are declared as option fields bound to handler functions, instead of as pub fn get/… verb methods on the struct. The path field is usually a parameter resolved at the T.init("/p", …) call site, so it is reused through the same bindings machinery.

FIELD_PATH_RE = /\bpath\s*:\s*\[\]const u8\s*=\s*"([^"]*)"/

HANDLE_FUNC_RE = /\.\s*handle_func(_unbound)?\s*\(/

IMPORT_RE = /(?:pub\s+)?(?:const|var)\s+([A-Za-z_]\w*)\s*=\s*@import\(\s*"([^"]+\.zig)"\s*\)/

INIT_RE = /(?<![A-Za-z0-9_])([A-Za-z_]\w*)\.init\s*\(([^()]*)\)/

. is intentionally NOT in the lookbehind: endpoint types are commonly reached through a namespace re-export (Endpoints.UserWeb.init("/u")), and the meaningful key is the final segment (UserWeb), which is itself preceded by a ..

INIT_VERB_RE = /\.\s*(get|post|put|delete|patch|options|head)\s*=\s*&?\s*([A-Za-z_][\w.]*)/

LITERAL_PATH_RE = /\.path\s*=\s*"([^"]*)"/

PATH_OR_INIT_RE = Regex.union(".path", ".init(")

Cheap path-binding gate: one precompiled Regex.union scan (PCRE2 JIT) in place of two naive String#includes? char scans. Equivalent to includes?(".path") || includes?(".init(").

STRUCT_DECL_RE = /(?:^|[^A-Za-z0-9_.])(?:pub\s+)?const\s+([A-Za-z_]\w*)\s*=\s*struct\s*\{/

THIS_DECL_RE = /(?:^|[^A-Za-z0-9_.])(?:pub\s+)?const\s+([A-Za-z_]\w*)\s*=\s*@This\(\)/

VERB_METHOD = {"get" => "GET", "post" => "POST", "put" => "PUT", "delete" => "DELETE", "patch" => "PATCH", "options" => "OPTIONS", "head" => "HEAD"}

VERBS = ["get", "post", "put", "delete", "patch", "options", "head"] of ::String

Instance Method Summary

• #analyze

Instance Method Detail