Project

ari

0.0
No commit activity in last 3 years
No release in over 3 years
Inspects and navigate through Activerecord data via relations defined in models
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

~> 3.0
 Project Readme

Ari

Active Record Inspector - extend rails project to easily display and navigate through ActiveRecord Models. Ari will display model data including columns, relations (has and belongs) and custom functions. It's easy to customize and extend Ari for your purposes.

Features

  • Generators - automatically generate Ari controller and corresponding views
  • Ari will display both belongs to and has relations as links for easy navigation
  • Customize each model which columns you don't wanna to display
  • Add functions that you like to display

Requirements

  • Rails 3+

Installation

Install 'ari' gem:

gem 'ari'

or

gem 'ari', :git => git://github.com/ATLANTBH/ari.git

Note: Currently ari was tested only on rails 3.0+

Setup

After installation run ari generator.

rails generate ari

Add following resource to routes.rb.

resources :ari, :only => [:index, :show]

Run rails and point your browser to ari route, e.g. http://localhost:3000/ari

Customization

By default ari will display following information from model:

  • all columns
  • all has_ relations
  • all belongs_ relations

You can exclude informations via ari_options

class User < ActiveRecord::Base
	ari_options	:exclude => [:password, :money]
end

This will exclude columns/relations names 'password' and 'money' from displaying.

In addition to excluding, sometimes is good idea to include results from some functions, e.g.

class User < ActiveRecord::Base
	ari_options	:exclude => [:password, :money], :functions => ['displayable_name']
	
	def displayable_name
		return self.name || self.email  # if name is nil return email as displayable_name
	end
end

Preview

Here is preview of ari:

Model listing Sample table 1 Sample table 2

Note

AriController is inherited from ActionController::Base and it's strongly recomanded to extend AriController from some Admin-like controllers in production environment so it will not be accessible by everyone.

License

Copyright 2012 AtlantBH

ari is licensed under the MIT License.

For more info see MIT_LICENSE file.