Hookblime lets you easily add hooks to execute your own scripts on file events.
Hook scripts are executed by the user's default shell*, giving you the possibity of using shell-scripting oneliners.
These are the currently supported events:
- on_new: Executed when a new file tab created.
- on_load: Executed when an existing file is opened.
- on_close: Executed when a tab is closed.
- on_pre_save: Executed before a file is saved.
- on_post_save: Executed after a file is saved.
Hookblime can be configured at any level of the Sublime's settings hierachy, both in global and scoped ways.
All configuration must be set in an entry called "hookblime", containing a dict for each global hook and scope. Each scope must contain its desired hooks.
Each hook dict must have a "cmd" string value with the script to execute, and can have an optional boolean entry called "replace_filename" which if true, makes the plugin replace the string "%(file_name)" with the current file's path. Note that on_new and on_close hooks can be triggered by non-saved files, in which cases an empty path will appended.
If both global and scoped hooks are matched, only the later would be executed.
Sample configuration:
"hookblime" : {
"source.python" : {
"on_post_save" : {
"cmd": "python_saved %(file_name)",
"replace_filename": true
}
},
"on_new" : {
"cmd": "global_hook_new_tab"
}
}
* The working directory of the scripts is always the user's home.