https://github.com/marcelog/epers

A very simple persistance layer for Erlang applications for different DB's
https://github.com/marcelog/epers

Last synced: 3 months ago
JSON representation

A very simple persistance layer for Erlang applications for different DB's

• Host: GitHub
• URL: https://github.com/marcelog/epers
• Owner: marcelog
• Created: 2012-10-14T21:20:35.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2013-11-12T11:01:20.000Z (about 11 years ago)
• Last Synced: 2023-10-20T21:37:42.121Z (about 1 year ago)
• Language: Erlang
• Size: 229 KB
• Stars: 11
• Watchers: 5
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# WARNING

This repo is **deprecated**. Epers has now grown and is now called **sumo_db**, and can be found at the [Inaka github repository](https://github.com/inaka/sumo_db). This repo is kept for historical reasons.

----

# About

This is a work in progress. There's also [an article](http://marcelog.github.com/articles/erlang_persistence_entities.html) about epers.

**epers** aims to ease db access for erlang applications. It offers a very

simple persistance layer capable of interacting with different db's, while

offering a consistent api to your code.

# Overview

 * epers gives you a standard way to define your db schema, no matter the 

 db implementation (mongo, mysql, redis, etc).

 * Your entities encapsulate behavior in code (functions in module) and state

 into proplists.

 * epers is the main module. It translates to and from #epers_doc into your

 own state.

 * Each repo is a process *epers_repo* that calls the actual db driver

 (e.g: epers_repo_mysql).

 * Some native domain events are supported, that are dispatched through

 a gen_event:notify/2 automatically when an entity is created, updated, deleted.

 Also when a schema is created and when all entities of a given type are

 deleted. Events are described in [this article](http://marcelog.github.com/articles/erlang_epers_persist_entities_domain_events.html)

 

# DB's supported

 * mysql (uses [emysql](https://github.com/Eonblast/Emysql))

 * mongodb (uses [emongo](https://github.com/JacobVorreuter/emongo))

# In progress

 * redis (uses [eredis](https://github.com/wooga/eredis))

 * sqlite3 (uses [erlang-sqlite3](https://github.com/alexeyr/erlang-sqlite3))

# Planned

  * mnesia

  * memory

# Example

See: [**examples/blog**](https://github.com/marcelog/epers/tree/master/examples/blog)

for a full example. To run it, while being in the top level directory:

    make all blog

# TODO

 * Get rid of atoms and use lists.