Module: Hanami

Defined in:
lib/hanami.rb,
lib/hanami/app.rb,
lib/hanami/cli.rb,
lib/hanami/env.rb,
lib/hanami/root.rb,
lib/hanami/static.rb,
lib/hanami/routes.rb,
lib/hanami/server.rb,
lib/hanami/welcome.rb,
lib/hanami/version.rb,
lib/hanami/hanamirc.rb,
lib/hanami/cli_base.rb,
lib/hanami/middleware.rb,
lib/hanami/components.rb,
lib/hanami/application.rb,
lib/hanami/rake_helper.rb,
lib/hanami/environment.rb,
lib/hanami/assets/asset.rb,
lib/hanami/assets/static.rb,
lib/hanami/config/logger.rb,
lib/hanami/config/mapper.rb,
lib/hanami/config/routes.rb,
lib/hanami/commands/apps.rb,
lib/hanami/configuration.rb,
lib/hanami/views/default.rb,
lib/hanami/config/cookies.rb,
lib/hanami/config/sessions.rb,
lib/hanami/config/security.rb,
lib/hanami/commands/routes.rb,
lib/hanami/commands/server.rb,
lib/hanami/routing/default.rb,
lib/hanami/views/null_view.rb,
lib/hanami/rendering_policy.rb,
lib/hanami/application_name.rb,
lib/hanami/commands/command.rb,
lib/hanami/commands/db/drop.rb,
lib/hanami/commands/new/app.rb,
lib/hanami/commands/console.rb,
lib/hanami/config/load_paths.rb,
lib/hanami/commands/db/apply.rb,
lib/hanami/commands/db/create.rb,
lib/hanami/components/app/view.rb,
lib/hanami/commands/db/prepare.rb,
lib/hanami/commands/db/version.rb,
lib/hanami/commands/db/migrate.rb,
lib/hanami/commands/db/console.rb,
lib/hanami/cli_sub_commands/db.rb,
lib/hanami/components/component.rb,
lib/hanami/generators/generator.rb,
lib/hanami/components/app/assets.rb,
lib/hanami/components/app/logger.rb,
lib/hanami/components/app/routes.rb,
lib/hanami/components/components.rb,
lib/hanami/commands/generate/app.rb,
lib/hanami/commands/new/abstract.rb,
lib/hanami/application_namespace.rb,
lib/hanami/action/csrf_protection.rb,
lib/hanami/action/routing_helpers.rb,
lib/hanami/commands/new/container.rb,
lib/hanami/generators/generatable.rb,
lib/hanami/commands/generate/model.rb,
lib/hanami/cli_sub_commands/assets.rb,
lib/hanami/commands/generate/action.rb,
lib/hanami/commands/generate/mailer.rb,
lib/hanami/cli_sub_commands/destroy.rb,
lib/hanami/components/app/controller.rb,
lib/hanami/application_configuration.rb,
lib/hanami/cli_sub_commands/generate.rb,
lib/hanami/generators/test_framework.rb,
lib/hanami/commands/generate/abstract.rb,
lib/hanami/commands/assets/precompile.rb,
lib/hanami/generators/template_engine.rb,
lib/hanami/generators/database_config.rb,
lib/hanami/components/routes_inspector.rb,
lib/hanami/commands/generate/migration.rb,
lib/hanami/views/default_template_finder.rb,
lib/hanami/config/framework_configuration.rb,
lib/hanami/commands/generate/secret_token.rb,
lib/hanami/environment_application_configurations.rb

Overview

Copyright notice

This file contains a method copied from Rack::Static (rack gem).

Rack - Copyright (C) 2007 Christian Neukirchen Released under the MIT License

Defined Under Namespace

Modules: Action, Assets, CliBase, Commands, Components, Config, Generators, Mailer, Routing, Version, Views Classes: App, Application, ApplicationConfiguration, ApplicationName, ApplicationNamespace, Cli, CliSubCommands, Configuration, Env, Environment, EnvironmentApplicationConfigurations, Hanamirc, Middleware, RakeHelper, RenderingPolicy, Routes, Server, Static, Welcome

Constant Summary collapse

DEFAULT_PUBLIC_DIRECTORY =

This constant is part of a private API. You should avoid using this constant if possible, as it may be removed or be changed in the future.

Since:

  • 0.6.0

'public'.freeze
VERSION =

Defines the full version

Since:

  • 0.1.0

Version.version

Class Method Summary collapse

Class Method Details

.appHanami::App

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Main application that mounts many Rack and/or Hanami applications.

This is used as integration point for:

* `config.ru` (`run Hanami.app`)
* Feature tests (`Capybara.app = Hanami.app`)

Returns:

Since:

  • 0.9.0


99
100
101
# File 'lib/hanami.rb', line 99

def self.app
  App.new(configuration, environment)
end

.bootObject

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Boot Hanami project

Since:

  • 0.9.0


84
85
86
# File 'lib/hanami.rb', line 84

def self.boot
  Components.resolve('all')
end

.configurationHanami::Configuration

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Hanami configuration

Returns:

See Also:

Since:

  • 0.9.0


73
74
75
76
77
78
# File 'lib/hanami.rb', line 73

def self.configuration
  @_mutex.synchronize do
    raise "Hanami not configured" unless defined?(@_configuration)
    @_configuration
  end
end

.configure(&blk) ⇒ Object

Configure Hanami project

Please note that the code for this method is generated by `hanami new`.

Examples:

# config/environment.rb

# ...

Hanami.configure do
  mount Admin::Application, at: "/admin"
  mount Web::Application,   at: "/"

  model do
    adapter :sql, ENV['DATABASE_URL']

    migrations "db/migrations"
    schema     "db/schema.sql"
  end

  mailer do
    root "lib/bookshelf/mailers"

    delivery do
      development :test
      test        :test
      # production :smtp, address: ENV['SMTP_HOST'], port: 1025
    end
  end
end

Parameters:

  • blk (Proc)

    the configuration block

Since:

  • 0.9.0


59
60
61
62
63
# File 'lib/hanami.rb', line 59

def self.configure(&blk)
  @_mutex.synchronize do
    @_configuration = Hanami::Configuration.new(&blk)
  end
end

.envString

Return the current environment

Examples:

Hanami.env => "development"

Returns:

  • (String)

    the current environment

See Also:

Since:

  • 0.3.1


138
139
140
# File 'lib/hanami.rb', line 138

def self.env
  environment.environment
end

.env?(*names) ⇒ TrueClass, FalseClass

Check to see if specified environment(s) matches the current environment.

If multiple names are given, it returns true, if at least one of them matches the current environment.

Examples:

Single name

puts ENV['HANAMI_ENV'] # => "development"

Hanami.env?(:development)  # => true
Hanami.env?('development') # => true

Hanami.env?(:production)   # => false

Multiple names

puts ENV['HANAMI_ENV'] # => "development"

Hanami.env?(:development, :test)   # => true
Hanami.env?(:production, :staging) # => false

Returns:

  • (TrueClass, FalseClass)

    the result of the check

See Also:

Since:

  • 0.3.1


166
167
168
# File 'lib/hanami.rb', line 166

def self.env?(*names)
  environment.environment?(*names)
end

.environmentHanami::Environment

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Current environment

Returns:

Since:

  • 0.3.2


176
177
178
179
180
# File 'lib/hanami.rb', line 176

def self.environment
  Components.resolved('environment') do
    Environment.new
  end
end

.public_directoryPathname

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Project public directory

Examples:

Hanami.public_directory # => #<Pathname:/Users/luca/Code/bookshelf/public>

Returns:

  • (Pathname)

    public directory

Since:

  • 0.6.0


124
125
126
# File 'lib/hanami.rb', line 124

def self.public_directory
  root.join(DEFAULT_PUBLIC_DIRECTORY)
end

.rootPathname

Return root of the project (top level directory).

Examples:

Hanami.root # => #<Pathname:/Users/luca/Code/bookshelf>

Returns:

  • (Pathname)

    root path

Since:

  • 0.3.2


111
112
113
# File 'lib/hanami.rb', line 111

def self.root
  environment.root
end