server

command module
v0.21.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 14, 2022 License: AGPL-3.0, AGPL-3.0-only Imports: 30 Imported by: 0

README

https://bgm.tv/ 新后端服务器。

GitHub go.mod Go version Codecov

Requirements

Optional Requirements:

  • nodejs: 用于生成 openapi 文件。

Init

git clone --recursive https://github.com/bangumi/server.git bangumi-server
cd bangumi-server
task

设置

可设置的环境变量

  • MYSQL_HOST 默认 127.0.0.1
  • MYSQL_PORT 默认 3306
  • MYSQL_DB 默认 bangumi
  • MYSQL_USER 默认 user
  • MYSQL_PASS 默认 password
  • REDIS_URI 默认 redis://127.0.0.1:6379/0
  • HTTP_PORT 默认 3000

你也可以把配置放在 .env 文件中,go-task 会自动加载 .env 文件中的环境变量。

example:

MYSQL_HOST="127.0.0.1"
MYSQL_PORT="3306"
MYSQL_USER="user"
MYSQL_PASS="password"
MYSQL_DB="bangumi"
REDIS_URI="redis://:redis-pass@127.0.0.1:6379/1"

开发

bangumi 相关项目整体说明 bangumi/dev-docs

Web 框架: fiber

ORM: GORMGORM Gen

后端环境

redis 和 mysql 都在此 docker-compose 内 https://github.com/bangumi/dev-env

如果你不使用 docker ,请自行启动 mysql 和 redis 并导入 bangumi/dev-env 仓库内的数据。

贡献指南

更多的细节介绍请查看贡献指南

提交 Pull Request

如果你的 PR 是新功能,最好先发个 issue 讨论一下要不要实现,避免 PR 提交之后新功能本身被否决的问题。

如果已经存在相关的 issue,可以先在 issue 内回复一下自己的意向,或者创建一个 Draft PR 关联对应的 issue,避免撞车问题。

测试

使用 mock 进行部分测试。

task test

运行 hCaptcha 以外的的全部测试,需要数据库环境。

task test-all

使用 task test-all-with-http 或者 task coverage 来运行所有测试。

代码风格

task lint

配置文件

非 golang 文件 (yaml, json, markdown 等) 使用 prettier 进行格式化。 如果你没有 nodejs 环境,也可以直接提交 PR。GitHub Actions 会对文件进行检查并提出修改建议。

Go Mod

你不应当导入 github.com/bangumi/server/pkg 以外的任何路径。

具体可用的包见 pkg/readme.md

License

Copyright (C) 2021-2022 bangumi server contributors.

Source is licensed under the GNU AGPLv3 license that can be found in the LICENSE.txt file.

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
internal
cmd/gen/gorm
nolint
nolint
cmd/gen/openapi
作为生成 openapi component 的脚本文件示例。
作为生成 openapi component 的脚本文件示例。
dal
pkg/logger
Package logger config a zap logger, functions have same signature with `zap.logger`.
Package logger config a zap logger, functions have same signature with `zap.logger`.
pkg/strutil
Package strutil provide some functions to manipulation string.
Package strutil provide some functions to manipulation string.
web
pkg
vars
Package vars provide some pre-defined variable from old codebase.
Package vars provide some pre-defined variable from old codebase.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL