mirror of
https://gitea.com/gitea/tea.git
synced 2026-10-26 19:11:25 +01:00
bircni
c5f674111a
Reverts #1126, #1125, #1124, #1123 and #1122. `go.mod` keeps the Go 1.26 line with toolchain `go1.26.9` (instead of the original `go1.26.6`) so the security fix from #1131 isn't lost. reopens #69 reopens #141 reopens #162 reopens #172 reopens #197 reopens #232 reopens #240 reopens #246 reopens #323 reopens #325 reopens #326 reopens #328 reopens #344 reopens #351 reopens #373 reopens #403 reopens #406 reopens #417 reopens #430 reopens #457 reopens #480 reopens #482 reopens #489 reopens #490 reopens #498 reopens #500 reopens #504 reopens #510 reopens #516 reopens #523 reopens #556 reopens #560 reopens #569 reopens #571 reopens #602 reopens #632 reopens #633 reopens #643 reopens #666 reopens #670 reopens #672 reopens #677 reopens #683 reopens #697 reopens #726 reopens #737 reopens #770 reopens #779 reopens #804 reopens #817 reopens #831 reopens #833 reopens #834 reopens #908 reopens #966 reopens #1023 reopens #1029 reopens #1032 reopens #1050 reopens #1052 reopens #1069 reopens #1073 reopens #1087 reopens #1091 reopens #1094 reopens #1110 reopens #1115 reopens #1116 reopens #1118 Reviewed-on: https://gitea.com/gitea/tea/pulls/1146 Reviewed-by: TheFox0x7 <95654+thefox0x7@noreply.gitea.com>
65 lines
1.4 KiB
Go
65 lines
1.4 KiB
Go
// Copyright 2025 The Gitea Authors. All rights reserved.
|
|
// SPDX-License-Identifier: MIT
|
|
|
|
package cmd
|
|
|
|
import (
|
|
"context"
|
|
"fmt"
|
|
"os"
|
|
"path/filepath"
|
|
|
|
docs "github.com/urfave/cli-docs/v3"
|
|
"github.com/urfave/cli/v3"
|
|
)
|
|
|
|
// DocRenderFlags are the flags for documentation generation, used by `./docs/docs.go` and the `generate-man-page` sub command
|
|
var DocRenderFlags = []cli.Flag{
|
|
&cli.StringFlag{
|
|
Name: "out",
|
|
Usage: "Path to output docs to, otherwise prints to stdout",
|
|
Aliases: []string{"o"},
|
|
},
|
|
}
|
|
|
|
// CmdGenerateManPage is the sub command to generate the `tea` man page
|
|
var CmdGenerateManPage = cli.Command{
|
|
Name: "man",
|
|
Usage: "Generate man page",
|
|
Hidden: true,
|
|
Flags: DocRenderFlags,
|
|
Action: func(ctx context.Context, cmd *cli.Command) error {
|
|
return RenderDocs(cmd, cmd.Root(), func(cmd *cli.Command) (string, error) {
|
|
return docs.ToManWithSection(cmd, 1)
|
|
})
|
|
},
|
|
}
|
|
|
|
// RenderDocs renders the documentation for `target` using the supplied `render` function
|
|
func RenderDocs(cmd, target *cli.Command, render func(*cli.Command) (string, error)) error {
|
|
out, err := render(target)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
outPath := cmd.String("out")
|
|
if outPath == "" {
|
|
fmt.Print(out)
|
|
return nil
|
|
}
|
|
|
|
if err = os.MkdirAll(filepath.Dir(outPath), os.ModePerm); err != nil {
|
|
return err
|
|
}
|
|
|
|
fi, err := os.Create(outPath)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
defer fi.Close()
|
|
if _, err = fi.WriteString(out); err != nil {
|
|
return err
|
|
}
|
|
|
|
return nil
|
|
}
|