Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yoyo-project/yoyo
A Database Access Layer Generator for Go
https://github.com/yoyo-project/yoyo
code-generation database-access database-connector database-design database-migrations database-schema generator go golang mysql mysql-database postgres postgresql repository-pattern
Last synced: 4 months ago
JSON representation
A Database Access Layer Generator for Go
- Host: GitHub
- URL: https://github.com/yoyo-project/yoyo
- Owner: yoyo-project
- License: mit
- Created: 2021-01-24T15:21:01.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2023-07-25T17:49:30.000Z (over 1 year ago)
- Last Synced: 2024-09-28T15:41:52.706Z (4 months ago)
- Topics: code-generation, database-access, database-connector, database-design, database-migrations, database-schema, generator, go, golang, mysql, mysql-database, postgres, postgresql, repository-pattern
- Language: Go
- Homepage:
- Size: 241 KB
- Stars: 2
- Watchers: 2
- Forks: 1
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# yoyo
[](https://opensource.org/licenses/MIT)
[](https://goreportcard.com/report/github.com/yoyo-project/yoyo)
[](https://codeclimate.com/github/yoyo-project/yoyo/maintainability)
[](https://codecov.io/gh/yoyo-project/yoyo)
[](https://circleci.com/gh/yoyo-project/yoyo/tree/main)
A Migration Generator and Database Access Layer Generator for Go projects. Made with ❤️ to hopefully make your life a
little bit easier.
Your Database access layer generated by `yoyo`...
- provides a native, fluent query generator
- is totally pure Go
- is totally reflection-free
## A Note on Using Databases in Code
Okay, accessing databases in code is annoying. Relational data is annoying. It doesn't matter which language you're using.
It doesn't matter if you're using PostgreSQL, MySQL, or Clickhouse, there's an innate complexity in relational data that
is simply not native to Go or most other general purpose programming languages. That's why many of us turn to tools like
ORMs, choosing to accept the cons of ORM magic because of the pros of having something else do the translation.
While yoyo is not an ORM, it is meant to address the same problem in a different way. By generating a database access
layer with entities for your project, tailor-made to your schema and without any reflection in sight.
## What does yoyo do?
yoyo is a code-generation tool which really does two things:
- Help manage your schema by generating migrations.
- Help you work with your schema by generating database access layer code in your project.
## Usage
### `yoyo generate`
[](https://masterminds.github.io/stability/experimental.html)
yoyo's main function is generating database access code.
### `yoyo reverse`
[](https://masterminds.github.io/stability/experimental.html)
Read an existing database and attempt to translate it to a schema in `yoyo.yml`
### `yoyo generate migration`
[](https://masterminds.github.io/stability/experimental.html)
## Configuration
Configuration for yoyo is kept in your project's `yoyo.yml` file.
## Managing Database Connections
When running or generating migrations, Yoyo's connection to your database is environment-driven
and managed internally.
When running as a part of your app, Yoyo cedes control for your flexibility. Therefore, it needs
to be handed a connection in the form of a `*sql.DB`.
## What Yoyo can't do
- Anything that crosses into another database. Yoyo is a single-database (single-schema) tool, so something like a MySQL
Foreign Key that references a table in a different schema won't work in Yoyo.