New patches: [unrevert anon**20140321220020 Ignore-this: fa00ed090bb09eb1c32b677e2f5b3a6b ] move ./README ./README.md hunk ./README.md 1 +# cargs + + +## Synopsis + +Config file to args (Haskell) + + +## Description + +Turn a config file into a shell command, execute it with timestamped +logging. + + +## Example + +This config file: + +> # cargs sample config file +> # Here's the task that I wrote this program for: rsync backups +> +> # Program to run +> rsync +> +> # Switches for the program +> --archive +> --verbose +> #--relative +> --delete +> #--delete-excluded +> #--filter '. /path/to/filter/file' +> # Don't forget to comment the next one out! +> --dry-run +> +> # Non-switch arguments +> # src path +> / +> # Root dir for the backup destination +> /another/dir/cats/dogs +> # Can be someplace remote +> #ren@spumco.org:/foo/bar/backups +> +> # Anything extra, maybe for redirection? +> # We want rsync's stderr in the log too +> 2>&1 +> # Some other possibilities: +> #2>&1 | tee -a /var/tmp/bak-foo.log +> #2>&1 > /var/log/bak-foo.log + +Becomes this command: + +> rsync --archive --verbose --delete --dry-run / /another/dir/cats/dogs 2>&1 + + + +## Getting source + +Get the source with darcs: + +> $ darcs get http://ui3.info/darcs/epub-tools + +Or [browse the source](http://ui3.info/darcs/epub-tools) + +And then building the usual way: + +> $ cabal configure --enable-tests +> $ cabal build +> $ cabal test + + +## Installing + +epub-tools can be installed in several ways: + +- Build and install with cabal-install: + `$ cabal update ; cabal install epub-tools` +- Download the cabalized source package [from Hackage](http://hackage.haskell.org/cgi-bin/hackage-scripts/package/epub-tools) +- Download the cabalized source tarball [from here](http://ui3.info/d/proj/epub-tools/epub-tools-2.4.tar.gz) +- epub-tools is available for Arch Linux [from the AUR](https://aur.archlinux.org/packages/epub-tools/) +- Download [binaries for Windows](http://ui3.info/d/proj/epub-tools/epub-tools-2.4-win.zip) + + +## Contact + +Dino Morelli <[dino@ui3.info](mailto:dino@ui3.info)> Context: [Added a TODO item about fixing the usage with respect to the example files path Dino Morelli **20090510015854 Ignore-this: 42745ba27db6401a1a32abeb1c14ea16 ] [TAG 1.0.1 Dino Morelli **20090510005117 Ignore-this: 8dfcc2c38ed7ac998905c625a6eb8ff5 ] Patch bundle hash: c576d489d3df6d158deaf21f388ea034944069b8