tarolandia / cassandro

Ruby ORM for Apache Cassandra

Cassandro

Cassandro is a small Ruby ORM for Apache Cassandra 2.0 and CQL 3.0. Cassandro uses the new Datastax Ruby Driver

Install

gem install cassandro

Changelog

v2.1.0

• Raise Cassandra::Errors::ClientError exception when trying to interact with Cassandra without a connection
• SoftDelete Update: refactor where, count and query methods to exclude deleted records by default.

v2.0.1

• Fix Model#count for boolean fields

v2.0

• Support cassandra-driver >= 2.0
• Allow registering indexes in model's definition
• Add Model#ttl method

v1.2

• TTL
• Model-wide TTL
• Single record TTL
• Support :set datatype
• Ignore columns not definied on model

Example

class Developer < Cassandro::Model
  table :developers
  
  attribute :email, :text
  attribute :repos, :integer
  attribute :nickname, :text
  
  primary_key [:id, :repos]
  
  index :nickname
end

Cassandro.connect(hosts: ['127.0.0.1'], keyspace: 'little_cassandro')

Developer.create(email: '[email protected]', repos: 10, nickname: 'cassandro')

Documentation

• Getting Started
• Migrations
• Modeling
• Querying
• Advanced Features

TODO

• Improve querying

How to collaborate

If you find a bug or want to collaborate with the code, you can:

• Report issues trhough the issue tracker
• Fork the repository into your own account and submit a Pull Request

cassandro's Issues

Add support for multiple DB connections

Support connect to different databases within Cassandro module

Check connection before queries

If connection was not created then unexpected nil errors appears. Add a connection check and throw an exception if it's not connected

Support datatype Counter

Improve SoftDelete find methods

Refactor where, count and query methods to exclude deleted rows when using SoftDelete extension

Add TTL to Cassandro::Model

Add TTL support to Cassandro::Model.
Allow the posibility to set the TTL for all the records in the table.
Allow the posibility to set the TTL for one record only when creating it.

Update README / Improve Documentation

Before releasing Cassandro 2.0 we need to rewrite/improve documentation.

Support driver Pagination

Can't update existing record due to missing method

Hi

When I try to save an existing record by doing "foo.save" it fails with this error:

NoMethodError: undefined method `metadata' for #<Cassandra::Statements::Prepared:0x000001089c2850>
    from /Users/ryanwilliams/.rvm/gems/ruby-2.1.2/gems/cassandro-1.0.3/lib/cassandro/model.rb:291:in `statement_for'
    from /Users/ryanwilliams/.rvm/gems/ruby-2.1.2/gems/cassandro-1.0.3/lib/cassandro/model.rb:100:in `save'

Seems like a bug to me. Perhaps the wrong version of ruby-driver?

Support cassandra-driver 2.0

Current cassandro implementation does not support core changes made for cassandra-driver on version 2.0