https://github.com/bgotink/worker

A small C++ program allowing you to run other programs in batch mode
https://github.com/bgotink/worker

Last synced: about 1 month ago
JSON representation

A small C++ program allowing you to run other programs in batch mode

• Host: GitHub
• URL: https://github.com/bgotink/worker
• Owner: bgotink
• License: other
• Created: 2013-06-07T14:04:18.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2014-06-17T17:54:44.000Z (over 10 years ago)
• Last Synced: 2023-03-25T19:41:46.893Z (almost 2 years ago)
• Language: C++
• Size: 281 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
## Requirements

* compiler

    * a GCC compiler supporting C++11 ```std::thread```, ```std::mutex```, ```std::condition_variable``` and multiline strings

    * Clang v3.3 or higher

* the [boost](http://boost.org) regex, program_options and iostreams libraries

* make

To install the requirements on OS X using [homebrew](//github.com/mxcl/homebrew):

```

brew install make boost # clang is already available

```

## Building

run ```make```  

This has been tested on:

| Version | Operating System | Compiler | libboost |

| ------- | ---------------- | -------- | -------- |

| 0.4.0   | OS X 10.10         | Clang 3.5           | installed via brew  |

| 0.4.0   | OS X 10.9          | Clang 3.4           | installed via brew  |

| 0.3.0   | OS X 10.8 and 10.9 | GCC 4.9 and Clang 3.3/3.4 | installed via brew  |

| 0.3.0   | Ubuntu 12.04.2 LTS | GCC 4.8.1 and Clang | installed using APT |

## Running

```

Usage: bin/worker [options]   [argument ...]

Options:

  -h [ --help ]              produce this help message

  -v [ --verbose ]           run verbose, shows program output

  -q [ --quiet ]             run quiet, no program output

  -o [ --output ]            show program output

  -s [ --nooutput ]          do not show program output

  -n [ --nthreads ] arg (=8) the maximum number of threads to use

  --version                  print version info and exit

Placeholders:

  You can use {} or {i} with i a non-negative integer to refer

  to placeholders:

    - ls {}

    - cat {1} {0}

  BASH-style replacements are supported (note: NOT a regular expression):

    - cat {} > {0/e/o}      # replace the first 'e' with 'o'

    - cat {} > {0//e/o}     # replace all 'e' with 'o'

    - cat {} > {0/%e/o}     # replace the final character

                            # with 'o' if it is 'e'

Notes:

  The default number of threads differs depending on your system, it is the same

  as the number of cores as returned by running

    sysctl hw.ncpu

Example usage:

  The current directory contains story1, story1.part2, story2 and story2.part2.

  Running the following command will result in the files *.part2 being appended

  to the other files and being removed:

    bin/worker -o 'cat {} >> {} && rm {0}' '*.part2' 'story{1,2}'

  The current directory contains story1.part1, story1.part2, story2.part1 and

  story2.part2. To create files story1 and story2 containing the entire stories:

    bin/worker -o 'cat {} {0/%1/2} > {0/%.part1/}' \*.part1

  The current directory contains some png's you want to open using `xdg-open`,

  however, xdg-open doesn't support multiple arguments:

    bin/worker 'xdg-open {}' '*.png'

  If there's only one placeholder and it is located at the end of the command,

  you can just leave it out:

    bin/worker xdg-open '*.png'

  If there's only one placeholder, all other arguments will be seen as

  replacements:

    bin/worker xdg-open *.png

  Note that this is equivalent to using 'find', except for the multi-threading.

    find . -maxdepth 1 -name \*.png -exec xdg-open '{}' \;

```

Run ```bin/worker``` to get a usage statement adapted for your system.  

## License

This program is released under a modified MIT license. For the license, see LICENSE.md.