Commando
Custom command builder for Sublime Text 3.
Details
Installs
- Total 2K
- Win 1K
- Mac 330
- Linux 230
Jan 26 | Jan 25 | Jan 24 | Jan 23 | Jan 22 | Jan 21 | Jan 20 | Jan 19 | Jan 18 | Jan 17 | Jan 16 | Jan 15 | Jan 14 | Jan 13 | Jan 12 | Jan 11 | Jan 10 | Jan 9 | Jan 8 | Jan 7 | Jan 6 | Jan 5 | Jan 4 | Jan 3 | Jan 2 | Jan 1 | Dec 31 | Dec 30 | Dec 29 | Dec 28 | Dec 27 | Dec 26 | Dec 25 | Dec 24 | Dec 23 | Dec 22 | Dec 21 | Dec 20 | Dec 19 | Dec 18 | Dec 17 | Dec 16 | Dec 15 | Dec 14 | Dec 13 | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Windows | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
Mac | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
Linux | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
Readme
- Source
- raw.githubusercontent.com
What is Commando?
Commando is a command builder plugin for Sublime Text 3.
How do I use it?
(Coming soon: Bundles!)
A Commando command looks like this:
"command": "commando",
"args": {
"commands": [
["commando_exec", {"cmd": ["git", "diff", "$file"]}],
["commando_new_file", {"syntax": "Diff", "scratch": true, "readonly": true, "name": "Git Diff"}]
]
}
This opens a thread that calls git diff
on the file you currently have open and sends the output of that to a new tab called “Git Diff” with “Diff” syntax. Pretty neat.
Now you can put this anywhere commands can be configured in Sublime. Let's add this command everywhere.
Menus
In your Packages/User/
directory create these files:
Main.sublime-menu
[
{
"caption": "Tools",
"id": "tools",
"children": [
{
"caption": "My Commands",
"id": "my-commands",
"children": [
{
"caption": "Diff File",
"command": "commando",
"args": {
"commands": [
["commando_exec", {"cmd": ["git", "diff", "$file"]}],
["commando_new_file", {"syntax": "Diff", "scratch": true, "readonly": true, "name": "Git Diff"}]
]
}
}
]
}
]
}
]
Context.sublime-menu
[
{
"caption": "My Commands",
"id": "my-commands",
"children": [
{
"caption": "Diff File",
"command": "commando",
"args": {
"commands": [
["commando_exec", {"cmd": ["git", "diff", "$file"]}],
["commando_new_file", {"syntax": "Diff", "scratch": true, "readonly": true, "name": "Git Diff"}]
]
}
}
]
}
]
And now you have your own Tools > My Commands menu, as well as a context menu called My Commands (right click on any file).
Command Palette
Create another file in Packages/User/
named My Commands.sublime-commands
and put this in it:
[
{
"caption": "Diff File",
"command": "commando",
"args": {
"commands": [
["commando_exec", {"cmd": ["git", "diff", "$file"]}],
["commando_new_file", {"syntax": "Diff", "scratch": true, "readonly": true, "name": "Git Diff"}]
]
}
}
]
Now open up the command pallet and type “Diff File”.
Keymaps
Finally, open up your Packages/User/Default (<Your OS>).sublime-keymap
file and add this to your other keymaps:
[
...
{
"keys": ["ctrl+shift+d"],
"command": "commando",
"args": {
"commands": [
["commando_exec", {"cmd": ["git", "diff", "$file"]}],
["commando_new_file", {"syntax": "Diff", "scratch": true, "readonly": true, "name": "Git Diff"}]
]
}
}
...
]
Now hit ctrl
+shift
+d
to do the diff as well.
And that's it, now you can do a diff on the current file from anywhere!
Plugin
However, if you're like me, copy-pasting the same command in several places can get annoying. If you want to take this a step further you can create your own named commands through a plugin. Select Tools
> New Plugin...
, make the file look like this:
from Commando.plugin import CommandoRun
class GitDiffFileCommand(CommandoRun):
def commands(self):
return [
["commando_exec", {"cmd": ["git", "diff", "$file"]}],
["commando_new_file", {"syntax": "Diff", "scratch": True, "readonly": True, "name": "Git Diff"}]
]
and save it as My Commands.py. Now you have a new Sublime command called git_diff_file
that you can use everywhere in place of commando
. So this:
{
"keys": ["ctrl+shift+d"],
"command": "commando",
"args": {
"commands": [
["commando_exec", {"cmd": ["git", "diff", "$file"]}],
["commando_new_file", {"syntax": "Diff", "scratch": true, "readonly": true, "name": "Git Diff"}]
]
}
}
becomes this:
{ "keys": ["ctrl+shift+d"], "command": "git_diff_file" },
But wait, there's more! There are already several useful commando commands you can use to build your own command, but if you need to you can also create your own if you want to. Documentation coming soon! For now, check out commands.py
.
Installation
Package Control
The package is registered in Package Control under the name Commando
.
Manual
Clone this repository as a subdirectory of your Sublime Text 3 Packages directory with the name Commando
. So, for instance:
cd ~/Library/Application\ Support/Sublime\ Text\ 3/Packages
git clone https://github.com/ericpridham/sublime-commando.git Commando
Get Into It
Check out the wiki for full documentation.