Skip to content

kevans91/porch

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

porch

Porch is a program orchestration tool, inspired by expect(1) but scripted with lua. This utility allows scripted manipulation of programs for, e.g., testing or automation purposes. Orch drives spawn processes over a pts(4) pseudo-terminal, which allows for a broader range of interactions with a program under orchestration.

The authoritative source for this software is located at https://git.kevans.dev/kevans/porch, but it's additionally mirrored to GitHub for user-facing interactions. Pull requests and Issues are open on GitHub.

porch(1) strives to be portable. Currently supported platforms:

  • FreeBSD
  • OpenBSD
  • NetBSD
  • macOS
  • Linux (tested on Ubuntu only)

Notes for porting

We build on all of the above platforms. To build and actually use porch, one needs:

  • cmake
  • liblua + headers (porch(1) supports 5.2+)
  • a compiler
  • this source tree

CMake's built-in FindLua support will be used, but you may need to tweak the following variables for install:

  • LUA_MODLIBDIR (default: /usr/local/lib/lua/MAJOR.MINOR) - path to install lua shared library modules
  • LUA_MODSHAREDIR (default: /usr/local/share/lua/MAJOR.MINOR) - path to install lua .lua modules

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published