Vestory, um controle de versões prático e rápido usado em qualquer terminal por linha de comando.
Project description
Vestory - Fast, simple and practical
Vestory (junção de "Version" e "History"), é um controle de versões prático e rápido usado em qualquer terminal por linha de comando (CLI). Com comandos simples e fáceis de lembrar, facilitando o uso.
O projeto tem o código-aberto com uso da licença GNU General Public License v3.0. Leia a licença
Links
Versão 1.0.0
Esta versão do Vestory pode:
- Monitorar alterações de arquivos;
- Salvar alterações de arquivos;
- Ver logs de alterações;
- Juntar alterações do arquivo.
Na próxima versão, será possível:
- Voltar na linha do tempo dos arquivos;
- Suporte a arquivos de: fotos, vídeos, executáveis, etc;
- Ver a diferença de uma alteração.
Instalação
Para instalar o Vestory, utilize o gerenciador de pacotes PyPi:
pip install vestory
Após isso, você poderá utilizá-lo pela linha de comando com o comando vestory
.
Utilizando o Vestory
Primeiro, veja a lista de comandos disponíveis até o momento:
init
: cria um novo repositório;add [files]
: adiciona os arquivos ao monitoramento de alterações;submit
: salva as alterações realizadas até o momento.
Inicializando repositório
Para incializar um repositório, utilize o comando init
:
vestory init
Antes disso, é necessário que suas configurações estejam feitas para incializar um repositório corretamente.
Adicionar arquivos
Para adicionar arquivos ao monitoramento de alterações:
vestory add example.txt
Também é possível adicionar vários arquivos de uma vez, escrevendo o nome de cada um ou utilizando a flag -a
:
vestory add example.txt test.py project/app.py
vestory add -a
a flag
-a
adiciona todos os arquivos presentes no diretório.
Submeter alterações
Para submeter uma alteração, você precisa especificar os arquivos, ou submeter a alteração de todos os arquivos que foram adicionados utilizando a flag -a
.
Também é necessário adicionar um comentário sobre aquela alteração, para isso, utilizamos a flag -c
. Veja um exemplo:
vestory submit example.txt -c 'first changes'
Você pode submeter as alterações de todos os arquivos monitorados e adicionar um comentário utilizando a abreviação -ac
:
vestory submit -ac 'first changes'
Juntar alterações
Com o argumento join
, você irá juntar todas as alterações de um arquivo em um único arquivo, substituindo o arquivo original. Veja o uso deste argumento:
vestory join -a
Este comando irá fazer com que todos os arquivos que estão sendo rastreados juntem suas alterações. Também é possível juntar as alterações de apenas um arquivo:
vestory join test.txt
Observe que, aparecerá uma mensagem de aviso antes do processo ser realizado:
warning: the "join" command will replace the current files.
> Do you wish to proceed? [y/n]
Confirmando, o processo será realizado.
Ver log de alterações
Para ver todas as alterações que foram realizadas, utilize o argumento log
:
vestory log
Será apresentado as seguintes informações:
- Nome do autor
- Email do autor
- Data da alteração
- Hash MD5 da alteração
- Comentário sobre a alteração
Status dos arquivos
O status do arquivo mostra se ele foi alterado ou não, para verificar essa informação, utilize o argumento status
:
vestory status
Licença
GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007
Copyright (C) 2007 Free Software Foundation, Inc. https://fsf.org/ Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.