File : README.md
Maintainer : Felix C. Stegerman <[email protected]>
Date : 2014-03-03
Copyright : Copyright (C) 2014 Felix C. Stegerman
Version : v0.4.1
Description
eftcmdr - yaml + ruby + whiptail
EftCmdr is a yaml dsl that wraps whiptail [1] to display dialog
boxes. It provides a yaml dsl on top of eft [2]. See examples/
for examples.
ask: ask_name
text: What is your name?
then:
eval: eval_hello
code: |
puts "Hello, #{ctx[:ask_name]}!"
$ eftcmdr examples/hello.yml
SSH
You can use eftcmdr-ssh-setup to generate a
~/.ssh/authorized_keys from ~/.eftcmdr.d/*.{pub,yml} (see
examples/). This allows you to use eftcmdr to provide a menu
over ssh -t that allows selected users to perform selected
actions.
NB: be careful what you allow -- access to e.g. rails console
or less makes it trivial to get complete shell access.
You may need to load e.g. ~/.profile (e.g. when eftcmdr is not
in the default $PATH). To make this easier, you can pass a third
argument to eftcmdr-ssh-setup (or set $EFTCMDR_SSH_COMMAND) to
choose the command to be put in the authorized_keys file. You can
use e.g. $( which eftcmdr-ssh-wrapper ) to wrap eftcmdr in a
shell script that sources ~/.eftcmdr_env (which can e.g. be a
symlink to ~/.profile).
Links
→ blog post (with pictures!)
→ more complicated example yml file
Specs & Docs
$ rake spec # TODO
$ rake docs
TODO
- gauge?
- options?
- specs! (how to automate tests of whiptail? - I don't know!)
License
LGPLv3+ [3].
References
[1] Newt (and whiptail) --- http://en.wikipedia.org/wiki/Newt_(programming_library)
[2] eft --- https://github.com/obfusk/eft
[3] GNU Lesser General Public License, version 3 --- http://www.gnu.org/licenses/lgpl-3.0.html