What is Factor.io?
Factor.io a Ruby-based DSL for defining and running workflows connecting popular developer tools and services. It is designed to run from the command line, run locally without other service dependencies, very easily extensible, and workflow definitions are stored in files so they can be checked into your project repos. Workflows can run tasks on various tools and services (e.g. create a Github issue, post to Slack, make a HTTP POST call), and they can listen for events too (e.g. listen for a pattern in Slack, open a web hook, or listen for a git push on a branch in Github). Lastly, it supports great concurrency control so you can run many tasks in parallel and aggregate the results.
Install and Setup
This is a gem with a command line interface
factor. To install:
gem install factor
First, we need to install the dependencies (via Bundler).
source "https://rubygems.org" # Using code from Github for latest (as opposed to RubyGems). gem 'factor', git: 'https://github.com/factor-io/factor.git' gem 'factor-connector-web', git: 'https://github.com/factor-io/connector-web.git'
In a new project directory create a new file
workflow.rb like this:
require 'factor-connector-web' web_hook = run 'web::hook' web_hook.on(:trigger) do |post_info| if post_info[:configured] success 'Configured and listening on...' success post_info[:configured][:url] else info post_info end end web_hook.on(:log) do |log_info| debug log_info[:message] end web_hook.execute web_hook.wait
Now run this from the command line:
bundle install bundle exec factor w workflow.rb
- Workflow Syntax: Factor.io workflows can do all sorts of magic, like running in parallel, aggregating command results, defining sequences, error handling, and more.
- Connectors: These are the officially support Connectors (integrations).
- Custom Connectors: A guide for creating a custom Connector.
- More examples: This repo contains a library of examples that demonstrate all the Factor.io workflow syntax capabilities as well as the officially supported Conenctors.