h1. dm-redis-adapter
This is a DataMapper adapter for the Redis key-value store.
Redis is a very fast key-value store with some interesting data structures added, and oh so much more. You can have a key that is a SET, LIST, STRING or HASH that is binary safe. Data structures like SET and LIST allow for even more interesting things. Redis is a fabulous and fast engine for data structures, and you can read more about it here: redis. Redis is also a persistent data store, and can be used in large-scale environments with master-slave replication and consistent hashing on the client side. Redis makes everyone happy and has been known to cause sunshine to spontaneously break out in clouded areas.
DataMapper is a brilliant ORM that is based on the IdentityMap pattern. Usage of DataMapper resembles that of ActiveRecord, the popular ORM bundled with Ruby on Rails, but with some very important differences. A quote from the DM wiki: "One row in the database should equal one object reference. Pretty simple idea. Pretty profound impact." Having an identity map allows for very efficient queries to the database, as well as interesting forms of lazy loading of attributes or associations.
Marrying DataMapper to Redis allows for schema-less models, you can add fields at any time without having to create a migration. DataMapper also allows us to store non-native Redis types in the db, like Date fields.
h1. Upgrading
Please note that as of version 0.5.3 of the gem, the key names that are used for storage have changed and break compatibility with previous versions!
h1. Changelog
h1. Install
Prerequisites:
Install the dm-redis-adapter:
> gem install dm-redis-adapter
h1. Usage
Setup your adapter, define your models and properties:
require 'rubygems'
require 'dm-core'
require 'dm-redis-adapter'
DataMapper.setup(:default, {:adapter => "redis"})
class Cafe
include DataMapper::Resource
property :id, Serial
property :name, Text
end
Cafe.finalize
Cafe.create(:name => "Whoahbot's Caffienitorium")
Now you can use redis in a ORM style, and take advantage of all of the amazing things that DataMapper offers.
If you want to do finds on specific String fields, add an index:
class Coffee
include DataMapper::Resource
property :id, Serial
property :description, String, :index => true
end
Coffee.create(:description => "Notes of crude oil and sulphur")
Coffee.first(:description => "Notes of crude oil and sulphur") # will now work
Validations on unique fields are now supported through indices and dm-validations:
class Crumblecake
include DataMapper::Resource
validates_is_unique :flavor
property :id, Serial
property :flavor, String, :index => true
end
Crumblecake.create(:flavor => "snozzbler")
Crumblecake.new(:flavor => "snozzbler").valid? # false (of course! Who ever heard of a snozzbler crumblecake?)
h1. Badass contributors
FAQs
Unknown package
We found that dm-redis-adapter demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
In this segment of the Risky Business podcast, Feross Aboukhadijeh and Patrick Gray discuss the challenges of tracking malware discovered in open source softare.
Research
Security News
A threat actor's playbook for exploiting the npm ecosystem was exposed on the dark web, detailing how to build a blockchain-powered botnet.
Security News
NVD’s backlog surpasses 20,000 CVEs as analysis slows and NIST announces new system updates to address ongoing delays.