Installing the `grp` executable

Assuming you have Rust/Cargo installed, run this command in a terminal:

cargo install girep

It will make the grp command available in your PATH if you've allowed the PATH to be modified when installing Rust. cargo uninstall girep uninstalls.

Back to the crate overview.

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.

Features

New: 🎉
Supported: ✅
Planed support: 🟥
On development: 🔶
Not available on the platform: 🟪

Repositories

Feature	GitHub	Gitea	Codeberg	Forgejo	GitLab	Azure DevOps
List	✅	✅	✅	✅	✅	🟥
Create	✅	✅	✅	✅	✅	🟥
Delete	✅	✅	✅	✅	✅	🟥

Organizations

Feature	GitHub	Gitea	Codeberg	Forgejo	GitLab	Azure DevOps
List	✅	✅	✅	✅	✅	🟪
Create	🟪`1`	✅	✅	✅	✅`2`	🟪
Delete	✅	✅	✅	✅	✅`3`	🟪

git integrations

[!TIP] The git integrations supports any platform that allows you to send oAuth credentials

✅ Clone
- bare
- branch
- url clone This is how to clone any platform
- repo_structure base clone example gh:feraxhp/grp
✅ Push
- tags
- branches
- force
- all
- dry-run
- set-upstream
✅ Pull
- force: Overrides any local code
- rebase: Do a git pull rebase
- dry-run
- set-upstream
✅ Fetch

Installation

Windows: Download the latest .exe from the releases page.
- grp.exe is the portable version
- grp-0.7.1-x86_64.msi is the installer
- Or use winget.
```
winget install --id feraxhp.grp
```
Ubuntu: See releases page for the latest deb package.

wget -O paquete.deb <URL_DEL_PAQUETE> 
dpkg sudo dpkg -i paquete.deb 
sudo apt-get install -f

fedora: See releases page for the latest rpm package.

sudo dnf install <URL_DEL_PAQUETE>

Arch Linux: See build instructions below.
Other Linux distributions: See build instructions below.
MacOS: See build instructions below.

Completions

bash

source <(COMPLETE=bash grp)

zsh

source <(COMPLETE=zsh grp)

fish

COMPLETE=fish grp | source

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:

{
  "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 and gitlab.
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:

{
  "default": "gh",
  "pconf": [
      {
      "name": "gh",
      "owner": "feraxhp",
      "token": "<token generated>",
      "type": "github",
      "endpoint": "api.github.com"
    },
    {
      "name": "tea",
      "owner": "feraxhp",
      "token": "<token generated>",
      "type": "gitea",
      "endpoint": "tea.example.com"
    },
    {
      "name": "glab",
      "owner": "feraxhp",
      "token": "<token generated>",
      "type": "gitlab",
      "endpoint": "gitlab.example.com"
    }
  ]
}

Build and Run

Dependencies

Make sure you have the following dependencies installed on your system:

dependencies
Cargo (Rust)

Build


# 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 .

* Jetbrains has removed access for Jetbrains space So, is removed for the planed support.

1 Github does not allow create orgs by the API for security reasons

2 Some GitLab admins not allow create groups by the API for security reasons, however for sub-groups yes.

3 Delete for GitLab has an aditional step, so if you whant to just mark for delition something you have to add the flag --soft

Need more Functionality?

If you need more functionality, feel free to open an issue or a pull request. remember to follow the contribution guidelines

Installing the grp executable

Installing the `grp` executable