2018-09-03 12:13:00 +05:30
# Gitea Command Line Tool for Go
This project acts as a command line tool for operating one or multiple Gitea instances. It depends on [code.gitea.io/sdk ](https://code.gitea.io/sdk ) client SDK implementation written in Go to interact with
the Gitea API implementation.
## Installation
2019-04-26 17:21:03 +05:30
2019-04-12 23:14:53 +05:30
Currently no prebuilt binaries are provided.
To install, a Go installation is needed.
2019-04-26 17:21:03 +05:30
2019-04-12 23:14:53 +05:30
```sh
2019-04-25 19:46:57 +05:30
go get code.gitea.io/tea
2019-04-12 23:14:53 +05:30
go install code.gitea.io/tea
2018-09-03 12:13:00 +05:30
```
2019-04-12 23:14:53 +05:30
If the `tea` executable is not found, you might need to set up your `$GOPATH` and `$PATH` variables first:
2019-04-26 17:21:03 +05:30
2019-04-12 23:14:53 +05:30
```sh
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin
2018-09-03 12:13:00 +05:30
```
2019-10-29 01:10:09 +05:30
If you have `brew` installed, you can install tea version via:
```sh
brew tap gitea/tap https://gitea.com/gitea/homebrew-gitea
brew install --devel tea
```
2018-09-03 12:13:00 +05:30
## Usage
2019-04-26 17:21:03 +05:30
2019-04-12 23:14:53 +05:30
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 17:21:03 +05:30
2019-04-12 23:14:53 +05:30
```sh
2018-09-03 12:13:00 +05:30
tea login add --name=try --url=https://try.gitea.io --token=xxxxxx
2019-04-12 23:14:53 +05:30
```
Now you can use the `tea` commands:
2019-04-26 17:21:03 +05:30
2019-04-12 23:14:53 +05:30
```sh
2018-09-03 12:13:00 +05:30
tea issues
2018-10-22 00:22:57 +05:30
tea releases
2018-09-03 12:13:00 +05:30
```
2019-12-26 08:56:48 +05:30
To fetch issues from different repos, use the `--remote` flag (when inside a gitea repository directory) or `--login` & `--repo` flags.
2019-04-12 23:14:53 +05:30
2019-04-25 19:46:57 +05:30
## Compilation
To compile the sources yourself run the following:
2019-04-26 17:21:03 +05:30
2019-04-25 19:46:57 +05:30
```sh
go get code.gitea.io/tea
cd "${GOPATH}/src/code.gitea.io/tea"
go build
```
2018-09-03 12:13:00 +05:30
## Contributing
Fork -> Patch -> Push -> Pull Request
2019-12-26 08:56:48 +05:30
- `make test` run testsuite
- `make vendor` when adding new dependencies
- ... (for other development tasks, check the `Makefile` )
2018-09-03 12:13:00 +05:30
## 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.