class

Amber::Router::RouteSet(T)

Inherits Reference < Object

A tree which stores and navigates routes associated with a web application.

A route set represents the branches of the tree, and each vertex is a Segment. Leaf nodes are TerminalSegments.

route_set = Amber::Router::RouteSet(Symbol).new
route_set.add "/get/", :root
route_set.add "/get/users/:id", :users
route_set.add "/get/users/:id/books", :users_books
route_set.add "/get/*/slug", :slug
route_set.add "/get/*", :catch_all
route_set.add "/get/posts/:page", :pages, {"page" => /\d+/}

route_set.formatted_s # => a textual representation of the routing tree

route_set.find("/get/users/3").payload           # => :users
route_set.find("/get/users/3/books").payload     # => :users_books
route_set.find("/get/coffee_maker/slug").payload # => :slug
route_set.find("/get/made/up/url").payload       # => :catch_all

route_set.find("/get/posts/123").found? # => true
route_set.find("/get/posts/one").found? # => false

Constructors

new(root : Bool = true)
Source

Instance methods

add(path, payload : T, constraints : Hash(String, Regex) = {} of String => Regex) : Nil

Add a route to the tree.

Source
add(path, payload : T, constraints : Hash(Symbol, Regex) | NamedTuple) : Nil

ditto

Source
find(path : String) : RoutedResult(T)

Find a route which is compatible with a path.

Source
find_routes(path : String) : Array(RoutedResult(T))

Returns the routes which are compatible with the provided path.

Source
formatted_s(*, ts = 0)

Produces a readable, indented rendering of the tree.

Source
routes?
Source