Skip to content

module Athena::Framework #



The name of the environment variable used to determine Athena's current environment.

Log = ::Log.for("athena.framework")#

VERSION = "0.19.1"#

Class methods#

.environment : String#

Returns the current environment Athena is in based on ENV_NAME. Defaults to development if not defined.

View source

.run(port : Int32 = 3000, host : String = "", reuse_port : Bool = false, ssl_context : OpenSSL::SSL::Context::Server | Nil = nil, *, prepend_handlers : Array(HTTP::Handler) = [] of HTTP::Handler) : Nil#

Runs an HTTP::Server listening on the given port and host.

require "athena"

class ExampleController < ATH::Controller
  def root : String
    "At the index"

prepend_handlers can be used to execute an array of HTTP::Handler before Athena takes over. This can be useful to provide backwards compatibility with existing handlers until they can ported to Athena concepts, or for supporting things Athena does not support, such as WebSockets.

See ATH::Controller for more information on defining controllers/route actions.

View source



Primary entrypoint for configuring Athena Framework applications.

See the Getting Started docs for more information.


This is an alias of ADI.configure.

View source


Registers the provided bundle with the framework.

See the Getting Started docs for more information.

View source