formidable/README.md

1.5 KiB

Formidable

Web-based - but terminal compatible ! - little form editor using JSONSchema models.

Terminal compatible ?

The generated web UI does not use Javascript and can be used with terminal browsers like w3m or lynx.

Install

Manually

Download the pre-compiled binaries from the releases page and copy them to the desired location.

Bash script

curl -sfL https://raw.githubusercontent.com/Bornholm/formidable/master/misc/script/install.sh | bash

It will download frmd to your current directory.

Script available environment variables

Name Description Default
FORMIDABLE_VERSION Formidable version to download latest
FORMIDABLE_DESTDIR Formidable destination directory .

URLs

Formidable uses URLs to define how to handle schemas/defaults/values.

For example, to edit a web available schema (in YAML), defaults from stdin (in JSON) and values from the local file system (in HCL):

echo '{}' | frmd \
    edit
    --schema https://example.com/my-schema.yml \
    --defaults stdin://local?format=json \
    --values file:///my/file/absolute/path.hcl

The ?format=<json|yaml|hcl> query variable allows to specify the file format when no file extension is available (for example when reading from stdin).

Licence

AGPL-3.0