Merge Variables
Text Replacement Package for Sublime Text 2 and 3
Details
Installs
- Total 2K
- Win 1K
- Mac 570
- Linux 237
Feb 5 | Feb 4 | Feb 3 | Feb 2 | Feb 1 | Jan 31 | Jan 30 | Jan 29 | Jan 28 | Jan 27 | 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 | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Windows | 0 | 0 | 0 | 0 | 1 | 1 | 1 | 0 | 0 | 1 | 0 | 1 | 1 | 0 | 0 | 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 |
Mac | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 0 | 1 | 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 | 1 | 0 | 0 | 0 | 0 | 0 | 0 |
Readme
- Source
- raw.githubusercontent.com
Merge Variables
Text Replacement Package for Sublime Text 2 and 3
Merge Variables allows you define sets of replaceable strings. When you run the Merge Variables
command, the package expands each of the strings with a replacement. For example, you can turn this:
<a href="http://{{HOSTNAME}}/page">{{TITLE}}</a>
into:
<a href="http://www.myexamplesite.com/page">My Example Site</a>
How to Use
Creating Sets
To define the your variables and their values, open the user settings for the package. Create a "sets"
member. This member will be an object, and each of its members will be the name of a “set”. Each of the sets will also be an object containin key-value pairs for the variables and their values. Here's an example:
{
"sets": {
"mysite": {
"{{HOSTNAME}}": "www.myexamplesite.com",
"{{TITLE}}": "My Example Site"
}
}
}
Note: There's no need to use double curly braces around your variables names. This is my convention, but it isn't required. You may want to use some symbols on either side to safeguard against unwanted replacements. %PERCENTS%, [brackets], =Equals=, etc. could all be good choices.
Next you'll need to make this an active set. Add an "active_sets"
member to the user settings file. This member is a list of all of the names of sets you would like to use.
{
"active_sets": ["mysite"],
"sets": {
"mysite": {
"{{HOSTNAME}}": "www.myexamplesite.com",
"{{TITLE}}": "My Example Site"
}
}
}
Merging Variables
Once you have your variables defined, open the Command Palette (Shift + Command + P) and enter Merge Variables
.
Cascading Sets
But wait! There's more! You can define multiple sets, and merge them together. In this example, there are three sets: "mysite"
, "mysite-development"
, and "some other set we're not going to use yet"
.
{
"active_sets": ["mysite", "mysite-development"],
"sets": {
"mysite": {
"{{HOSTNAME}}": "www.myexamplesite.com",
"{{TITLE}}": "My Example Site"
},
"mysite-development": {
"{{HOSTNAME}}": "dev.myexamplesite.com"
},
"some other set we're not going to use yet": {
"{{HOSTNAME}}": "www.not-this-site.com",
"{{TITLE}}": "Won't See This Title"
}
}
}
I've specified the list of active sets as ["mysite", "mysite-development"]
. This tells the package to start wth the key-value pairs from "mysite"
first, then override those values with the ones in "mysite-development"
. Here's what happens:
{{HOSTNAME}}
is defined in both sets. The value from the last set takes precedence.{{TITLE}}
is defined in the first set, but not the second. That's okay. The value from the first carries through.- The set
"some other set we're not going to use yet"
is not in the list of active sets, so its values are ignored.
The result:
<a href="http://dev.myexamplesite.com/page">My Example Site</a>
Programatically
If you're super cool, and you write Sublime packages too, you may want to call Merge Variables
in code. When you do, you can pass the list of active sets at call time. Here's an example:
view.run_command("merge_variables", active_sets=["this_set", "that_set"])
Installation
Sublime Package Control
You can install Merge Variables using the excellent Package Control package manager for Sublime Text:
- Open “Package Control: Install Package” from the Command Palette (
Shift
+Command
+P
). - Select the “Merge Variables” option to install Merge Variables.
Git Installation
To install manually using Git, clone to your “Packages” directory.
git clone git@github.com:pjdietz/sublime-merge-variables.git "Merge Variables"
Note: Some features such as the menu command to open the default settings will not work if the package is not installed to a directory called “Merge Variables”.
Author
PJ Dietz
Copyright and license
Copyright 2013 PJ Dietz