Litera - Messages Dashboard

This rails engine aims to provide a simple dasboard for the messages received in your application regardless the services you are using to handle your messages (GooglePubSub, Amazon SQS, Apache Kafka, etc) in order to easily track and debug the data in your received data.

Add Litera to your application's Gemfile:

gem "litera"

And then install litera:

rails g litera:install

Install litera migrations:

rails g litera:install:migrations

Run pending migrations:

rails db:migrate

Add the following line to your app/assets/config/manifest.js:

//= link litera/application.css

Lastly, mount litera engine in your config/routes.rb:

Rails.application.routes.draw do
  mount Litera::Engine => "/litera"
  ...
end

Configure what is the name of the method that returns your current user and how he will be authorized to access the messages dashboard.

Litera.setup do |config|
  # Configure what is the name of the method that returns the current
  # logged in user in your application.
  # config.litera_user = :current_user

  # Setup the name of the main application controller in your application.
  # config.parent_controller = "ApplicationController"

  # Define how the current user will be authorized ot not to access the
  # messages dashboard.
  # config.authorization = -> (user) do
    # user.admin?
  # end
end

Track your messages inmmediately after you received them using:

Litera::Message.create!({
  service: :google_pub_sub,
  body: message.body,
  metadata: message.attributes,
  external_id: message.message_id,
  published_at: message.published_at
})

You can use an active job if you want to save it in background:

Litera::MessageJob.perform_later({
  service: :google_pub_sub,
  body: message.body,
  metadata: message.attributes,
  external_id: message.message_id,
  published_at: message.published_at
})

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and the created tag, and push the .gem file to rubygems.org.

Bug reports and pull requests are welcome on GitHub at https://github.com/amco/litera-rb. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.

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

Everyone interacting in the Litera project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.