Atom package for bunch syntax published

2022-03-20T19:00:00+00:00

Bunch is a Mac app that allows you to create plaintext files to launch a “bunch” of apps and change system settings. It is great for contextual computing and I use it to automatically rearrange windows with hammerspoon, set a Focus Mode with Shortcuts, open a perspective in Omnifocus, and start a timer with Timery all at the same time when I switch contexts. The only problem is that it is a little bit annoying to edit these plaintext files without any syntax highlighting to see commands and strings and stuff like that.

To fix this, I created a plugin for my favorite text editor, atom (I’m using it right now as I write this), which adds support for .bunch files. It also includes. snippets for common commands.

install the plugin here

contribute to the plugin on github

Creating atom language plugins

I created this plugin as a treesitter language plugin for atom. It has a very simple file structure:

language-bunch
├── LICENSE
├── README.md
├── grammars
│   └── bunch.cson
├── snippets
│   └── bunch.cson
└── package.json

Syntax highlighting

The grammars/bunch.cson file has a patterns field that lets you patch regex patterns, and tell Atom what the text represents, a string, a variable, a command, etc. For example, here is the code to match comments in .bunch files.

{
    name: 'comment.line.bunch'
    match: '#.*$'
}

Snippets

Then, in the snippets/bunch.cson file, you can list a “prefix” and a “body” to show autocomplete suggestions for common commands. For example, here are a few commands I use for bunch files.

'display':
    'prefix': 'di'
    'body': 'display '
'dark mode':
    'prefix': 'da'
    'body': 'dark mode'
'light mode':
    'prefix': 'li'
    'body': 'light mode'
'wallpaper':
    'prefix': 'wal'
    'body': 'wallpaper'

This site is built on jekyll

2021-08-31T04:25:09+00:00

Here is how it works

You’ll find this post in your _posts directory. Go ahead and edit it and re-build the site to see your changes. You can rebuild the site in many different ways, but the most common way is to run jekyll serve, which launches a web server and auto-regenerates your site when a file is updated.

Jekyll requires blog post files to be named according to the following format:

YEAR-MONTH-DAY-title.MARKUP

Where YEAR is a four-digit number, MONTH and DAY are both two-digit numbers, and MARKUP is the file extension representing the format used in the file. After that, include the necessary front matter. Take a look at the source for this post to get an idea about how it works.

Jekyll also offers powerful support for code snippets:

def print_hi(name)
  puts "Hi, #{name}"
end
print_hi('Tom')
#=> prints 'Hi, Tom' to STDOUT.

Check out the Jekyll docs for more info on how to get the most out of Jekyll. File all bugs/feature requests at Jekyll’s GitHub repo. If you have questions, you can ask them on Jekyll Talk.

Henry’s Site