module Noir::TreeSitterKotlinKtorRouteExtractor

Overview

Tree-sitter-backed Ktor DSL route extractor.

Walks the canonical Ktor server idiom:

routing {
  get("/x") { ... }
  route("/api") {
    post("/items") { val item = call.receive < Item > () }
  }
  authenticate("auth-jwt") {
    get("/profile") { ... }
  }
}

Recognises:

• Verb DSL calls — get/post/put/delete/patch/head/options with a string-literal path argument and a trailing lambda body.
• route("/x") { ... } blocks contributing to the path prefix.
• authenticate("realm") { ... } blocks acting as transparent wrappers (no prefix change). Tagging is handled elsewhere; we just descend so wrapped routes are still discovered.
• routing { ... } and application.routing { ... } entry points.
• Inside each verb's lambda body:
  • call.receive<T>() → body parameter typed T as json
  • call.parameters["name"] → name parameter as query
  • call.request.headers["name"] → name parameter as header

Not covered yet (out of scope for this first cut):

• Resource-based routing (get<Resource> { ... }).
• Type-safe routing via @Resource.
• install(plugin) { ... } plugin scoping that affects routing.

Extended Modules

• Noir::TreeSitterKotlinKtorRouteExtractor

Defined in:

miniparsers/kotlin_ktor_route_extractor_ts.cr

Constant Summary

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

PASSTHROUGH_NAMES = Set {"routing", "authenticate", "rateLimit", "install", "intercept", "host", "port"}

Pass-through DSL calls — descend into their lambda body without changing the path prefix. routing is the entry point; authenticate wraps a sub-tree behind an auth realm; the remaining names cover the common Ktor scoping helpers.

Instance Method Summary

• #extract_routes(source : String, *, include_callees : Bool = false) : Array(Route)

Instance Method Detail