id       = "pow"
name     = "Pow"
homepage = "https://github.com/basecamp/pow"
# The project's own repository description.
description = "Zero-configuration Rack server for Mac OS X"
# `pow` is the executable in the project's own bin/ directory, and the name
# MANUAL.md tells you to look for: "Find the `pow` process in the process
# listing, select it, and click the Quit Process button."
executables   = ["pow"]
# Pow installs a launchd agent and rewrites /etc/resolver, and its own README
# calls it a Rack server for Mac OS X. Archived by Basecamp, so the entry
# describes where an existing install keeps its settings rather than a product
# still shipping.
platforms = ["macos"]

[dotfiles]

# MANUAL.md in the project's own repository
# (https://github.com/basecamp/pow/blob/master/MANUAL.md):
#
#   "When Pow boots, it executes the `.powconfig` script in your home
#    directory if it's present. You can use this script to export environment
#    variables that will override Pow's default settings."
#
# with `export POW_TIMEOUT=300` / `export POW_WORKERS=3` as its example, and
# POW_DOMAINS documented in the "Configuring Top-Level Domains" section. It is
# a shell script Pow sources at boot, so it is the one file worth carrying.
paths = ["~/.powconfig"]

exclude = []

# A handful of POW_* exports. No account, no credential.
secret = []

# ~/.pow, the other thing Pow keeps in the home directory, is deliberately not
# in `paths`: the same manual says "To set up a Rack app, just symlink it into
# ~/.pow", so its entries are symlinks into wherever that machine checked the
# application out — one machine's directory layout, not settings — and
# ~/.pow/restart.txt is a touch-file signal.
#
# No machine_lines: the POW_* variables in .powconfig are ports, worker counts
# and the TLD list, which the user wants the same on every Mac. A path would be
# machine-local, but Pow's settings do not include one.