repoman

Utilitat per clonar masivament repositoris de gitea

Lista los repositorios de un usuario u organización en un servidor Gitea, los cruza con los que ya tengas clonados en una carpeta local y te deja clonar los que falten desde una lista navegable.

Uso

repoman /ruta/local [<usuario-o-org>]

El segundo argumento es opcional si tienes default_owner en la config.

Interacción

Una vez dentro de la lista:

Tecla	Acción
`↑` / `↓` / `j` / `k`	mover cursor una fila
`←` / `→` / `h` / `l` / `PgUp` / `PgDn`	pasar de página
`g` / `Home` · `G` / `End`	inicio / final de la lista
`Space`	marcar / desmarcar el repo bajo el cursor
`a`	marcar todos los que aún no estén en local
`n`	desmarcar todo
`Enter`	clonar los marcados (en paralelo)
`r`	refrescar (vuelve a consultar al servidor)
`q` / `Ctrl-C`	salir

La lista se pagina automáticamente según la altura del terminal, así que con miles de repos sigue respondiendo al instante.

Iconos de estado:

○ remoto — está en el servidor, no clonado localmente
☑ marcado — pendiente de clonar
⟳ clonando… — clone en curso
✓ clonado — éxito
✗ <err> — clone fallido (motivo abreviado)
● en local — ya existía en local
◇ sólo local — está en local pero no en el servidor
🔒 — repo privado

Configuración

Se carga siempre desde ~/.config/repoman/config.toml (respeta XDG_CONFIG_HOME):

[server]
url = "https://gitea.example.com"
# token = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"   # opcional, para repos privados
# default_owner = "tu-usuario"                  # opcional, omite el argumento
# clone_protocol = "https"                      # "https" (por defecto) o "ssh"

El token se genera en Gitea en Settings → Applications → Generate New Token con el scope read:repository como mínimo. Sin token sólo verás repos públicos.

Requisitos en el sistema

Necesarios siempre:

python3 (≥ 3.11, por tomllib en stdlib)
git

Para desarrollar (con venv):

python3-venv

Para compilar a binario con Nuitka (./build.sh):

python3-dev — cabeceras Python.h
gcc — compilador C
patchelf — necesario para el modo --onefile en Linux

En Debian/Ubuntu:

sudo apt install python3 python3-venv python3-dev git gcc patchelf

Desarrollo (con venv)

python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/python repoman.py /ruta/local mi-usuario

Compilar a binario standalone

./build.sh

Genera dist/repoman, un único ejecutable autocontenido (lleva Python, rich y readchar dentro), más un dist/repoman-vX.Y.Z-linux-arch.tar.gz listo para distribuir. Para instalarlo en tu PATH:

cp dist/repoman ~/.local/bin/

Ficheros

repoman.py — script principal
requirements.txt — dependencias Python (rich, readchar)
build.sh — compila el binario con Nuitka
README.md — este fichero
.venv/ — virtualenv local (no en git)
dist/ — binarios compilados (no en git)

Notas

La detección de "ya clonado" compara primero la URL del origin con la clone_url/ssh_url del servidor; si no hay match, cae a comparar por nombre. Eso evita falsos positivos cuando tienes carpetas que se llaman igual pero apuntan a otro servidor.
Los clones se ejecutan en paralelo (máx. 4 a la vez).
Se usa el endpoint GET /api/v1/repos/search?owner=<x> con paginación de 50 en 50, así sirve tanto para usuarios como para organizaciones.

3.5 KiB Raw Blame History