yasutakatou / hiffer

hiffer is History + Diff command. amazing and revolutionary your test automation tool.

hiffer

hiffer is HISTORY + DIFF tool, will be amazing and revolutional test automation tool!

demo

support linux and windows.

solution

When you want change human test operation to automation, for example, you may use Ansible.
Surely, can chane test operation to code. but, your team mate same?

You will hit the wall.
Your team mate must lern skill , know how , will spented same learning cost, too.

or when you must imediately operation occured (ex troubble), you direct operation on terminal.
You must remember your operation, and will must remind operations when test .

hiffer! this tool clear your worries.
Can remember your operation to history, and you check differerce anytime.

features

• When operation on hiffer, write output to temporary file.
• Check diff by check sum, if diff exists, output colored text.
• History can edittable, insert and delete.
• Convert strings pre execute, after execute. (for example, in case of command require tty)
• Suppoert file name auto completer in current directory

install

git clone https://github.com/yasutakatou/hiffer
cd hiffer
go build .

or download binary from release page.
save binary file, copy to entryed execute path directory.

uninstall

delete that binary.

del or rm command. (it's simple!)

usecase

This tool wrap cmd.exe (when Windows),or unix shell. but you don't worry,
You can usualy do operation. when you complete server and want to test setting,
hiffer help you, do your operation again and diff output. so, you notice different value on setting.

this tool run option

options

-config strings [-config=config file (default: .hiffer)] (default ".hiffer")
    -config this option set config file, and read it.
-debug [-debug=debug mode (true is enable)]
    -debug is debug(verbose) mode. 

functions

When default input, this string execute on os and added history.

ex) ls
execute "ls", and add output to history's end.

note) This tool imprement tab completer, so you press tab, do file compeleter in current directory.

note) if add to head character "!", not add historys.

If another input , and api name the same, do following.

@del

delete history. you set history number to parameter, delete. or use range parameter "-".

ex) @del 1-3
delete history number 1,2,3

@env

show enviroment value, or set enviroment value.
You can set following environment parameter.

TEST

TEST parameter is history number list for default test. if you do @test no parameter, use this value.
value is csv format and or use range parameter "-".

ex) @env TEST="1,3,5-10"
test to 1,3,5,6,7,8,9,10

note: if set "all", test all.

SHELL

set use your favor shell . can use on linux only.
note: on windows, always using cmd.exe

MAXHISTORYS

history max count. if you historys over this value, first history delete.
or historys over this value now, delete historys until this value.

PROMPT

This value is used prompt strings.
note) when strings inclosed special character "`", strings is execute and setted to prompt.
note) strings execute on os by your privilege. so, don't use dangerous command.

ex) `pwd`
your prompt => do `pwd`>

TEMP

This value is temporary directory. use to write execute output.

@export

export config file. your parameter is file name.

@ins

execute command and insert output. format is @ins (int) (command).

ex) @ins 5 "free"
execute "free" command and insert output to history number 5.

@kill

all histories and output file delete in temporary directory.

note) if you ware changed temporary directory, old temprary directory not delete.

@show

show history list, or show old executed output.

ex) @show
show all list historys

ex) @show 1
show history number 1 executed output

@test

execute history number, and to diff old output. value is csv format and or use range parameter "-".

ex) @env TEST="1,3,5-10"
test to 1,3,5,6,7,8,9,10

note: if set "all", test all. and if parameter is empty, use enviroment value TEST.

exit

exit and save config.

config file (defaut .hiffer)

basic, config detail can see @env section. following option, CONVERT is another.

CONVERT

This option is convert strings when pre execute command or after.

using 4 values.
1 is convert keyword string. if strings include this value, converte strings.
2 is when converting. "true" is pre execute, "false" is afier executed.
3 is pre convert strings, 4 is after.

ex) vim,true,$,>&2
pre) vim test.txt
after) vim test.txt >&2

note) can use regex.
note) this config can edit on config file only.