Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A loyal data retriever for your Rails development databases.
branch: master

This branch is 62 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 applications' 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.

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.
  • *Support for creating/inserting new records and documents is targetted for the next point release
  • Automatic Rails application discovery within the current app's parent folder for easy app switching

Supported Database Adapters

Labrador supports most mainstream database adapaters 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

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.