zD Builder ze Bill: cut 'n paste by version

[ screenshot  | downloads ] mini HOW-TO: Introduction zD Builder is a PHP CLI (command line) executable that parses data (from a file or standard input) for target token pairs and updates (or reverts) that pair token data by version. tokens are categorised by a tag name, author and version, which can be shortlisted by filters for application to the data stream. in a nutshell, if you have a set of text/data which is common amoungst many files; you can then move that data into the zDB library, put a pair of tokens in its place and use zD Builder to cut 'n paste (update token data) for you... zD Builder can be useful for a few things (that fit the bill), however its primary use will probably be for developers who need to constantly update modifications (which also apply to other main executables in the same enviroment or SDK).Using zD Builder can help modulise top level main code which never gets encapsulated into a library. An inherit pro (or con) of this is that it can also help manage forks or code branches. Requirements a PHP CLI enviroment installed, setup and a reason. There is a *nix shell script to help loading the main zD Builder executable (which may need some tweaking on custom PHP installs). There is _no_ batch file for winblowz - which is actually what my last copy did, hence no batch file *KaBlaAMm* :p Install zD Builder Unpack and run! oh, just make sure the tag 'n bagged modifications that you want to apply are actually in the loaded library first. There is a template.inc and test.inc tag library file and configuration file included to check out after unpacking and before running. Example Usage -U -A -f php://stdin Upgrade All tags from standard input $ cat /path/to/file_with_tokens.txt | zD_builder.sh -UA > /path/to/new/file_with_tokens.txt -U -A -F folder_name Upgrade All tags recursively in directory $ zD_builder.sh -UAF /path/to/token/files/ -U -A -f file_name Upgrade All tags in file $ zD_builder.sh -UA /path/to/files_with_tokens.txt -U -t tag_name -f php://stdin Upgrade specific tags from standard input $ cat /path/to/file_with_tokens.txt | zD_builder.sh -U tag_name > /path/to/new/file_with_tokens.txt $ $ cat /path/to/file_with_tokens.txt | zD_builder.sh -U tag1,tag2,tag3 > /path/to/new/file_with_tokens.txt -U -t tag_name -f file_name Upgrade specific tags in file $ zD_builder.sh -U tag1,tag2 file_with_tokens.txt $ $ zD_builder.sh -Ut tag1,tag2 file_with_tokens.txt $ $ zD_builder.sh -Uf file_with_tokens.txt tag1,tag2 Development zD Builder has no dependancy or conflict resolution (so far zDB has more general application without it), if someone wants to get carried away with that (or anything else) please let me know. man zDB: ZD_BUILDER(1) NAME zD_builder.sh, zD_builder.exec.php - replace tag token with tag data matching filters SYNOPSIS zD_builder [OPTIONS] [TAG] [FILE | -F DIRECTORY ] DESCRIPTION zD Builder searches the named input FILEs (or standard input if no files are named) for tag TOKENs containing a match to the given token or token supplied by the configuration file. zD Builder will replace the DATA inside the tokens with the data supplied by the library. By default, zD Builder has verbosity set to level 1. OPTIONS -V, --version zD Builder version -v NUM, --verbose set the level of verbosity (default, --verbose=1) -q, --quiet ignore verbose output -h, --help display this help digest -f PARSE_FILE, --file=PARSE_FILE for tag replacement -F PARSE_FOLDER, --folder=PARSE_FOLDER recursively for tag replacement -t TAG1[,..,TAG2], --tag=TAG1[,..,TAG2] single/list name(s) for tag replacement FILTER OPTIONS -i VERSION, --insert-version=VERSION filter of tag for replacement -a DISTRO, --only-author=DISTRO filter of tag for replacement -u, --unlock-author ignores author/distro of parsed tag -l, --lock-author dummy flag, parse tag author respective to replacement tag (default) TAG OPTIONS -U, --upgrade current tag version stored in library -A, --all-tags upgrade/insert ALL tag names in library on parsed file by filter ZD BUILDER OPTIONS -c CONF_FILE, --config=CONF_FILE use specific zD Builder config file -I INC1[,..,INC2,], --tag-include=INC1[,..,INC2] single/list file(s) for tag library -L LIBRARY_PATH, --tag-path=LIBRARY_PATH library search path for relative tag paths -T TOKEN_DELIM, --tag-token=TOKEN_DELIM tag token delimiter TAGS //|# TOKEN_DELIM:TAG_NAME:TAG_AUTHOR //|# TOKEN_DELIM:TAG_NAME:TAG_AUTHOR:TAG_VERSION nb: synonyms TOKEN TOKEN_DELIM TAG_NAME TAG[1..X] TAG_AUTHOR DISTRO TAG_VERSION VERSION FILTERS Tags loaded from library (via config) can be short listed via its parts, currently its name, version author and vesion number. By default zD Builder will not replace a tag found in the parse stream (eg. file or STDIN) from the loaded tag library unless the authors match. Unlocking the author match will apply any tag of the same name as the tag in the parse stream. Warning, if you unlock the author match and supply a tag list, then the last tag in the list will clobber any previous short listed tags. Tag versions are set by a mask in the tag library, this usually is the latest stable or latest version of the tag (or even reverted revision). By default zD Builder will use this mask as a filter when short listing tags from the library (unless specified at runtime). DIAGNOSTICS Normally, exit status is 0 if zD Builder made any actual tag replacements or not. exit status of STRING will be presented in (kind of) human readable error messages and not return 0. BUGS Email bug reports to dan _at_ pedemont.net. Be sure to include the word 'zD Builder' somewhere in the 'Subject:' field. Verbosity will increase the exponent. Having a big tag library will also increase time and space used, you can try the --tag or -I option if this becomes an issue. There is slight optimization when using the --quiet flag. There is currently no tag dependency or conflict resolution, although there is some place holders for minor conflict resolution for later development. zDumpster Project 2008/01/19

2<