Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/feraxhp/grp
girep is a command line tool that helps you manage your git repositories in the cloud, for difrent platforms. It is written in Rust, and it is inspired by gcli. This repository was created with itself, how exiting! (git cli) (GitHub cli) (gitea cli) (command tool) (for windows) (for linux)
https://github.com/feraxhp/grp
cli-app command-line debian fedora gitea github rust windows
Last synced: 24 days ago
JSON representation
girep is a command line tool that helps you manage your git repositories in the cloud, for difrent platforms. It is written in Rust, and it is inspired by gcli. This repository was created with itself, how exiting! (git cli) (GitHub cli) (gitea cli) (command tool) (for windows) (for linux)
- Host: GitHub
- URL: https://github.com/feraxhp/grp
- Owner: feraxhp
- License: mit
- Created: 2024-09-10T14:18:44.000Z (4 months ago)
- Default Branch: master
- Last Pushed: 2024-12-05T20:11:49.000Z (26 days ago)
- Last Synced: 2024-12-05T20:27:28.964Z (26 days ago)
- Topics: cli-app, command-line, debian, fedora, gitea, github, rust, windows
- Language: Rust
- Homepage:
- Size: 147 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
Awesome Lists containing this project
- awesome-gitea - grp - A cli tool to interact with github, gitea and local repositories written in rust. (Applications / Command Line)
README
# grp (git repository)
girep is a command line tool that helps you manage your git repositories in the cloud, for difrent platforms.
It is written in Rust, and it is inspired by [gcli](https://github.com/herrhotzenplotz/gcli).
## Features
- New: 🎉
- Supported: ✅
- Planed support: 🟥
- On development: 🔶
### Repositories
| Feature | GitHub | Gitea | GitLab | Jetbrains Space |
|:-------:|:------:|:-----:|:------:|:---------------:|
| List | ✅ | ✅ | 🟥 | 🟥 |
| Create | ✅ | ✅ | 🟥 | 🟥 |
| Delete | ✅ | ✅ | 🟥 | 🟥 |
| Clone | ✅ | ✅ | 🟥 | 🟥 |
| Push | 🎉 | 🎉 | 🟥 | 🟥 |
| Pull | 🔶 | 🔶 | 🟥 | 🟥 |
### Organizations
| Feature | GitHub | Gitea | GitLab | Jetbrains Space |
|:-------:|:------:|:-----:|:------:|:---------------:|
| List | ✅ | ✅ | 🟥 | 🟥 |
| Create | ✅ | ✅ | 🟥 | 🟥 |
| Delete | ✅ | ✅ | 🟥 | 🟥 |
---
## Configuration
The grp configurations are store in json. the first time you run
grp, it will create the configurations file with the base config.
if you prefer a gide configuration use: `grp config add`
the location of the config folder depends on the platform
- linux: `$HOME/.config/girep/config.json`
- windows `%appdata%/girep/config.json`
- mac: `$HOME/Library/Application Support/girep/config.json`
the basic structure looks like this:
```json
{
"default": "",
"pconf": []
}
```
grp manage the platforms in objets called pcofs. in every pconf you have to add
- **name**: Is the name for the pconf, it is used to determine the platform.
- **owner**: Is the username that will use by default to request in the platform.
- **token**: Is a user generated token used to authenticate the request.
- **type**: type of the platform. currently allows `github`, `gitea`.
- **endpoint**: the endpoint to make the request
- examples:
- `"api.github.com"`: for GitHub.
- `"gitea.com"`: for Gitea.
- `"tea.example.com"`: for Gitea on custom host.
- `localhost:3244`: for gitea on localhost.
here is an example for a complete config file:
```json
{
"default": "gh",
"pconf": [
{
"name": "gh",
"owner": "feraxhp",
"token": "",
"type": "github",
"endpoint": "api.github.com"
},
{
"name": "tea",
"owner": "feraxhp",
"token": "",
"type": "gitea",
"endpoint": "tea.example.com"
}
]
}
```
---
## Installation
- Windows: Download the latest .exe from the releases page. and add it to your PATH.
- Ubuntu: See releases page for the latest deb package.
```bash
wget -O paquete.deb
dpkg sudo dpkg -i paquete.deb
sudo apt-get install -f
```
- fedora: See releases page for the latest rpm package.
```bash
sudo dnf install
```
- Arch Linux: See build instructions below.
- Other Linux distributions: See build instructions below.
- MacOS: See build instructions below.
---
## Build and Run
### Dependencies
Make sure you have the following dependencies installed on your system:
- #### [dependencies](dependencies.md)
- Cargo (Rust)
### Build
```bash
# clone the repository
git clone https://github.com/feraxhp/grp.git
cd grp
# if you want to install it on your system
cargo install --path .
```
---
## Need more Functionality?
If you need more functionality, feel free to open an issue or a pull request.
remember to follow the [contribution guidelines](CONTRIBUTING.md)