AwGo — A Go library for Alfred workflows

Full-featured library to build lightning-fast workflows in a jiffy.

Features

• Easy access to Alfred context, such as data and cache directories.
• Straightforward generation of Alfred JSON feedback.
• Support for all applicable Alfred features up to v3.5.
• Fuzzy sorting/filtering.
• Simple API for caching/saving workflow data.
• Catches panics, logs stack trace and shows user an error message.
• Workflow updates API with built-in support for GitHub releases.
• Built-in logging for easier debugging.
• "Magic" queries/actions for simplified development and user support.
• macOS system icons.

Installation & usage

Install AwGo with:

go get -u github.com/deanishe/awgo

Typically, you'd call your program's main entry point via Run(). This way, the library will rescue any panic, log the stack trace and show an error message to the user in Alfred.

program.go:

package main

// Package is called aw
import "github.com/deanishe/awgo"

func run() {
    // Your workflow starts here
    aw.NewItem("First result!")
    aw.SendFeedback()
}

func main() {
    aw.Run(run)
}

In the Script Filter's Script box (Language = /bin/bash with input as argv):

./program "$1"

Documentation

Read the docs on GoDoc.

Check out the example workflows (docs), which show how to use AwGo. Use one as a template to get your own workflow up and running quickly.

Running/testing

The library, and therefore the unit tests, rely on being run in an Alfred-like environment, as they pull configuration options from environment variables (which are set by Alfred).

As such, you must source the env.sh script in the project root or run unit tests via the run-tests.sh script (which sources env.sh then calls go test).

Licensing & thanks

This library is released under the MIT licence.

The icon is based on the Go Gopher by Renee French.