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.2
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;
- Ignorar arquivos;
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, substituindo o arquivo original. Veja o uso deste argumento:
vestory join
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
- ID da mudança
- 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
Ignorando arquivos ou diretórios
Para ignorar arquivos ou diretórios, crie um arquivo na raíz do seu diretório chamado .ignoreme
. Adicione linha a linha cada arquivo/diretório que serão ignorados. Ao ignorar um arquivo, ele não será adicionado ao monitoramento de alterações quando utilizar o comando add -a
, e nem terá suas alterações submetidas.
Na adição de subdiretórios em .ignoreme
, faça isto desta forma:
dir/subdir
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.