Introdução
Em um post anterior apresentei a vocês o Codeberg: uma alternativa gratuita e Open-Source ao Github e ao Gitlab.
Sou adepto a usar o terminal sempre que possível. Dito isso, algo que me incomodava um pouco era o fato de que Github e Gitlab oferecem ferramentas CLI oficiais (gh e glab, respectivamente) para a configuração de repositórios, merges, etc. O Codeberg não fornece uma CLI, de modo que sempre que precisava criar, deletar ou editar a descrição de repositório, por exemplo, tinha que acessar via browser. Nada muito sério, só uma inconveniência.
Pois encontrei berg: uma CLI para o Codeberg que se propõe a ser uma solução similar ao gh e ao glab. A CLI não é oficial, mas cumpre bem com seu papel (veja observação no fim do post).
Neste post descrevo brevemente como instalar e utilizar berg.
Instalação
berg é escrito em Rust, de modo que o primeiro passo é instalar Rust e seu gerenciador de pacotes e builder cargo:
curl https://sh.rustup.rs -sSf | sh
Feito isso, o seguinte código será adicionado em seu .bashrc:
. "$HOME/.cargo/env"
Cabe notar que em Bash o ponto . é um alias para o builtin source. Se você utiliza . em outras aplicações (como é o meu caso), para que não haja problemas altere a linha acima para
source "$HOME/.cargo/env"
Agora clone o repositório do berg e o instale com cargo:
git clone https://codeberg.org/RobWalt/codeberg-cli
cd codeberg-cli
cargo install --path .
Autorização
Depois de instalado, autorize o uso de berg em sua conta do Codeberg com
berg auth login
Prossiga com um y e você será redirecionado para sua conta do Codeberg. Gere um token adicionando um nome e as permissões que você deseja. Copie o token e cole no terminal onde executou o comando anterior.
Pronto! Agora você já pode utilizar o berg com as permissões criadas.
Utilização
Dê um berg -h para ver as opções disponíveis:
Usage: berg [COMMAND]
Commands:
auth Authentication subcommands
user User subcommands
issue Issue subcommands
pull Pull request subcommands
label Label subcommands
repo Repository subcommands
milestone Milestone subcommands
notification
completion Print completion script
help Print this message or the help of the given subcommand(s)
Options:
-h, --help Print help (see more with '--help')
-V, --version Print version
Por exemplo, se quiser criar um repositório, execute berg repo create e siga as instruções.
Para mais detalhes sobre um dada opção ou comando, execute berg [option] --help.
-
OBS: uma pena é que com
bergnão se pode deletar repositórios, algo que pode ser feito diretamente comgh, por exemplo.
Fim
É isso. Com berg o Codeberg se torna uma alternativa ainda mais viável ao manejo de pequenos projetos. Codeberg ainda não fornece (e ao que pude entender nem se propõe a tal) ferramentas CI/CD, de modo que o manejo de grandes projetos ainda é bastante limitado.
Um abraço e até mais.
Yuri Ximenes Martins
Top comments (0)