README.md
1# GORM
2
3The fantastic ORM library for Golang, aims to be developer friendly.
4
5[![go report card](https://goreportcard.com/badge/github.com/go-gorm/gorm "go report card")](https://goreportcard.com/report/github.com/go-gorm/gorm)
6[![test status](https://github.com/go-gorm/gorm/workflows/tests/badge.svg?branch=master "test status")](https://github.com/go-gorm/gorm/actions)
7[![Join the chat at https://gitter.im/jinzhu/gorm](https://img.shields.io/gitter/room/jinzhu/gorm.svg)](https://gitter.im/jinzhu/gorm?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
8[![Open Collective Backer](https://opencollective.com/gorm/tiers/backer/badge.svg?label=backer&color=brightgreen "Open Collective Backer")](https://opencollective.com/gorm)
9[![Open Collective Sponsor](https://opencollective.com/gorm/tiers/sponsor/badge.svg?label=sponsor&color=brightgreen "Open Collective Sponsor")](https://opencollective.com/gorm)
10[![MIT license](https://img.shields.io/badge/license-MIT-brightgreen.svg)](https://opensource.org/licenses/MIT)
11[![Go.Dev reference](https://img.shields.io/badge/go.dev-reference-blue?logo=go&logoColor=white)](https://pkg.go.dev/gorm.io/gorm?tab=doc)
12
13## Overview
14
15* Full-Featured ORM
16* Associations (Has One, Has Many, Belongs To, Many To Many, Polymorphism, Single-table inheritance)
17* Hooks (Before/After Create/Save/Update/Delete/Find)
18* Eager loading with `Preload`, `Joins`
19* Transactions, Nested Transactions, Save Point, RollbackTo to Saved Point
20* Context, Prepared Statement Mode, DryRun Mode
21* Batch Insert, FindInBatches, Find To Map
22* SQL Builder, Upsert, Locking, Optimizer/Index/Comment Hints, NamedArg, Search/Update/Create with SQL Expr
23* Composite Primary Key
24* Auto Migrations
25* Logger
26* Extendable, flexible plugin API: Database Resolver (Multiple Databases, Read/Write Splitting) / Prometheus…
27* Every feature comes with tests
28* Developer Friendly
29
30## Getting Started
31
32* GORM Guides [https://gorm.io](https://gorm.io)
33
34## Contributing
35
36[You can help to deliver a better GORM, check out things you can do](https://gorm.io/contribute.html)
37
38## License
39
40© Jinzhu, 2013~time.Now
41
42Released under the [MIT License](https://github.com/go-gorm/gorm/blob/master/License)
43