https://github.com/chenmingyong0423/go-mongox

A Go Mongo library based on the official MongoDB driver, featuring streamlined document operations, generic binding of structs to collections, built-in BSON doc builder, automated field updates, struct validation, hooks, and plugin-based programming.
https://github.com/chenmingyong0423/go-mongox

builder database go golang mongo mongodb

Last synced: about 4 hours ago
JSON representation

A Go Mongo library based on the official MongoDB driver, featuring streamlined document operations, generic binding of structs to collections, built-in BSON doc builder, automated field updates, struct validation, hooks, and plugin-based programming.

• Host: GitHub
• URL: https://github.com/chenmingyong0423/go-mongox
• Owner: chenmingyong0423
• License: apache-2.0
• Created: 2023-07-19T12:18:05.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-12-17T17:25:39.000Z (12 days ago)
• Last Synced: 2024-12-22T05:09:30.224Z (7 days ago)
• Topics: builder, database, go, golang, mongo, mongodb
• Language: Go
• Homepage: https://go-mongox.dev
• Size: 635 KB
• Stars: 156
• Watchers: 2
• Forks: 7
• Open Issues: 4
• Metadata Files:
  • Readme: README-zh_CN.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-go - go-mongox - A Go Mongo library based on the official driver, featuring streamlined document operations, generic binding of structs to collections, built-in CRUD, aggregation, automated field updates, struct validation, hooks, and plugin-based programming. (Database Drivers / NoSQL Database Drivers)

README

        


  



[![GitHub Repo stars](https://img.shields.io/github/stars/chenmingyong0423/go-mongox)](https://github.com/chenmingyong0423/go-mongox/stargazers)

[![GitHub issues](https://img.shields.io/github/issues/chenmingyong0423/go-mongox)](https://github.com/chenmingyong0423/go-mongox/issues)

[![GitHub License](https://img.shields.io/github/license/chenmingyong0423/go-mongox)](https://github.com/chenmingyong0423/go-mongox/blob/main/LICENSE)

[![GitHub release (with filter)](https://img.shields.io/github/v/release/chenmingyong0423/go-mongox)](https://github.com/chenmingyong0423/go-mongox)

[![codecov](https://codecov.io/gh/chenmingyong0423/go-mongox/graph/badge.svg?token=H3CROTTDZ1)](https://codecov.io/gh/chenmingyong0423/go-mongox)

[![Go Report Card](https://goreportcard.com/badge/github.com/chenmingyong0423/go-mongox)](https://goreportcard.com/report/github.com/chenmingyong0423/go-mongox)

[![go.dev reference](https://img.shields.io/badge/go.dev-reference-007d9c?logo=go&logoColor=white&style=flat-square)](https://pkg.go.dev/github.com/chenmingyong0423/go-mongox)

[![All Contributors](https://img.shields.io/badge/all_contributors-1-orange.svg?style=flat-square)](#contributors-)

[English](./README.md) | 中文简体

# go mongox

`go mongox` 是一个基于官方驱动程序的`Go Mongo` 的泛型库，扩展了 `MongoDB` 的官方框架。通过泛型技术，它实现了结构体与 `MongoDB` 集合的绑定，旨在提供类型安全和简化的数据操作。`go mongox` 还引入链式调用，让文档操作更流畅，并且提供了丰富的 `BSON` 构造器和内置函数，简化了 `BSON` 数据的构建。此外，它还支持插件化编程和内置多种钩子函数，为数据库操作前后的自定义逻辑提供灵活性，增强了应用的可扩展性和可维护性。

# 功能特性

- 泛型的 `MongoDB` 集合

- 支持 `BSON` 数据的构建

- 文档的 `CRUD` 操作

- 聚合操作

- 内置基本的 `Model` 结构体，自动化更新默认的 `field` 字段

- 支持结构体 `tag` 校验

- `Hooks`

- 支持插件化编程

# 安装

- 如果使用 `mongo-driver 1.x` 版本：

    ```go

    go get github.com/chenmingyong0423/go-mongox

    ```

- 如果使用 `mongo-driver 2.x` 版本：

    ```go

    go get github.com/chenmingyong0423/go-mongox/v2

    ```

# 快速开始

- `go mongox` 指南： [https://go-mongox.dev](https://go-mongox.dev)

# 贡献

[如果有您的加入，go-mongox 将会变得更加强大！](https://go-mongox.dev/contribute.html)

# 贡献者

非常感谢 [您们](https://github.com/chenmingyong0423/go-mongox/graphs/contributors) 为 `go mongox` 框架做出的贡献！

# 版权

© [陈明勇](https://github.com/chenmingyong0423)，2024-至今

这个项目遵循 [Apache License](https://github.com/chenmingyong0423/go-mongox/blob/main/LICENSE) 许可。