[gem]: https://rubygems.org/gems/rom
[travis]: https://travis-ci.org/rom-rb/rom
[gemnasium]: https://gemnasium.com/rom-rb/rom
[codeclimate]: https://codeclimate.com/github/rom-rb/rom
[coveralls]: https://coveralls.io/r/rom-rb/rom
[inchpages]: http://inch-ci.org/github/rom-rb/rom/

# rom [![Gitter chat](https://badges.gitter.im/rom-rb/chat.svg)](https://gitter.im/rom-rb/chat)

[![Gem Version](https://badge.fury.io/rb/rom.svg)][gem]
[![Build Status](https://travis-ci.org/rom-rb/rom.svg?branch=master)][travis]
[![Dependency Status](https://gemnasium.com/rom-rb/rom.svg)][gemnasium]
[![Code Climate](https://codeclimate.com/github/rom-rb/rom/badges/gpa.svg)][codeclimate]
[![Test Coverage](https://codeclimate.com/github/rom-rb/rom/badges/coverage.svg)][codeclimate]
[![Inline docs](http://inch-ci.org/github/rom-rb/rom.svg?branch=master&style=flat)][inchpages]

Ruby Object Mapper (ROM) is a data mapping and persistence toolkit for Ruby
with the goal to provide powerful object mapping capabilities without limiting
the full power of your datastore.

Learn more:

* [Introduction](http://rom-rb.org/learn/introduction)
* [Quick Start](http://rom-rb.org/learn/repositories/quick-start)

## Support Campaign

You can support ROM's development via our [campaign on Bountysource](https://salt.bountysource.com/teams/rom-rb). Cheers!

## Ecosystem

There are other gems within the rom ecosystem that you will find useful:

* [rom-repository](https://github.com/rom-rb/rom-repository) a higher-level, convenient abstraction with auto-mapping
* (WIP) [rom-migrator](https://github.com/rom-rb/rom-migrator) common APIs for database migrations

## Adapters

* [rom-sql](https://github.com/rom-rb/rom-sql) (supported URI schemes: ado amalgalite cubrid db2 dbi do fdbsql firebird ibmdb informix jdbc mysql mysql2 odbc openbase oracle postgres sqlanywhere sqlite swift tinytds)
* [rom-yesql](https://github.com/rom-rb/rom-yesql)
* [rom-http](https://github.com/rom-rb/rom-http)
* [rom-couchdb](https://github.com/rom-rb/rom-couchdb)
* [rom-csv](https://github.com/rom-rb/rom-csv)
* [rom-yaml](https://github.com/rom-rb/rom-yaml)
* [rom-cassandra](https://github.com/rom-rb/rom-cassandra)
* [rom-event_store](https://github.com/rom-rb/rom-event_store)
* [rom-git](https://github.com/rom-rb/rom-git)
* [rom-influxdb](https://github.com/rom-rb/rom-influxdb)
* [rom-json](https://github.com/rom-rb/rom-json)
* [rom-kafka](https://github.com/rom-rb/rom-kafka)
* [rom-mongo](https://github.com/rom-rb/rom-mongo)
* [rom-neo4j](https://github.com/rom-rb/rom-neo4j)
* [rom-rethinkdb](https://github.com/rom-rb/rom-rethinkdb)

See [issues](https://github.com/rom-rb/rom/issues?q=is%3Aopen+is%3Aissue+label%3Aadapter+label%3Afeature)
for a list of adapters that are planned to be added soon.

## Framework integrations

* [rom-rails](https://github.com/rom-rb/rom-rails)
* [rom-roda](https://github.com/rom-rb/rom-roda)

## Community

* [Official Blog](http://rom-rb.org/blog/)
* [Discussion Forum](http://discuss.rom-rb.org)
* [Gitter Channel](https://gitter.im/rom-rb/chat)

## Credits

This project has a long history and wouldn't exist without following people:

 * [Dan Kubb](https://github.com/dkubb)
 * [Markus Schirp](https://github.com/mbj)
 * [Martin Gamsjaeger](https://github.com/snusnu)

## License

See `LICENSE` file.