2020-04-25 12:04:05 +00:00
|
|
|
# <img alt='' src='https://gitea.com/repo-avatars/550-80a3a8c2ab0e2c2d69f296b7f8582485' height="40"/> *T E A*
|
2018-09-03 06:43:00 +00:00
|
|
|
|
2020-04-25 12:04:05 +00:00
|
|
|
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT) [![Release](https://raster.shields.io/badge/dynamic/json.svg?label=release&url=https://gitea.com/api/v1/repos/gitea/tea/releases&query=$[0].tag_name)](https://gitea.com/gitea/tea/releases) [![Build Status](https://drone.gitea.com/api/badges/gitea/tea/status.svg)](https://drone.gitea.com/gitea/tea) [![Join the chat at https://img.shields.io/discord/322538954119184384.svg](https://img.shields.io/discord/322538954119184384.svg)](https://discord.gg/Gitea) [![Go Report Card](https://goreportcard.com/badge/code.gitea.io/tea)](https://goreportcard.com/report/code.gitea.io/tea) [![GoDoc](https://godoc.org/code.gitea.io/tea?status.svg)](https://godoc.org/code.gitea.io/tea)
|
2020-01-03 00:58:45 +00:00
|
|
|
|
2020-04-25 12:04:05 +00:00
|
|
|
## 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](https://code.gitea.io/sdk) and interacts with the Gitea API
|
|
|
|
|
|
|
|
![demo gif](https://dl.gitea.io/screenshots/tea_demo.gif)
|
2018-09-03 06:43:00 +00:00
|
|
|
|
|
|
|
## Installation
|
2019-04-26 11:51:03 +00:00
|
|
|
|
2020-04-25 12:04:05 +00:00
|
|
|
You can use the prebuilt binaries from [dl.gitea.io](https://dl.gitea.io/tea/)
|
2019-04-26 11:51:03 +00:00
|
|
|
|
2020-04-25 12:04:05 +00:00
|
|
|
|
|
|
|
To install from source, go 1.12 or newer is required:
|
2019-04-12 17:44:53 +00:00
|
|
|
```sh
|
2019-04-25 14:16:57 +00:00
|
|
|
go get code.gitea.io/tea
|
2019-04-12 17:44:53 +00:00
|
|
|
go install code.gitea.io/tea
|
2018-09-03 06:43:00 +00:00
|
|
|
```
|
2019-04-12 17:44:53 +00:00
|
|
|
|
2019-04-26 11:51:03 +00:00
|
|
|
|
2020-04-25 12:04:05 +00:00
|
|
|
Or if you have `brew` installed, you can install `tea` via:
|
2019-10-28 19:40:09 +00:00
|
|
|
|
|
|
|
```sh
|
|
|
|
brew tap gitea/tap https://gitea.com/gitea/homebrew-gitea
|
2020-04-25 12:04:05 +00:00
|
|
|
brew install tea
|
2019-10-28 19:40:09 +00:00
|
|
|
```
|
|
|
|
|
2018-09-03 06:43:00 +00:00
|
|
|
## Usage
|
2019-04-26 11:51:03 +00:00
|
|
|
|
2019-04-12 17:44:53 +00:00
|
|
|
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`:
|
2019-04-26 11:51:03 +00:00
|
|
|
|
2019-04-12 17:44:53 +00:00
|
|
|
```sh
|
2018-09-03 06:43:00 +00:00
|
|
|
tea login add --name=try --url=https://try.gitea.io --token=xxxxxx
|
2019-04-12 17:44:53 +00:00
|
|
|
```
|
|
|
|
|
2020-04-25 12:04:05 +00:00
|
|
|
Now you can use the following `tea` subcommands.
|
|
|
|
Detailed usage information is available via `tea <command> --help`.
|
2019-04-26 11:51:03 +00:00
|
|
|
|
2019-04-12 17:44:53 +00:00
|
|
|
```sh
|
2020-04-25 12:04:05 +00:00
|
|
|
login Log in to a Gitea server
|
|
|
|
logout Log out from a Gitea server
|
|
|
|
issues List, create and update issues
|
|
|
|
pulls List, checkout and clean pull requests
|
|
|
|
releases Create 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
|
2018-09-03 06:43:00 +00:00
|
|
|
```
|
|
|
|
|
2019-12-26 03:26:48 +00:00
|
|
|
To fetch issues from different repos, use the `--remote` flag (when inside a gitea repository directory) or `--login` & `--repo` flags.
|
2019-04-12 17:44:53 +00:00
|
|
|
|
2019-04-25 14:16:57 +00:00
|
|
|
## Compilation
|
|
|
|
|
2020-04-25 12:04:05 +00:00
|
|
|
Make sure you have installed a current go version.
|
2019-04-25 14:16:57 +00:00
|
|
|
To compile the sources yourself run the following:
|
2019-04-26 11:51:03 +00:00
|
|
|
|
2019-04-25 14:16:57 +00:00
|
|
|
```sh
|
2020-04-25 12:04:05 +00:00
|
|
|
git clone https://gitea.com/gitea/tea.git
|
|
|
|
cd tea
|
|
|
|
make
|
2019-04-25 14:16:57 +00:00
|
|
|
```
|
|
|
|
|
2018-09-03 06:43:00 +00:00
|
|
|
## Contributing
|
|
|
|
|
|
|
|
Fork -> Patch -> Push -> Pull Request
|
|
|
|
|
2019-12-26 03:26:48 +00:00
|
|
|
- `make test` run testsuite
|
|
|
|
- `make vendor` when adding new dependencies
|
|
|
|
- ... (for other development tasks, check the `Makefile`)
|
|
|
|
|
2018-09-03 06:43:00 +00:00
|
|
|
## Authors
|
|
|
|
|
|
|
|
* [Maintainers](https://github.com/orgs/go-gitea/people)
|
|
|
|
* [Contributors](https://github.com/go-gitea/tea/graphs/contributors)
|
|
|
|
|
|
|
|
## License
|
|
|
|
|
|
|
|
This project is under the MIT License. See the [LICENSE](LICENSE) file for the
|
|
|
|
full license text.
|