tyrant

KO | EN

gitlite — search

#java #python #android #api #nodejs #kotlin #spring-boot #php #typescript #javascript #react #cli

★ 50 Open GitHub ↗

Agnostic authentication gem with signup, signin, forgot password, sticky login, and so on.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Tyrant

_"Freedom choked in dread we live, since tyrant was enthroned."_

Tyrant implements all common steps of authorization workflows using overridable _operations_. It allows a quick setup of sign in, sign up, forgot password, etc. Tyrant works well in Rails, but plays well with any Ruby environment.

Operations are provided for the following steps.

* SignIn
  * Confirmed
  * Hammer protection (3x wrong blabla)
  * Sticky (Remember me)
* SignUp
* SignOut
* ResetPassword
* Forgot pw
* Multiple sessions with scopes

## Operations

trb instead of pushing into controller

Tyrant exposes its public API using operations.

Operations are the pivotal element in the [Trailblazer architecture](https://github.com/apotonick/trailblazer). When it comes to customization, Tyrant doesn't rely on a "hopefully complete" configuration language as Devise does it.

Tyrant allows you to customize with Ruby. You can override entire workflow steps (operations), forms and validations (contracts) or methods using simple object-orientation and a clean API.

This means you can easily use them in Rails controllers.

```ruby
class SessionController < ApplicationController
  def sign_in
    run Tyrant::SignIn
  end
```

You can also run the public API in any other Ruby environment, e.g. a console or a Roda action.

```ruby
Tyrant::SignIn.run(params)
```

Tyrant provides forms for all workflow steps. using [Reform](https://github.com/apotonick/reform) objects that are embedded into the operations.

=> Customize with inheritance, or override. Or just don't use the operation and write your own "step".

## Installation

Add this line to your application's Gemfile:

```ruby
gem 'tyrant'
```

## Rails

Tyrant comes with a railtie to provide you an initializer. In Rails, add this to an initializer.

```ruby
require "tyrant/railtie"
```

## License

The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

tyrant

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README