If you want to have your Bunches perform different tasks based on various criteria, conditional logic can add flexibility and control.
Bunch supports if/else syntax. There are a number of conditions you can use to determine if a certain block will run. The most basic form of this is the “if” statement. The block starts with an “if condition” line, no indentation, and ends with a line containing just “end”. The contents between the “if” and “end” are indented 4 spaces or one tab.
if var_one Messages <Snippets.snip#Group 1 end
Indentation must be exactly four (4) spaces or one (1) tab per level, with an additional 4 spaces/1 tab per nested level. If using spaces instead of tabs, every indentation level must be a multiple of 4.
The condition can use a variety of syntax, from human readable to symbolic. See the next section for details. In the example above, Bunch simply tests the contents of a variable called var_one to see if it exists (is defined and has a value that’s not “false” or “no”). If so, it launches Messages and runs a snippet.
You can go further by providing “else” statements. These can be “else if condition”, or just “else” to have a block that runs if nothing else matches. Both are optional. If used, the “else” block should come last.
if var_one is "Choice 1" var_two = "Project 1" <<#Load Project else if var_one is "Choice 2" var_two = "Project 2" <<#Load Project else <<#Load Default end
Conditions can be combined using “AND” and “OR”.
if condition 1 AND condition 2 <<#You Win end
You can group multiple conditions in parentheses and compare multiple groupings.
if (condition 1 AND condition 2) OR (condition 3 AND condition 4) <<#You Win end
You can nest if/else blocks, continuing to indent contents 4 spaces or one tab from the last level of indentation. Variables can be changed within blocks and tested again in nested conditions.
test_var = true if test_var (log test_var is true) test_var = false if test_var (log test_var is true) else (log test_var is false) end end
Waiting Snippets are specified by indenting 4 spaces or 1 tab, so within an if/else block they should be indented an extra 4 spaces or 1 tab beyond the indentation of the block level.
if TweetBot is running Messages <<#Position Comms end
Variable names in conditions can be “bare,” writing just the variable name. You can optionally use a
$variable for clarity. If a variable matching the key isn’t defined, it will return false and not run the block. If your variable name contains spaces, you must either write it without spaces (
first name ->
firstname) or use curly brackets (
All conditions can be negated using “not” or
! condition. Negatives can only be invoked once, e.g.
weekday not !Friday will be interpreted as
weekday is not Friday.
if [condition] where
[condition] is one of the following.
- Test if the current machine UUID matches
uuid is C6766848-065C-51F8-B2EE-3A9DA8A10017
uuid is not C6766848-065C-51F8-B2EE-3A9DA8A10017
UUID does not match
UUID does not match
- File exists/contains
- Test if a given file path exists, and optionally if it contains a text string
file PATH exists
File exists at path
file PATH does not exist
File does not exist at path
File does not exist
file PATH contains TEXT
File at PATH exists and contains the text TEXT
file PATH does not contain TEXT
File at PATH either doesn’t exist,
or doesn’t contain text
- Bunch Phase
- Test if a Bunch is in the process of opening or closing (phase). Use “self” or “this” to test current Bunch.
self is opening
Current Bunch is opening
self is closing
Current Bunch is closing
BunchName is opening
Test another Bunch such as a
parent Bunch which opened this Bunch
- Bunch State
- Test if another Bunch is currently open or closed.
BunchName is open
Bunch is currently open
BunchName is closed
Bunch is currently closed.
Also works as
BunchName is not open
- If a Bunch was opened by another Bunch, its parent can be tested
Bunch was opened by another Bunch
is not child
parent is BunchName
Test which Bunch opened this Bunch
Any text comparison operators work
parent contains PartialName
- App is running
- Test if a given app is running or not.
if Messages is running
AppName is running
App is currently running
AppName is not running
App is not running
isis optional in all tests, so this works as
AppName not running
- Test a variable’s contents numerically. Conditions can be written out or represented with mathematical symbols.
All conditions can be negated with
var_name is not less thanis the same as
var_name is greater than or equal to. Symbols can be negated with
var_name !<= 5.
if var_name is greater than 1
Natural language Symbolic
is less than
var_name < 5
is less than or equal
var_name <= 5
is greater than
var_name > 1
is greater than or equal to
var_name >= 3
var_name == 2
- Compare variable contents as a string. Comparisons are always case insensitive.
if var_name contains "complete"
Natural language Symbolic
does not start with
does not end with
does not contain
- If the string being compared to is “yes”, “no”, “true”, or “false”, the comparison is “truthy”, meaning it’s registered as a boolean (true/false), and if the variable starts with “t”, “y”, or a number greater than 0, it matches true, and if it starts with “n”, “f”, or zero, it matches false.
- I.e. if
var_nameis set to “yes” and the condition is
if var_name is true, the condition will pass.
- Test whether the current weekday is before, after or is a given day, with the week starting on Sunday. Days can be abbreviated with standard abbreviations (
fri). This comparison only works in English. The condition just needs to start with
Remember that you can combine multiple conditions with “OR”, so to have a block run on Tuesday and Thursday, use
weekday is Tues OR weekday is Thurs
if weekday is Wednesday
Current weekday matches
weekday is before/
is not before
From Sunday up to current day
weekday is after/
is not after
After current day and before next Sunday
- Test whether the current time is before, after, or matches a test value. Times can be in 24-hour format, or 12-hour with a meridian (am/pm).
if time is before 12pm
Current time matches
time is before/
is not before
Between 12am and current time
time is after/
is not after
Between current time and 12am
You can use the output of shell scripts to set variables which can then be tested with if/else blocks.
my_var = $ test_script.sh // returns a string value on STDOUT if my_var is "result one" <<#First Result else if my_var is "result two" <<#Second Result end
This works with AppleScripts as well (
my_var = * ...), as long as the script returns a string or number.
You can set a variable using a dialog, and then use an if/else block to perform different actions based on the choice. In its simplest form, this is essentially the same as just having a dialog run different snippets based on user selection, but by setting a variable you can have multiple if/else blocks, and the variable is passed to snippets (which can also contain their own if/else blocks).
my_var = ?[Option 1, Option 2, Option 3] "Which option?" if my_var ends with "1" Sublime Text - ~/Code/My Project my_var_2 = $ Test.sh // set a second variable // both my_var and my_var_2 are passed to any snippets called // which can then branch further <<#First else if my_var ends with "2" ... end
Because if/else blocks can be used within Snippets, you can use an on-close Snippet to run logic when closing a Bunch.
!<<#On Close __________________________ -[On Close]--------------- if Tweetbot is not running Comms.bunch end