{"id":13590731,"url":"https://github.com/WinterYukky/gorm-extra-clause-plugin","last_synced_at":"2025-04-08T14:31:33.428Z","repository":{"id":37981224,"uuid":"386633026","full_name":"WinterYukky/gorm-extra-clause-plugin","owner":"WinterYukky","description":"The clause support plugin for gorm, that not supported by gorm.","archived":false,"fork":false,"pushed_at":"2025-02-16T16:43:30.000Z","size":138,"stargazers_count":52,"open_issues_count":2,"forks_count":11,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-02-16T17:38:38.293Z","etag":null,"topics":["go","gorm","gorm-plugin"],"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/WinterYukky.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}},"created_at":"2021-07-16T12:40:59.000Z","updated_at":"2025-02-16T16:42:51.000Z","dependencies_parsed_at":"2023-12-13T18:25:05.576Z","dependency_job_id":"47743a52-aea0-405b-9671-b2c5a88421a2","html_url":"https://github.com/WinterYukky/gorm-extra-clause-plugin","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WinterYukky%2Fgorm-extra-clause-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WinterYukky%2Fgorm-extra-clause-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WinterYukky%2Fgorm-extra-clause-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WinterYukky%2Fgorm-extra-clause-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/WinterYukky","download_url":"https://codeload.github.com/WinterYukky/gorm-extra-clause-plugin/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247860661,"owners_count":21008329,"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":["go","gorm","gorm-plugin"],"created_at":"2024-08-01T16:00:49.954Z","updated_at":"2025-04-08T14:31:33.095Z","avatar_url":"https://github.com/WinterYukky.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# gorm-extra-clause-plugin\n\nThe clause support plugin for gorm, that not supported by gorm.\n\n[![test status](https://github.com/WinterYukky/gorm-extra-clause-plugin/actions/workflows/go.yml/badge.svg?branch=main \"test status\")](https://github.com/WinterYukky/gorm-extra-clause-plugin/actions)\n[![MIT license](https://img.shields.io/badge/license-MIT-brightgreen.svg)](https://opensource.org/licenses/MIT)\n\n## Support clauses\n\n- [x] WITH (CTE)\n- [x] UNION\n- [x] INTERSECT\n- [x] EXCEPT\n\n## Install\n```shell\ngo get github.com/WinterYukky/gorm-extra-clause-plugin\n```\n\n## Get Started\n\n\u003e [!IMPORTANT]\n\u003e Do not forget the plugin initialisation code `db.Use(extraClausePlugin.New()`.\n\n```go\npackage main\n\nimport (\n  \"gorm.io/gorm\"\n  \"gorm.io/driver/sqlite\"\n  // Add plugin package\n  extraClausePlugin \"github.com/WinterYukky/gorm-extra-clause-plugin\"\n  \"github.com/WinterYukky/gorm-extra-clause-plugin/exclause\"\n)\n\nfunc main() {\n    db, err := gorm.Open(sqlite.Open(\":memory:\"), \u0026gorm.Config{})\n    if err != nil {\n        panic(\"failed to connect database\")\n    }\n    // Insert this line\n    db.Use(extraClausePlugin.New())\n    // Use exclauses\n    db.Clauses(exclause.NewWith(\"cte\", db.Table(\"users\"))).Table(\"cte\").Scan(\u0026users)\n}\n```\n\n\n## Examples\n\n### WITH (CTE)\n\n```go\n// WITH `cte` AS (SELECT * FROM `users`) SELECT * FROM `cte`\ndb.Clauses(exclause.NewWith(\"cte\", \"SELECT * FROM `users`\")).Table(\"cte\").Scan(\u0026users)\n\n// WITH `cte` AS (SELECT * FROM `users` WHERE `name` = 'WinterYukky') SELECT * FROM `cte`\ndb.Clauses(exclause.NewWith(\"cte\", \"SELECT * FROM `users` WHERE `name` = ?\", \"WinterYukky\")).Table(\"cte\").Scan(\u0026users)\n\n// WITH `cte` AS (SELECT * FROM `users` WHERE `name` = 'WinterYukky') SELECT * FROM `cte`\ndb.Clauses(exclause.NewWith(\"cte\", db.Table(\"users\").Where(\"`name` = ?\", \"WinterYukky\"))).Table(\"cte\").Scan(\u0026users)\n\n// WITH `cte` (`id`,`name`) AS (SELECT * FROM `users`) SELECT * FROM `cte`\ndb.Clauses(exclause.With{CTEs: []exclause.CTE{{Name: \"cte\", Columns: []string{\"id\", \"name\"}, Subquery: exclause.Subquery{DB: db.Table(\"users\")}}}}).Table(\"cte\").Scan(\u0026users)\n\n// WITH RECURSIVE `cte` AS (SELECT * FROM `users`) SELECT * FROM `cte`\ndb.Clauses(exclause.With{Recursive: true, CTEs: []exclause.CTE{{Name: \"cte\", Subquery: exclause.Subquery{DB: db.Table(\"users\")}}}}).Table(\"cte\").Scan(\u0026users)\n```\n\n### UNION\n\n```go\n// SELECT * FROM `general_users` UNION SELECT * FROM `admin_users`\ndb.Table(\"general_users\").Clauses(exclause.NewUnion(\"SELECT * FROM `admin_users`\")).Scan(\u0026users)\n\n// SELECT * FROM `general_users` UNION SELECT * FROM `admin_users`\ndb.Table(\"general_users\").Clauses(exclause.NewUnion(db.Table(\"admin_users\"))).Scan(\u0026users)\n\n// SELECT * FROM `general_users` UNION ALL SELECT * FROM `admin_users`\ndb.Table(\"general_users\").Clauses(exclause.NewUnion(\"ALL ?\", db.Table(\"admin_users\"))).Scan(\u0026users)\n```\n\n### INTERSECT\n\n```go\n// SELECT * FROM `general_users` INTERSECT SELECT * FROM `admin_users`\ndb.Table(\"general_users\").Clauses(exclause.NewIntersect(\"SELECT * FROM `admin_users`\")).Scan(\u0026users)\n\n// SELECT * FROM `general_users` INTERSECT SELECT * FROM `admin_users`\ndb.Table(\"general_users\").Clauses(exclause.NewIntersect(db.Table(\"admin_users\"))).Scan(\u0026users)\n\n// SELECT * FROM `general_users` INTERSECT ALL SELECT * FROM `admin_users`\ndb.Table(\"general_users\").Clauses(exclause.NewIntersect(\"ALL ?\", db.Table(\"admin_users\"))).Scan(\u0026users)\n```\n\n### EXCEPT\n\n```go\n// SELECT * FROM `general_users` EXCEPT SELECT * FROM `admin_users`\ndb.Table(\"general_users\").Clauses(exclause.NewExcept(\"SELECT * FROM `admin_users`\")).Scan(\u0026users)\n\n// SELECT * FROM `general_users` EXCEPT SELECT * FROM `admin_users`\ndb.Table(\"general_users\").Clauses(exclause.NewExcept(db.Table(\"admin_users\"))).Scan(\u0026users)\n\n// SELECT * FROM `general_users` EXCEPT ALL SELECT * FROM `admin_users`\ndb.Table(\"general_users\").Clauses(exclause.NewExcept(\"ALL ?\", db.Table(\"admin_users\"))).Scan(\u0026users)\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FWinterYukky%2Fgorm-extra-clause-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FWinterYukky%2Fgorm-extra-clause-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FWinterYukky%2Fgorm-extra-clause-plugin/lists"}