module Noir::TreeSitterKotlinRouteExtractor

Overview

Tree-sitter-backed Kotlin route extractor.

Spring-style annotation routing — class-level @RequestMapping-family annotations composing with method-level mapping annotations. Mirrors TreeSitterJavaRouteExtractor but for Kotlin's distinct AST shape (annotations live in modifiers, functions use function_declaration, primary constructors carry DTO fields, etc.).

This file holds the class-tree walking, mapping prefixes and controller/interface/Feign routes; the sibling files in this directory reopen the module with one concern each (STOMP, GraphQL, gateway, WebFlux functional DSL, shared decoding helpers).

Ktor's DSL routing { get("/x") { ... } } is a different authoring style and lives in a separate walker (kotlin_ktor_route_extractor_ts.cr).

Extended Modules

Defined in:

miniparsers/kotlin_route_extractor_ts/core.cr
miniparsers/kotlin_route_extractor_ts/gateway.cr
miniparsers/kotlin_route_extractor_ts/graphql.cr
miniparsers/kotlin_route_extractor_ts/helpers.cr
miniparsers/kotlin_route_extractor_ts/stomp.cr
miniparsers/kotlin_route_extractor_ts/webflux.cr

Constant Summary

ANNOTATION_VERBS = {"GetMapping" => "GET", "PostMapping" => "POST", "PutMapping" => "PUT", "DeleteMapping" => "DELETE", "PatchMapping" => "PATCH", "RequestMapping" => nil}

Spring mapping annotation names → HTTP verb. nil means look at the annotation's method = argument. Same table as the Java extractor for consistency.

Instance Method Summary

Instance Method Detail

def expand_constant_interpolations(constants : Hash(String, String)) : Hash(String, String) #

Resolve Kotlin string-template interpolations inside collected constant values, e.g. const val STATIC_URL = "$PUBLIC_URL/static" with PUBLIC_URL = "/public" becomes /public/static. The regex capture in #extract_string_constants stores the raw $PUBLIC_URL text, so without this a path built from such a constant keeps the literal $VAR (or, as an inline annotation literal, mis-parses it as a {VAR} path placeholder). Unresolved references (e.g. Spring ${config.property} placeholders) are left untouched. Bounded iterations resolve transitive chains.


[View source]
def extract_controller_interface_implementations_from(root : LibTreeSitter::TSNode, source : String, string_constants = Hash(String, String).new, local_string_constants : Hash(String, String) | Nil = nil) : Array(ControllerInterfaceImplementation) #

[View source]
def extract_graphql_routes_from(root : LibTreeSitter::TSNode, source : String, string_constants = Hash(String, String).new, local_string_constants : Hash(String, String) | Nil = nil) : Array(GraphqlRoute) #

[View source]
def extract_interface_routes_from(root : LibTreeSitter::TSNode, source : String, string_constants = Hash(String, String).new, local_string_constants : Hash(String, String) | Nil = nil) : Hash(String, Array(Route)) #

[View source]
def extract_routes(source : String, string_constants = Hash(String, String).new) : Array(Route) #

[View source]
def extract_routes_from(root : LibTreeSitter::TSNode, source : String, string_constants = Hash(String, String).new, local_string_constants : Hash(String, String) | Nil = nil) : Array(Route) #

_from(root, source) — accept a pre-parsed root so the Kotlin Spring analyzer can amortise the parse across multiple extractions on the same file. Tree lifetime is the caller's responsibility.


[View source]
def extract_stomp_application_prefixes(source : String, string_constants = Hash(String, String).new, local_string_constants : Hash(String, String) | Nil = nil) : Array(String) #

[View source]
def extract_stomp_routes_from(root : LibTreeSitter::TSNode, source : String, string_constants = Hash(String, String).new, local_string_constants : Hash(String, String) | Nil = nil, application_prefixes = [""]) : Array(Route) #

[View source]
def extract_string_constants(source : String) : Hash(String, String) #

[View source]