forgejo-cli/README.md

87 lines
2.1 KiB
Markdown
Raw Normal View History

2023-11-18 00:04:02 +01:00
# forgejo-cli
CLI tool for interacting with Forgejo
2024-08-08 02:05:38 +02:00
[Matrix Chat](https://matrix.to/#/#forgejo-cli:cartoon-aa.xyz)
2024-04-18 20:11:31 +02:00
## Installation
### Pre-built
2024-04-18 20:42:37 +02:00
Pre-built binaries are available for `x86_64` Windows and Linux (GNU) on the
2024-04-18 20:11:31 +02:00
[releases tab](https://codeberg.org/Cyborus/forgejo-cli/releases/latest).
### From source
Install with `cargo install`
```
# Latest version
2024-04-18 20:53:18 +02:00
cargo install --git https://codeberg.org/Cyborus/forgejo-cli.git --tag v0.0.4
2024-04-18 20:11:31 +02:00
# From `main`
cargo install --git https://codeberg.org/Cyborus/forgejo-cli.git --branch main
```
### OCI Container
`forgejo-cli` is available as an OCI container for use in CI, at
`codeberg.org/cyborus/forgejo-cli:latest`
## Usage
### Instance-specific aliases
While you can just use the `fj` binary directly, it can be useful to alias it
with the `--host` flag set, to create shorthands for certain instances.
```bash
# For example, a `cb` command for interacting with codeberg
alias cb="fj --host codeberg.org"
# Or disroot
alias dr="fj --host git.disroot.org"
# Or any other instance you want!
# And the alias name can be whatever, as long as the `--host` flag is set.
```
Now, when you reference a repository such as `forgejo/forgejo`, it will
implicitly get it from whichever alias you used!
```
$ cb repo info forgejo/forgejo
forgejo/forgejo
> Beyond coding. We forge.
Primary language is Go
# etc...
```
When using `fj` directly, you'd have to use a URL to access it.
```
$ fj repo info codeberg.org/forgejo/forgejo
forgejo/forgejo
> Beyond coding. We forge.
Primary language is Go
# etc...
# Notice the "dr", trying to access Disroot, still works when you specify Codeberg in the repository name!
$ dr repo info codeberg.org/forgejo/forgejo
forgejo/forgejo
> Beyond coding. We forge.
Primary language is Go
# etc...
```
## Licensing
2023-11-18 00:04:02 +01:00
This project is licensed under either
[Apache License Version 2.0](LICENSE-APACHE) or [MIT License](LICENSE-MIT)
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be
dual licensed as above, without any additional terms or conditions.