代码拉取完成,页面将自动刷新
同步操作将从 caixw/apidoc 强制同步,此操作会覆盖自 Fork 仓库以来所做的任何修改,且无法恢复!!!
确定后同步将在后台操作,完成时将刷新页面,请耐心等待。
// Copyright 2015 by caixw, All rights reserved.
// Use of this source code is governed by a MIT
// license that can be found in the LICENSE file.
package main
import (
"encoding/json"
"io"
"io/ioutil"
"strconv"
"github.com/caixw/apidoc/app"
"github.com/caixw/apidoc/input"
"github.com/caixw/apidoc/locale"
"github.com/caixw/apidoc/output"
"github.com/issue9/term/colors"
"github.com/issue9/version"
)
// 带色彩输出的控制台。
type logWriter struct {
out io.Writer
color colors.Color
prefix string
}
// 项目的配置内容,分别引用到了 input.Options 和 output.Options。
//
// 所有可能改变输出的表现形式的,应该添加此配置中;
// 而如果只是改变输出内容的,应该直接以标签的形式出现在代码中,
// 比如文档的版本号、标题等,都是直接使用 `@apidoc` 来指定的。
type config struct {
Version string `json:"version"` // 产生此配置文件的程序版本号
Inputs []*input.Options `json:"inputs"`
Output *output.Options `json:"output"`
}
func (w *logWriter) Write(bs []byte) (int, error) {
colors.Fprint(w.out, w.color, colors.Default, w.prefix)
return colors.Fprint(w.out, colors.Default, colors.Default, string(bs))
}
// 加载 path 所指的文件内容到 *config 实例。
func loadConfig(path string) (*config, error) {
data, err := ioutil.ReadFile(path)
if err != nil {
return nil, err
}
cfg := &config{}
if err = json.Unmarshal(data, cfg); err != nil {
return nil, err
}
// NOTE: 这里的 err 类型是 *app.OptionsError 而不是 error 所以需要新值
if err := cfg.init(); err != nil {
return nil, err
}
return cfg, nil
}
func (cfg *config) init() *app.OptionsError {
if !version.SemVerValid(cfg.Version) {
return &app.OptionsError{Field: "version", Message: locale.Sprintf(locale.ErrInvalidFormat)}
}
if len(cfg.Inputs) == 0 {
return &app.OptionsError{Field: "inputs", Message: locale.Sprintf(locale.ErrRequired)}
}
if cfg.Output == nil {
return &app.OptionsError{Field: "output", Message: locale.Sprintf(locale.ErrRequired)}
}
for i, opt := range cfg.Inputs {
if err := opt.Init(); err != nil {
index := strconv.Itoa(i)
err.Field = "inputs[" + index + "]." + err.Field
return err
}
opt.SyntaxLog = erro // 语法错误输出到 erro 中
}
if err := cfg.Output.Init(); err != nil {
err.Field = "outputs." + err.Field
return err
}
return nil
}
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。