{"id":13757669,"url":"https://github.com/SpectatorNan/gorm-zero","last_synced_at":"2025-05-10T05:32:15.432Z","repository":{"id":40354723,"uuid":"446723226","full_name":"SpectatorNan/gorm-zero","owner":"SpectatorNan","description":"go zero gorm extension / Integrated processing of db model and Redis cache","archived":false,"fork":false,"pushed_at":"2025-04-27T21:26:08.000Z","size":305,"stargazers_count":256,"open_issues_count":1,"forks_count":45,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-04-27T22:25:26.936Z","etag":null,"topics":["cache","database","go-zero","goctl","golang","gorm"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SpectatorNan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-01-11T07:41:41.000Z","updated_at":"2025-04-27T21:26:06.000Z","dependencies_parsed_at":"2023-02-01T05:15:30.470Z","dependency_job_id":"f7f130c0-3a17-41ca-9d25-42c69c89bf29","html_url":"https://github.com/SpectatorNan/gorm-zero","commit_stats":null,"previous_names":[],"tags_count":31,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SpectatorNan%2Fgorm-zero","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SpectatorNan%2Fgorm-zero/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SpectatorNan%2Fgorm-zero/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SpectatorNan%2Fgorm-zero/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SpectatorNan","download_url":"https://codeload.github.com/SpectatorNan/gorm-zero/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253371076,"owners_count":21897998,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cache","database","go-zero","goctl","golang","gorm"],"created_at":"2024-08-03T12:00:44.406Z","updated_at":"2025-05-10T05:32:14.683Z","avatar_url":"https://github.com/SpectatorNan.png","language":"Go","funding_links":[],"categories":["Tools and plugins for [go-zero](https://github.com/tal-tech/go-zero)"],"sub_categories":[],"readme":"# gorm-zero\nA go-zero gorm extension. If you use go-zero, and you want to use GORM. You can use this extension.\n\n\n## Installation\n\n- Add the dependency\n```shell\ngo get github.com/SpectatorNan/gorm-zero\n```\n- Replace `template/model` in your project with `gorm-zero/template/{goctl version}/model`\n- Generate\n```shell\ngoctl model mysql -src={patterns} -dir={dir} -cache --home ./template\n```\n\n## Basic Usage\nCurrently we support two databases: MySQL and PostgreSQL. For example:\n\n### MySQL\n* Config\n```go\nimport (\n    \"github.com/SpectatorNan/gorm-zero/gormc/config/mysql\"\n)\ntype Config struct {\n    Mysql mysql.Mysql\n    ...\n}\n```\n* Initialization\n```go\nimport (\n    \"github.com/SpectatorNan/gorm-zero/gormc/config/mysql\"\n)\nfunc NewServiceContext(c config.Config) *ServiceContext {\n    db, err := mysql.Connect(c.Mysql)\n    if err != nil {\n        log.Fatal(err)\n    }\n    ...\n}\n```\n\n### PostgreSQL\n* Config\n```go\nimport (\n    \"github.com/SpectatorNan/gorm-zero/gormc/config/pg\"\n)\ntype Config struct {\n    PgSql pg.PgSql\n    ...\n}\n```\n\n* Initialization\n```go\nimport (\n    \"github.com/SpectatorNan/gorm-zero/gormc/config/pg\"\n)\nfunc NewServiceContext(c config.Config) *ServiceContext {\n    db, err := pg.Connect(c.PgSql)\n    if err != nil {\n        log.Fatal(err)\n    }\n    ...\n}\n```\n\n## Quick Start\n\n* Query with cache and custom expire duration\n```go\n    gormzeroUsersIdKey := fmt.Sprintf(\"%s%v\", cacheGormzeroUsersIdExpirePrefix, id)\n    var resp Users\n    err := m.QueryWithExpireCtx(ctx, \u0026resp, gormzeroUsersIdKey, expire, func(conn *gorm.DB, v interface{}) error {\n        return conn.Model(\u0026Users{}).Where(\"`id` = ?\", id).First(\u0026resp).Error\n    })\n    switch err {\n        case nil:\n            return \u0026resp, nil\n        case gormc.ErrNotFound:\n            return nil, ErrNotFound\n        default:\n            return nil, err\n    }\n```\n\n* Query with cache and default expire duration\n```go\n    gormzeroUsersIdKey := fmt.Sprintf(\"%s%v\", cacheGormzeroUsersIdPrefix, id)\n    var resp Users\n    err := m.QueryCtx(ctx, \u0026resp, gormzeroUsersIdKey, func(conn *gorm.DB, v interface{}) error {\n        return conn.Model(\u0026Users{}).Where(\"`id` = ?\", id).First(\u0026resp).Error\n    })\n    switch err {\n        case nil:\n            return \u0026resp, nil\n        case gormc.ErrNotFound:\n            return nil, ErrNotFound\n        default:\n            return nil, err\n    }\n```\n\n\n## Examples\n- go zero model example link: [gorm-zero-example](https://github.com/SpectatorNan/gorm-zero-example)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSpectatorNan%2Fgorm-zero","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FSpectatorNan%2Fgorm-zero","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSpectatorNan%2Fgorm-zero/lists"}