Project

carrier

0.01
No commit activity in last 3 years
No release in over 3 years
Raw github-like messaging system to reuse across Rails apps. Acts as Rails 3.1 mountable engine. Fast and robust.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
 Dependencies

Development

>= 0
>= 0
>= 1.6.4
>= 0
>= 3.1

Runtime

 Project Readme

Carrier

Carrier is result of extracting simple messaging functionality from one working Rails app.

Installiation

Insert into Gemfile

gem 'carrier'

Run bundler to bundle gems in the app

$ bundle update

Since Carrier is a Rails 3.1 mountable app, you need to define mount point like:

# config/routes.rb
mount Carrier::Engine => "/carrier" 

Install Carrier’s migrations and run them:

rake carrier:install:migrations
rake db:migrate

Carrier uses Unread to manage read/unread status of messages. So add this into your User model:

# app/models/user.rb
class User < ActiveRecord::Base
  # ...
  acts_as_reader
  # ...
end

Carrier works only for authenticated users expecting #current_user method somehow defined.
Carrier’s controllers namespaces are isolated, so to provide authentication procedure yielding #current_user (before_filter is most common way) add it to Carrier::ApplicationController like:

# your app's root/app/controllers/carrier/application_controller.rb
module Carrier
  class ApplicationController < ActionController::Base
    before_filter :authenticate_user! # If using Devise
  end
end

This ensures that Carrier will be aware of current authenticated user.

Point your browser to your_apps’s url/carrier, fx:

http://localhost/carrier

and you are on the go!

Prerequisites

  • Rails 3.1
  • Carrier has been tested with Devise as authentication system. Any other solution providing #current_user should be just fine too.
  • Carrier has been tested to work with MySQL and PostgreSQL.
    It doesn’t work with SQLite3, because sqlite3 doesn’t serialize fields (maybe this is the issue of current gem environment only). Scope’s queries are using the most basic Arel features so it should be easy to use any other ORM.

Design overview

The Carrier design is very simple:

It has messages and chains (Message model, and Chain model). Message model has chain_id i.e. messages are simply grouped in chains. Chains are non-threaded, each chain is just a linear sequence of messages.

All queries to messages and their chains are being done using scopes with joins and includes so performance is expected to be fast (review it and advice how accomplish it even better!).

Carrier doesn’t support deletion of messages yet. Instead it supports archivation of chains (Chain has #archived_for field to store serialized array of user’s ids).

Configuration

Carrier’s templates are written in I18n way. Carrier has two locales :en and :ru pre-written. If you change locale in config/application.rb Carrier will try to find corresponding rules from locale’s yml files

More coming…

Quick try

Try dummy app located in spec/ folder. Clone repo, then:

# edit Gemfile:
gem 'mysql' or gem 'pg'
bundle 
cd spec/dummy
rake reset_db # shortcut for rake db:drop => create => migrate => seed
rails s
http://localhost/carrier

TODO

  • Deletion along with archivation
  • ORM’s support
  • More and better tests

Contributors

  • Stanislaw Pankevich

Copyright

Copyright © 2011 Stanislaw Pankevich. See LICENSE for details.