README_zh.md

nunu-layout-basic — 基础布局

Nunu是一个基于Golang的应用脚手架，它的名字来自于英雄联盟中的游戏角色，一个骑在雪怪肩膀上的小男孩。和努努一样，该项目也是站在巨人的肩膀上，它是由Golang生态中各种非常流行的库整合而成的，它们的组合可以帮助你快速构建一个高效、可靠的应用程序。

英文介绍

文档

• 使用指南
• 分层架构
• 上手教程

功能

• Gin: https://github.com/gin-gonic/gin
• Gorm: https://github.com/go-gorm/gorm
• Wire: https://github.com/google/wire
• Viper: https://github.com/spf13/viper
• Zap: https://github.com/uber-go/zap
• Golang-jwt: https://github.com/golang-jwt/jwt
• Go-redis: https://github.com/go-redis/redis
• Testify: https://github.com/stretchr/testify
• Sonyflake: https://github.com/sony/sonyflake
• gocron: https://github.com/go-co-op/gocron
• More...

特性

• 超低学习成本和定制：Nunu封装了Gopher最熟悉的一些流行库。您可以轻松定制应用程序以满足特定需求。
• 高性能和可扩展性：Nunu旨在具有高性能和可扩展性。它使用最新的技术和最佳实践，确保您的应用程序可以处理高流量和大量数据。
• 安全可靠：Nunu使用了稳定可靠的第三方库，确保您的应用程序安全可靠。
• 模块化和可扩展：Nunu旨在具有模块化和可扩展性。您可以通过使用第三方库或编写自己的模块轻松添加新功能和功能。
• 文档完善和测试完备：Nunu文档完善，测试完备。它提供了全面的文档和示例，帮助您快速入门。它还包括一套测试套件，确保您的应用程序按预期工作。

Nunu CLI

目录结构

.
├── cmd
│   └── server
│       ├── main.go
│       ├── wire.go
│       └── wire_gen.go
├── config
│   ├── local.yml
│   └── prod.yml
├── internal
│   ├── handler
│   │   ├── handler.go
│   │   └── user.go
│   ├── middleware
│   │   └── cors.go
│   ├── model
│   │   └── user.go
│   ├── repository
│   │   ├── repository.go
│   │   └── user.go
│   ├── server
│   │   └── http.go
│   └── service
│       ├── service.go
│       └── user.go
├── pkg
├── LICENSE
├── README.md
├── README_zh.md
├── go.mod
└── go.sum

这是一个经典的Golang 项目的目录结构，包含以下目录：

• cmd: 存放应用程序的入口点，包括主函数和依赖注入的代码。

  • server: 应用程序的主要入口点，包含主函数和依赖注入的代码。
    • main.go: 主函数，用于启动应用程序。
    • wire.go: 使用Wire库生成的依赖注入代码。
    • wire_gen.go: 使用Wire库生成的依赖注入代码。

• config: 存放应用程序的配置文件。

  • local.yml: 本地环境的配置文件。
  • prod.yml: 生产环境的配置文件。

• internal: 存放应用程序的内部代码。

  • handler: 处理HTTP请求的处理程序。
    • handler.go: 处理HTTP请求的通用处理程序。
    • user.go: 处理用户相关的HTTP请求的处理程序。
  • middleware: 存放中间件代码。
    • cors.go: 跨域资源共享中间件。
  • model: 存放数据模型代码。
    • user.go: 用户数据模型。
  • repository: 存放数据访问代码。
    • repository.go: 数据访问的通用接口。
    • user.go: 用户数据访问接口的实现。
  • server: 存放服务器代码。
    • http.go: HTTP服务器的实现。
  • service: 存放业务逻辑代码。
    • service.go: 业务逻辑的通用接口。
    • user.go: 用户业务逻辑的实现。

• pkg: 存放应用程序的公共包。

• storage: 存放应用程序的存储文件。

• go.mod: Go模块文件。

• go.sum: Go模块的依赖版本文件。

要求

要使用Nunu，您需要在系统上安装以下软件：

• Golang 1.16或更高版本
• Git

安装

您可以通过以下命令安装Nunu：

go install github.com/go-nunu/nunu@latest

创建新项目

您可以使用以下命令创建一个新的Golang项目：

nunu new projectName

默认拉取github源，你也可以使用国内加速仓库

// 使用基础模板
nunu new projectName -r https://gitee.com/go-nunu/nunu-layout-basic.git
// 使用高级模板
nunu new projectName -r https://gitee.com/go-nunu/nunu-layout-advanced.git

此命令将创建一个名为projectName的目录，并在其中生成一个优雅的Golang项目结构。

创建组件

您可以使用以下命令为项目创建handler、service和dao等组件：

nunu create handler user
nunu create service user
nunu create repository user
nunu create model user

或

nunu create all user

这些命令将分别创建一个名为UserHandler、UserService、UserDao和UserModel的组件，并将它们放置在正确的目录中。

启动项目

您可以使用以下命令快速启动项目：

nunu run

此命令将启动您的Golang项目，并支持文件更新热重启。

编译wire.go

您可以使用以下命令快速编译wire.go：

nunu wire

此命令将编译您的wire.go文件，并生成所需的依赖项。

贡献

如果您发现任何问题或有任何改进意见，请随时提出问题或提交拉取请求。我们非常欢迎您的贡献！

许可证

Nunu是根据MIT许可证发布的。有关更多信息，请参见LICENSE文件。