Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
A loyal data retriever for your Rails development databases.
Branch: master
Pull request Compare This branch is 42 commits behind chrismccord:master.

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
app
config
db
doc
lib
log
public
script
test
vendor
.gitignore
.powrc
Gemfile
Gemfile.lock
README.md
Rakefile
config.ru
test.db

README.md

Labrador v0.1.0

A loyal database (agnostic) client for your Rails development databases.

Installation

Labrador can be installed by a single copy paste of aggregated shell commands. Detailed instructions can be found on labrador's homepage.

Upgrading

$ cd ~/.labrador
$ git pull origin master
$ mkdir -p tmp/
$ touch tmp/restart.txt

Features

  • Automatic intregation with pow, allowing you to hit (myapp.larabdor.dev) and be up and running
  • Listing/paging, update, and delete support of records/documents across all your development tables/collections.
  • Easy schema viewing for all your SQL database tables
  • Automatic Rails application discovery within the current app's parent folder for easy app switching

Supported Database Adapters

Labrador supports most mainstream database adapters and Rails database configurations. If you are using ActiveRecord, Datamapper, or Mongoid with standard database.yml or mongoid.yml configurations your databases will be connected to automatically.

  • Postregsql
  • MySQL
  • SQlite
  • MongoDB

OSX Support

Zero setup is required after installation when pow is installed. Simply install and then load up myapp.labrador.dev.

Other Linux/Unix Support

Add this to your .bash_profile or equivalent

alias labrador-start="cd $HOME/.labrador && bundle exec rails s -e production -p 7488"

After the server is started, you can then load up localhost:7488/~/Path/to/myapp

Roadmap

  • Arbitrary queries
  • Record creation
  • Manual database connections
  • Redis support

Testing

rake test

Add adapter_test configurations with credentials for each adapter to config/database.yml. ie:

adapter_test:
  mysql:
    database: labrador_test
    host: localhost
    user: username
    password: password
    port: 3306
  postgres:
    database: labrador_test
    host: localhost
    user: username
    password: password
    port: 5432
  mongodb:
    database: labrador_test
    host: 127.0.0.1
    user: username
    password: password
    port: 27017

Note - The sqlite adapter uses a local .sqlite3 file in test/fixtures.

Known Limitations

Labrador uses pure ruby adapters for mysql and postgres to avoid incompatibilities with users lacking postgres or mysql headers for native extension compilation. These implementations are unable to establish database connections over SSL.

Something went wrong with that request. Please try again.