fastHistory

fastHistory 2 - acelere seu terminal!

• Introdução
• Sistemas suportados
• Instalar
• Atualizar
• Comandos e sintaxe
• Direitos autorais e dependências
• Licença

Armazene, pesquise e cole automaticamente todos os seus comandos favoritos diretamente no seu terminal de uma maneira nova e mais rápida !

Com a nova integração de páginas TDLR, você pode descobrir e selecionar rapidamente mais de 10.000 exemplos de comandos prontos para uso, diretamente em seu terminal.

Introdução

Por que você precisa disso?

Com que frequência você precisa reutilizar um comando, mas não consegue se lembrar dele (com todas as opções/sinalizadores necessários)?

 # example of a common but not so 'easy-to-remember' bash command from my bash history
$ tar -xvzf file.tar.gz

Quantas vezes você pesquisa os mesmos comandos no Google repetidamente?

42 vezes.. sim.. com base na minha experiência, a resposta é 42

E quantas vezes você disse a si mesmo para armazenar esse comando super útil, mas não o fez?

Salvei todos ..totalmente, com uma explicação boa e detalhada de cada comando

se você sabe do que estou falando, fastHistory é a ferramenta que você procura!

Amostra de uso

fastHistory pode salvar seus comandos diretamente do seu terminal, tudo que você precisa é de um #

$ tar -xvzf file.tar.gz #
                       /
                        - - fastHistory will store ' tar -xvzf file.tar.gz ' in its local database

Você pode especificar uma ou mais tags

$ tar -xvzf file.tar.gz # untar #extract #archive 

ou uma descrição

$ tar -xvzf file.tar.gz # @extract compressed files from archive

ou ambos

$ tar -xvf archive.tar.gz # untar @extract compressed files from archive

Para pesquisar os comandos salvos, basta f e o comando selecionado será automaticamente colado em seu terminal!

$ f

Para cada comando armazenado você pode obter um resumo rápido na página de manual

nota : este recurso não cobre a sintaxe de todos os comandos

E edite facilmente os campos de tag e descrição

Além disso, você pode exportar/importar facilmente todos os dados para fazer backups ou compartilhar seus comandos com uma máquina diferente

$ f --export
$ f --import fastHistory_2020-03-02.db

Descubra novos comandos

No modo Discovery , você pode encontrar facilmente exemplos de comandos nas páginas TDLR, uma coleção de páginas de ajuda mantidas pela comunidade. A pesquisa funciona tanto por nome quanto por descrição do comando. Além disso, o ícone + mostra qual comando já está instalado em seu sistema.

Recurso off-line

FastHistory não precisa de nenhuma conexão com a internet, então você também pode usá-lo offline !

Sistemas operacionais suportados

fastHistory pode funcionar em qualquer sistema operacional com python3 e um terminal bash

zsh também é suportado!

Lista de sistemas operacionais testados:

SO	Versão do sistema operacional	Concha	Versões Python	versão FastHistory	Modo de teste	Comentário
Ubuntu	16,04, 18,04, 20,04*	festa	3,6, 3,7, 3,8	mais recente	teste unitário	* Pode ser necessário instalar o xclip para ativar o recurso de copiar para a área de transferência
macOS	10h15	festa	3,6, 3,7, 3,8	mais recente	teste unitário	python3 precisa ser instalado
Fedora	29	festa	3.5	2.0.0	manual	pip3 requer o sinalizador --user
Debian	9	festa	3.5	2.3.6	manual
Debian	10	zsh*	3.7	2.0.0	manual	*limitação de sintaxe
Windows*	10 (1809)	festa	3.6	2.4.1	manual	*usando o Windows Subsystem for Linux (WSL) você pode executar e armazenar comandos do Windows

Como instalar

Requisitos

• python3
• python3-pip (apenas para instalação do pip3)

Instalar com pip3

1. pip3 install fasthistory
2. $HOME/.local/bin/f
3. feche e reabra seu terminal

Nota : certifique-se de não usar pip (python2) nem sudo (instale-o apenas para o usuário atual)

Instale com installer.sh (modo offline)

1. baixe a versão mais recente com este link fácil de digitar ou baixe-a manualmente
   • wget mkcn.me/f
2. movê-lo para o sistema de destino
3. extraia-o e execute o instalador com o usuário alvo
   • tar -xvzf f
   • cd fastHistory-XX
   • ./installer.sh
4. feche e reabra seu terminal
5. (opcional) exclua os arquivos de instalação
   • rm -rf fastHistory-XX

Tudo em uma linha

cd $(mktemp -d /tmp/f.XXXXX) && wget https://mkcn.me/f && tar -xvzf f && ./fastHistory-*/installer.sh && cd -

Como atualizar

Atualizar com f (disponível a partir de 2.1.1)

1. f --update
2. feche e reabra seu terminal

Atualizar com pip3

1. pip3 install -U --no-cache-dir fasthistory
2. f
3. feche e reabra seu terminal

Atualizar com installer.sh

• mesmos passos da instalação

Nota : para atualizar a partir da versão 1.xx é necessário seguir estes passos

Como desinstalar

1. baixe o script do instalador e torne-o executável
   • wget https://raw.githubusercontent.com/mkcn/fastHistory/master/installer.sh
   • chmod +x installer.sh
2. execute-o com o sinalizador de desinstalação
   • ./installer.sh -u

Nota : pip3 install fasthistory não é suficiente para desinstalar fastHistory

Comandos e sistema

Saiba mais sobre comandos e sintaxe na seção Wiki

Direitos autorais e dependências

• https://github.com/tldr-pages/tldr
  • objetivo : cheatsheets colaborativos para comandos de console
  • alterações : a pasta da página foi copiada para suportar o modo offline e a sintaxe modificada para melhorar a velocidade de pesquisa
  • seção de código : fastHistory/tldr/tldr/
• https://github.com/wong2/pick
  • objetivo : módulo python modificado para construir o menu de seleção de comandos
  • seção de código : fastHistory/pick
• https://github.com/rcaloras/bash-preexec
  • objetivo : script bash usado para conectar os comandos do terminal
  • seção de código : fastHistory/bash/bash-preexec.sh
• https://pypi.org/project/pyperclip/
  • objetivo : recurso de copiar para a área de transferência
  • seção de código : (optional) pip module
• https://pypi.org/project/bashlex/
  • objetivo : analisar comandos para preencher a seção 'Informações da página de manual'
  • seção de código : (optional) pip module

Licença

A licença para isso é a mesma usada pelo GNU bash, GNU GPL v3+.