From e9ec4dc7d42d10390115ad47f7e64aa08a446cd4 Mon Sep 17 00:00:00 2001 From: makefu Date: Fri, 9 Dec 2011 21:29:51 +0100 Subject: //assets/README: initial commit --- assets/README | 41 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 assets/README (limited to 'assets') diff --git a/assets/README b/assets/README new file mode 100644 index 00000000..f1875194 --- /dev/null +++ b/assets/README @@ -0,0 +1,41 @@ +# Asset tools for krebs + +## Prereqs +Check out the current krebs-asset repo into //db + + git checkout root@db-host:/krebs.db.git db + +in //db/ is an append-only file known as 'truth'. it contains the assets and the history of these. +Every commit is atomic, every line needs to be committed after being produced. + +## Usage +### ass +bin/ass has the power to add entries to the //db/truth file in the correct manner. It has two modes, create mode and set mode. +Create mode produces new keys in the database, these database entries are unique. +Set mode can set attributes to an entry in the database + +Example: + ass create bob + ass set bob type + ass create bob-pc + ass set bob-pc owner bob + ass set bob-pc location bob\'s-home + +### asq (ass-quick) +asq is a wrapper around the core ass. It should be used for adding lots and lots of new entries to the truth. It evaluates Variables from your environment. + +Example: + export ASS_LOCATION=bob\'s-home + export ASS_OWNER=bob + asq c logitech-sidewinder-gamepad + asq c arduino-uno + asq s amount 3 + +asq will then actually generate the following: + ass create logitech-sidewinder-gamepad + ass set logitech-sidewinder-gamepad owner bob + ass set logitech-sidewinder-gamepad location bob\'s-home + ass create arduino-uno + ass set arduino-uno owner bob + ass set arduino-uno location bob\'s-home + ass set arduino-uno amount 3 -- cgit v1.2.3