mirror of https://gitea.com/gitea/tea.git synced 2024-12-22 09:05:06 +01:00

A command line tool to interact with Gitea servers

Go to file

Norwin de5a00e807 Refactor addLoginMain() (#201 ) simplify NormalizeURL drop noisy log line must have been introduced recently? dont use PascalCase for default login names ...for readability. 🔥 opinionated commit create GenerateLoginName() fixes fixup! Merge branch 'master' into refactor-loginMain move GetOwnerAndRepo() to modules/utils/parse.go Merge branch 'master' into refactor-loginMain make linter happy refactor addLoginMain() Co-authored-by: Norwin Roosen <git@nroo.de> Reviewed-on: https://gitea.com/gitea/tea/pulls/201 Reviewed-by: 6543 <6543@noreply.gitea.io> Reviewed-by: Andrew Thornton <art27@cantab.net>		2020-09-30 19:44:22 +00:00
cmd	Refactor addLoginMain() (#201 )	2020-09-30 19:44:22 +00:00
modules	Refactor addLoginMain() (#201 )	2020-09-30 19:44:22 +00:00
vendor	Use glamour and termev to render/colorize content (#181 )	2020-09-19 16:00:50 +00:00
.changelog.yml	Add missing Changelog for 0.1.x releases (#91 )	2020-01-31 02:24:57 +00:00
.drone.yml	Update Golang (#185 )	2020-09-19 15:29:15 +00:00
.gitignore	Add gitea-vet (#121 )	2020-04-28 13:02:21 +00:00
.revive.toml	Add Makefile / .drone.yml, use go module with vendor (#20 )	2019-04-25 20:06:53 +03:00
build.go	Update gitea-vet v0.2.0 (#164 )	2020-07-21 16:17:52 +00:00
CHANGELOG.md	Changelog v0.5.0 (#205 )	2020-09-27 14:35:53 +00:00
CONTRIBUTING.md	init project	2018-09-03 14:43:00 +08:00
DCO	init project	2018-09-03 14:43:00 +08:00
go.mod	Use glamour and termev to render/colorize content (#181 )	2020-09-19 16:00:50 +00:00
go.sum	Use glamour and termev to render/colorize content (#181 )	2020-09-19 16:00:50 +00:00
LICENSE	init project	2018-09-03 14:43:00 +08:00
main.go	Add milestones subcomand (#149 )	2020-09-17 19:35:24 +00:00
Makefile	Update gitea-vet v0.2.0 (#164 )	2020-07-21 16:17:52 +00:00
README.md	Changelog v0.5.0 (#205 )	2020-09-27 14:35:53 +00:00

README.md

T E A

The official CLI interface for gitea

Tea is a command line tool for interacting on one or more Gitea instances. It uses code.gitea.io/sdk and interacts with the Gitea API

Installation

You can use the prebuilt binaries from dl.gitea.io

To install from source, go 1.13 or newer is required:

go get code.gitea.io/tea
go install code.gitea.io/tea

If you have brew installed, you can install tea via:

brew tap gitea/tap https://gitea.com/gitea/homebrew-gitea
brew install tea

Distribution packages exist for: alpinelinux (tea) and archlinux (gitea-tea)

Usage

First of all, you have to create a token on your personal settings -> application page of your gitea instance. Use this token to login with tea:

tea login add --name=try --url=https://try.gitea.io --token=xxxxxx

Now you can use the following tea subcommands. Detailed usage information is available via tea <command> --help.

login            Log in to a Gitea server
logout           Log out from a Gitea server
issues           List, create and update issues
pulls            List, create, checkout and clean pull requests
releases         List, create, update and delete releases
repos            Operate with repositories
labels           Manage issue labels
times            Operate on tracked times of a repositorys issues and pulls
open             Open something of the repository on web browser
notifications    Show notifications
milestones       List and create milestones

To fetch issues from different repos, use the --remote flag (when inside a gitea repository directory) or --login & --repo flags.

Compilation

Make sure you have installed a current go version. To compile the sources yourself run the following:

git clone https://gitea.com/gitea/tea.git
cd tea
make

Contributing

Fork -> Patch -> Push -> Pull Request

make test run testsuite
make vendor when adding new dependencies
... (for other development tasks, check the Makefile)

Authors

License

This project is under the MIT License. See the LICENSE file for the full license text.