pegase 0.1.0

cli to generate secret tree files from templates
Documentation

PEGASE

PleasE Generate A Secret Easily

cli to generate secret tree files from templates

Usage

pegase <template.yaml>

Template format

The input template is a YAML file with a top-level files list. Each entry must include:

  • path: the target output file path
  • content: a secret generation tree

Example template:

files:
  - path: "aa"
    content:
      my_key:
        generator: pass
        charset: hex
        at_least_bits: 128
      my_hosts:
        host_a: pass
        host_b: pass

generates

my_hosts:
  host_a: d7KR5hrh6NVVnL4CqrrKtiFtWsEPGi99jt89p6SK
  host_b: rHKj8Ve3CbsJFQRL3P67p1kbOtZWS731qA8f1APW
my_key: 2384A66C4BF4E379DB5469BC16E5947A

Supported generators

Generator can have long or short form

Short form:

my_key: pass

Long form:

my_key:
  generator: pass
  charset: hex
  length: 32

(generator is a reserved keyword)

pass

Generates a password-like secret string.

Configuration options:

  • length: fixed output length
  • at_least_bits: minimum entropy in bits
  • charset: one of:
    • num
    • hex
    • alnum
    • rfc3986
    • alnumspec
    • custom: a string containing unique characters