diff --git a/README.md b/README.md index b014c01929b0f4cff96b2309f9db1ad96397223b..657a4233d19bd5bdc10a970687842072d1b66717 100644 --- a/README.md +++ b/README.md @@ -1,16 +1,33 @@ # upper.io/db -The `upper.io/db` project is a [Go][2] package with the ability to communicate -with many different kinds of database servers, such as SQLite3, MySQL, -PostgreSQL and MongoDB. +`upper.io/db` is a [Go][2] package that allows developers to store and retrive +data from different kinds of databases through the use of adapters that wrap +well supported database drivers. -See the project page, recipes and user documentation at [upper.io/db][3]. +`upper.io/db` is not an ORM, but you may not need one at all: + +``` + // This code works the same for all supported databases. + var people []Person + res = col.Find(db.Cond{"name": "Max"}).Skip(1).Limit(2).Sort("-input") + err = res.All(&people) +``` + +See the project page, recipes and user documentation at [upper.io/db][1]. [](https://travis-ci.org/upper/db) +## Supported adapters + +* [MongoDB](https://upper.io/db/mongo) via [mgo](http://godoc.org/labix.org/v2/mgo) +* [MySQL](https://upper.io/db/mysql) via [mysql](https://github.com/go-sql-driver/mysql) +* [PostgreSQL](https://upper.io/db/postgresql) via [pq](https://github.com/lib/pq) +* [QL](https://upper.io/db/ql) via [ql](https://github.com/cznic/ql) +* [SQLite3](https://upper.io/db/sqlite) via [go-sqlite3](https://github.com/mattn/go-sqlite3) + ## License -> Copyright (c) 2012-2013 José Carlos Nieto, https://menteslibres.net/xiam +> Copyright (c) 2012-2014 José Carlos Nieto, https://menteslibres.net/xiam > > Permission is hereby granted, free of charge, to any person obtaining > a copy of this software and associated documentation files (the @@ -31,6 +48,5 @@ See the project page, recipes and user documentation at [upper.io/db][3]. > OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION > WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. -[1]: http://upper.io/db +[1]: https://upper.io/db [2]: http://golang.org -[3]: https://upper.io/db