bme 1.4.4

Description:

bme 1.4.4

BME
(Bookmark my Executions/Commands)
Never use notepads or history for searching for your past commands. With BME you can bookmark your commands, search in your bookmarked commands and
execute them with edit possibility before execution.



Supported
OS
No specific requirements here, whatever runs Python
Requirements
Python

3.7+

Installing
MacOS
On most MacOS machines there is pip3 instead of pip use pip3 for install
Install and update using pip:
pip install bme

or

pip3 install bme

All your commands are saved in '~/.bme/bookmarks.json'
Usage:
For adding bookmark:
(Quotas can be used)
bme add <your command>

For Removing bookmark:
(Quotas can be used)
bme rm <your command>

For List bookmarks:
(Quotas can be used)
bme list <searched>


searched is optional, only if you want to list specific commands
Regex, match case and full word flags are supported

For Executing bookmark:
Basic search bme run <searched>
Regex search bme run <searched> -r <my-regex*>
Formatting support:
You can format command from bookmark with python formatting as such

Use {} to be placeholder for your tuple arguments
Use {name} to be placeholder with key name for your dictionary arguments

Mixing tuple and dict arguments is not supported!
Example:
Tuple:
bme add echo "Hello {} !"
bme run ec Jiri

Dictionary arguments:
bme add echo "Hello {name} from {location}"
bme run ec name=Jiri location=Prague

or
bme run ec name=\"Jiri\" location=\"Prague\"

Optional flags:
"-e" or "--edit" for editing command before execution
"-r <your-regex>" or "--regex <your-regex>" for full word search only
"-f" or "--full-word" for full word search only
"-m" or "--match-case" for search with matching case
(Quotas can be used)
bme run <your command>

Sequences
Sequences are like scripts, except you don't have to search for location and manage them with different .bashrc or different OS specific files.
Also thanks to this, you don't have to add them to PATH.
BME will take care of storing your sequences in your ~/.bme folder and will help you to search in them.
These sequences work from everywhere and execution is always in your current working directory.
Commands:
Create Sequence
bme seq create {name}
Example:
bme seq create my_sequence
Remove Sequence
bme seq rm {name}
Example
bme seq rm my_sequence
Edit Sequence
bme seq edit
This will display location of json with sequences
Add Command to Sequence
This will add command to sequence with use of variadic arguments
bme seq add {sequence_name} {command...}

Example:
bme seq add my_sequence ssh [email protected]

Pop Command from Sequence
This will pop command from sequence with use of variadic arguments
bme seq pop {sequence_name} {command...}

Example:
bme seq pop my_sequence ssh [email protected]

Sequence Run
Runs supplied sequence, and will do search for you if not found
bme sequence run {sequence_name}

Sequence does support formatting of dynamic arguments same way as bookmarks
these arguments will be passed to every command for formatting
Example:
bme sequence run my_sequence John

or
bme sequence run my_sequence name=John

Sequence Watch (!BETA!)
Launches sequence on file modify
bme sequence watch {sequence_name} {file_path}

List Sequence
This will list commands and sequences, if argument is used search in text is applied to results
Optional flags:
"-r <your-regex>" or "--regex <your-regex>"` for full word search only
"-f" or "--full-word" for full word search only
"-m" or "--match-case" for search with matching case

Example Data:
In sequence DB there is:
'ssh [email protected]' command
'ssh [email protected]' command
'scp [email protected]' command

Command bme sequence list will list all the sequences and their commands
Specific listing format:
bme sequence list <optional commands that match this to list>

Example:
bme sequence list ssh

Output:
'ssh [email protected]' command
'ssh [email protected]' command


Did I made your life less painful ?


Support my coffee addiction ;)