SnapDB

Proyecto de control de versiones para bases de datos PostgreSQL. Permite realizar backups incrementales y gestionar el historial de cambios en la base de datos.

Warning

Actualmente solo compatible con windows.

Contenido

• Requisitos
• Instalación
• Instalar en Windows
• Instalar en Linux
• Uso
• Getting Started
• Screenshot

Requisitos

Requisito	Versión mínima
Python	>= 3.8
pip	>= 21.0

Dependencias de Python:

• typer — CLI framework
• requests — HTTP client

Instalación

1. Clona el repositorio:

   git clone https://github.com/epmyas2022/SnapDB.git

2. Navega al directorio del proyecto:

   cd SnapDB

3. Instala las dependencias:

   pip install -r requirements.txt

Instalación en modo editable:

pip install -e .

Instalar en Windows

Ejecutar como administrador el siguiente comando en PowerShell

$u="https://github.com/epmyas2022/SnapDB/releases/download/beta/snapdb.exe";$d="C:\Tools\SnapDB";mkdir $d -Force; iwr $u -OutFile "$d\snapdb.exe"; setx PATH "$env:PATH;$d" /M

snapdb --help

Instalar en Linux

Ejecutar el siguiente comando en la terminal

sudo curl -L https://github.com/epmyas2022/SnapDB/releases/download/beta-linux/snapdb \
  -o /usr/local/bin/snapdb && \
sudo chmod +x /usr/local/bin/snapdb

snapdb --help

Uso

snapdb [OPTIONS] COMMAND [ARGS]...

Opciones:

• --install-completion — Instala el autocompletado para el shell actual.
• --show-completion — Muestra el autocompletado para el shell actual.
• --help — Muestra el mensaje de ayuda y sale.

Comandos:

• use — Selecciona la versión de PostgreSQL a utilizar.
• version — Muestra la versión actual.
• fetch — Muestra la lista de paquetes disponibles.
• list — Muestra la lista de paquetes instalados.
• install — Instala un paquete específico.
• checkout — Restaura el estado de la base de datos a un commit específico.
• status — Muestra el estado actual del staging.
• logs — Muestra el historial de commits.
• init — Inicializa un nuevo repositorio de control de versiones.
• connections — Muestra las conexiones disponibles.
• connect — Activa una conexión específica.
• create-connection — Crea una nueva conexión.
• add — Agrega un archivo de respaldo al staging.
• commit — Crea un nuevo commit con los archivos en staging.

Getting Started

Ejemplo de flujo completo desde cero.

1. Inicializar el proyecto

snapdb init test-Project

2. Crear una conexión a la base de datos

snapdb create-connection my-fir -H localhost -P 5432 -U postgres -d postgres -p postgres

3. Instalar el driver de PostgreSQL

snapdb install @windows/postgres-17.8

4. Establecer el driver por defecto

snapdb use @windows/postgres-17.8

5. Agregar un backup al staging

snapdb add hola

6. Crear un commit

snapdb commit "hola"

7. Ver el historial de commits

snapdb logs

8. Restaurar a un commit específico

snapdb checkout <hash>

Screenshot