mirror of
https://gitea.com/gitea/tea.git
synced 2026-09-10 07:26:33 -04:00
d1e0849df7
Add a 'tea collaborators' command for managing repository collaborators,
mirroring the conventions of the recently-added 'tea deploy-keys' command:
- list: List all collaborators of a repository
- create: Add a collaborator with specified permission (read/write/admin)
- delete: Remove a collaborator from a repository
- permission: Check a collaborator's current permission level
Running 'tea collaborators <username>' without a subcommand is a shortcut
for 'tea collaborators permission <username>'.
Subcommand naming follows the codebase's create/delete convention; aliases
('add' for create, 'rm'/'remove' for delete) preserve the existing muscle
memory.
The deploy-keys functionality previously bundled here is intentionally
omitted: it is covered by the already-open upstream PR #1067 and would
conflict.
113 lines
3.7 KiB
Go
113 lines
3.7 KiB
Go
// Copyright 2020 The Gitea Authors. All rights reserved.
|
|
// SPDX-License-Identifier: MIT
|
|
|
|
// Tea is command line tool for Gitea.
|
|
package cmd // import "gitea.dev/tea"
|
|
|
|
import (
|
|
"fmt"
|
|
|
|
"github.com/urfave/cli/v3"
|
|
|
|
"gitea.dev/tea/modules/version"
|
|
)
|
|
|
|
// App creates and returns a tea Command with all subcommands set
|
|
// it was separated from main so docs can be generated for it
|
|
func App() *cli.Command {
|
|
// make parsing tea --version easier, by printing /just/ the version string
|
|
cli.VersionPrinter = func(c *cli.Command) { fmt.Fprintln(c.Writer, c.Version) }
|
|
|
|
return &cli.Command{
|
|
Name: "tea",
|
|
Usage: "command line tool to interact with Gitea",
|
|
Description: appDescription,
|
|
CustomHelpTemplate: helpTemplate,
|
|
Version: version.Format(),
|
|
Commands: []*cli.Command{
|
|
&CmdLogin,
|
|
&CmdLogout,
|
|
&CmdWhoami,
|
|
|
|
&CmdIssues,
|
|
&CmdPulls,
|
|
&CmdLabels,
|
|
&CmdMilestones,
|
|
&CmdReleases,
|
|
&CmdTrackedTimes,
|
|
&CmdOrgs,
|
|
&CmdRepos,
|
|
&CmdBranches,
|
|
&CmdActions,
|
|
&CmdWiki,
|
|
&CmdWebhooks,
|
|
&CmdComments,
|
|
&CmdCollaborators,
|
|
|
|
&CmdOpen,
|
|
&CmdNotifications,
|
|
&CmdRepoClone,
|
|
|
|
&CmdSSHKeys,
|
|
|
|
&CmdAdmin,
|
|
|
|
&CmdApi,
|
|
&CmdGenerateManPage,
|
|
},
|
|
EnableShellCompletion: true,
|
|
}
|
|
}
|
|
|
|
var appDescription = `tea is a productivity helper for Gitea. It can be used to manage most entities on
|
|
one or multiple Gitea instances & provides local helpers like 'tea pr checkout'.
|
|
|
|
tea tries to make use of context provided by the repository in $PWD if available.
|
|
tea works best in a upstream/fork workflow, when the local main branch tracks the
|
|
upstream repo. tea assumes that local git state is published on the remote before
|
|
doing operations with tea. Configuration is persisted in $XDG_CONFIG_HOME/tea.
|
|
`
|
|
|
|
var helpTemplate = fmt.Sprintf("\033[1m%s\033[0m", `
|
|
{{.Name}}{{if .Usage}} - {{.Usage}}{{end}}`) + `
|
|
{{if .Version}}{{if not .HideVersion}}version {{.Version}}{{end}}{{end}}
|
|
|
|
USAGE
|
|
{{if .UsageText}}{{.UsageText}}{{else}}{{.HelpName}}{{if .Commands}} command [subcommand] [command options]{{end}} {{if .ArgsUsage}}{{.ArgsUsage}}{{else}}[arguments...]{{end}}{{end}}{{if .Description}}
|
|
|
|
DESCRIPTION
|
|
{{.Description | nindent 3 | trim}}{{end}}{{if .VisibleCommands}}
|
|
|
|
COMMANDS{{range .VisibleCategories}}{{if .Name}}
|
|
{{.Name}}:{{range .VisibleCommands}}
|
|
{{join .Names ", "}}{{"\t"}}{{.Usage}}{{end}}{{else}}{{range .VisibleCommands}}
|
|
{{join .Names ", "}}{{"\t"}}{{.Usage}}{{end}}{{end}}{{end}}{{end}}{{if .VisibleFlags}}
|
|
|
|
OPTIONS
|
|
{{range $index, $option := .VisibleFlags}}{{if $index}}
|
|
{{end}}{{$option}}{{end}}{{end}}
|
|
|
|
EXAMPLES
|
|
tea login add # add a login once to get started
|
|
|
|
tea pulls # list open pulls for the repo in $PWD
|
|
tea pulls --repo $HOME/foo # list open pulls for the repo in $HOME/foo
|
|
tea pulls --remote upstream # list open pulls for the repo pointed at by
|
|
# your local "upstream" git remote
|
|
# list open pulls for any gitea repo at the given login instance
|
|
tea pulls --repo gitea/tea --login gitea.com
|
|
|
|
tea milestone issues 0.7.0 # view open issues for milestone '0.7.0'
|
|
tea issue 189 # view contents of issue 189
|
|
tea open 189 # open web ui for issue 189
|
|
tea open milestones # open web ui for milestones
|
|
|
|
# send gitea desktop notifications every 5 minutes (bash + libnotify)
|
|
while :; do tea notifications --mine -o simple | xargs -i notify-send {}; sleep 300; done
|
|
|
|
ABOUT
|
|
Written & maintained by The Gitea Authors.
|
|
If you find a bug or want to contribute, we'll welcome you at https://gitea.com/gitea/tea.
|
|
More info about Gitea itself on https://about.gitea.com.
|
|
`
|