AwGo — A Go library for Alfred workflows

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

Features

• Easy access to Alfred configuration, such as data and cache directories.
• Fluent API for generating Alfred JSON feedback for Script Filters.
• Support for all applicable Alfred features up to v3.5.
• Fuzzy sorting/filtering of results.
• Simple, but powerful, 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.
• Pre-configured logging for easier debugging, with a rotated log file.
• "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"

// Your workflow starts here
func run() {
    // Add a "Script Filter" result
    aw.NewItem("First result!")
    // Send results to Alfred
    aw.SendFeedback()
}

func main() {
    // Wrap your entry point with Run() to catch and log panics and
    // show an error in Alfred instead of silently dying
    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.