fastHistory 0.6.1

A python tool connected to your terminal to store important commands and search them in a new and faster way

fastHistory 2.0 - speed up your terminal!

WARNING: this is a beta version

• Intro
• Supported systems
• How to install
• Commands and syntax
• License

A python tool connected to your terminal to store important commands, search them in a fast way and automatically paste them into your terminal

Intro

Why you need it?

How often do you need to reuse a command but you cannot remember it (or all the needed options/flags)?

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

How many times do you search the same commands on Google, over and over?

42 times.. yes.. based on my experience the answer is 42

And how many times have you told yourself to store this super useful command but you didn't?

I saved them all ..totally, with a good and detailed explanation for each command

if you know what I am talking about, fastHistory is the tool you are looking for!

Usage sample

fastHistory can save your commands directly from your terminal, all you need is a #

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

You can specify one or more tags

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

or a description

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

or both

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

To search the saved commands, all you need is f and the selected command wiil be automatically pasted into your terminal!

$ f

For each command you can get a quick summary from the man page

Warning: this feature currently does not cover the syntax of all commands

And easily edit the tag and description fields

Furthermore, you can easily export/import all data to make backups or to share your commands with a different machine

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

Supported OSs

fastHistory can work in any OS with python3 and a bash terminal

note: zsh is also supported!

List of tested OSs:

OS	OS Version	Shell	Python versions	fastHistory version	Test mode	Result	Comment
Ubuntu	16.04	bash	3.6, 3.7, 3.8	latest	auto + unittest
Ubuntu	18.04	bash	3.6, 3.7, 3.8	latest	auto + unittest
macOS	10.15	bash	3.6, 3.7, 3.8	latest	auto + unittest		python3 needs to be installed
Windows*	10 (1809)	bash	3.6	2.0.0	manual		*using the Ubuntu terminal for Windows
Debian	9	bash	3.5	2.0.0	manual
Fedora	29	bash	3.5	2.0.0	manual
Kali	2020.1b	bash	3.?	1.1.0	manual
Ubuntu	16.04	zsh	3.7	1.1.0	manual
Kali	2020.1b	zsh	3.?	1.1.0	manual		partially tested

How to install

Requirements

• python3
• python3-pip (not needed for offline mode)

Install with pip3

1. pip3 install fasthistory *
2. f **

* do not use pip or sudo

** if command not found, the first time you need to use ~./local/bin/f instead

Install in offline mode

1. download the latest release with this easy-to-type link or manually download it
   • wget mkcn.me/f
2. (if needed) move it to the remote/offline machine
3. unzip it
   • tar -xvzf f
4. run the installer with the target user
   • cd fastHistory-X.X
   • ./installer.sh

Note: all the downloaded files can be deleted after the installation is completed

Update from old git clone

• git pull
• ./installer.sh

Uninstall fastHistory (pip3/offline mode)

1. download the installer script
   • wget https://raw.githubusercontent.com/mkcn/fastHistory/pip/installer.sh
2. make it executable and run it with the uninstall flag
   • chmod +x installer.sh
   • ./installer.sh -u

Note: pip3 install fasthistory is not sufficient to uninstall fastHistory

Commands and syntax

Simple adding

<command_to_save> #[<tag> [#<tag> ...]][@<description>]

Adding without execution

# <command_to_save> #[<tag> [#<tag> ...]][@<description>]

Simple search

f [<filter>]

OR search: match any row where at least one of the following conditions is true:

• the filter words are contained in the command
• the filter words are contained in the tags list
• the filter words are contained in the description

Advanced search

f [<filter>] [#<tag_filter> ...] [@<description_filter>]

AND search: match any rows where all the following conditions are true:

• the filter words are contained in the command OR tags OR description
• the tag_filter words are contained in the tag list
• the description_filter words contained in the description

Export database

f --export [<output_name>]

• the output is the file name of the output database (this parameter is optional)

Import external database

f --import <input_name>

• the input_name is the file name of the input database (e.g. fastHistory_2019-03-23.db)

Change fastHistory configuration

f --config

Force a fastHistory setup to fix possible issues

f --setup

License

The license for this is the same as that used by GNU bash, GNU GPL v3+.

Copyright

The following external projects have been used as part of fastHistory:

• https://github.com/rcaloras/bash-preexec
  • goal: this bash script is used to hook the commands from the terminal
  • code section: bash-preexec.sh
  • changes: no change
• https://github.com/idank/bashlex
  • goal: this Python module is used to parse bash commands in order to show info from the man page
  • code section: fastHistory/parser/bashlex/
  • changes: no change
• https://github.com/wong2/pick
  • goal: this Python module has been used to select the option from the menu
  • code section: fastHistory/pick
  • changes: all code has been restructured and adapted with a different UI