Aerijo

Guide to your first Tree-sitter grammar

NOTE: The Tree-sitter API and documentation has changed and improved since this guide was created. I can't guarantee this is up to date.

About

Tree-sitter is the new way Atom is providing language recognition features, such as syntax highlighting, code folding, autocomplete, and more. In contrast to TextMate grammars, which work by regex matching, Tree-sitter will generate an entire syntax tree. But more on that can be found in it's own docs.

Here, we look at making one from scratch.

Aerijo

A guide to writing a language grammar (TextMate) in Atom

Tree sitter

• Atom is transitioning to an entirely new way of defining grammars using tree-sitter. This will be enabled by default quite soon now. It is theoretically faster and more powerful than regex based grammars (the one described in this guide), but requires a steeper learning curve. My understanding is that regex based grammars will still be supported however (at least until version 2), so this guide can still be useful. To enable it yourself, go to Settings -> Core and check Use Tree Sitter Parsers

Links for tree-sitter help:

• tree-sitter: the main repo
• tree-sitter-cli: converts a JavaScript grammar to the required C/C++ files
• node-tree-sitter: module to use Tree-sitter parsers in NodeJS
• [My guide on starting a Tree-sitter grammar

dbtek

# venv_wrapper, manage all virtual environments under ~/.venv/
# Include the following in .bashrc / .bash_profile / .zshrc
# See https://gist.github.com/dbtek/fb2ddccb18f0cf63a654ea2cc94c8f19
#
# Usage:
# $ mkvenv myvirtualenv   # creates venv under ~/.venv/
# $ venv myvirtualenv     # activates venv
# $ deactivate            # deactivates venv
# $ rmvenv myvirtualenv   # removes venv
# $ rmvenv env1 env2      # removes multiple venvs