/flame

Ruby web-framework

Primary LanguageRubyMIT LicenseMIT

Flame Logo

Flame

Cirrus CI Codecov Code Climate Depfu Docs Gem (including prereleases) MIT license

Flame is a small Ruby web framework, built on Rack, inspired by Gin (which follows class-controllers style), designed as a replacement Sinatra or maybe even Rails.

Why?

I didn't like class methods, especially for controller's hooks — OOP is prettier without it. And I found a way to implement controller's hooks without using class methods, but with the inheritance (including the including of modules). Moreover, with class methods an insufficiently obvious order of hooks (especially with inheritance) and complicated implementation of conditions are obtained. In this framework everything is Ruby-native as it can be.

Installation

Using the built-in gem:

$ gem install flame

or with Bundler:

# Gemfile
gem 'flame'

Usage

The simplest example:

# index_controller.rb

class IndexController < Flame::Controller
  def index
    view :index # or just `view`, Symbol as method-name by default
  end

  def hello_world
    "Hello World!"
  end

  def goodbye
    "Goodbye World!"
  end
end

# app.rb

class App < Flame::Application
  mount IndexController do
    # all methods will be mounted automatically, it's just an example of refinement
    get '/hello', :hello_world
  end
end

# config.ru

require_relative './index_controller'

require_relative './app'

run App.new # or `run App`

More at Wiki.

Benchmark

The last benchmark can be viewed here.

Development

After checking out the repo, run bundle install to install dependencies.

Then, run toys rspec to run the tests.

To install this gem onto your local machine, run toys gem install.

To release a new version, run toys gem release %version%. See how it works here.

Contributing

Bug reports and pull requests are welcome on GitHub.

License

The gem is available as open source under the terms of the MIT License.