sc_check-sections: - examples

Stutter

Stutter is a string utterer.

utterer: someone who expresses in language; someone who talks (especially someone who delivers a public speech or someone especially garrulous) (www.vocabulary.com)

Stutter takes a string definition and crafts as many different strings as it can. See the examples section below for inspiration.

Installing

Download

You can download the latest release build from the release page. The executable depends on the gmp library (needed by the Haskell runtime system), which is most likely already present on your system. If not, install it from your favorite package manager. For Ubuntu:

$ sudo apt-get install libgmp-dev

Make sure stutter is on your PATH.

Nix

If you have nix installed, you can install stutter with the following command:

$ nix-env -i stutter

Building

The recommended way is to build stutter with stack. Run the following command in the cloned repo:

$ stack build

You can then install it with

$ stack install

Contributing

There are several ways you can contribute:

• Complain: Just open an issue and let me know what could be improved.
• Share a use-case: You found a cool case? Great! open an issue or (even better) a PR with your issue added to the examples below.
• Support: Share stutter with your friends, you never know who might need it.
• Implement: All PRs are welcome.

Examples

Stutter can be used as a very simple echo clone:

$ stutter 'Hello, World!'
Hello, World!

But stutter also knows how to enumerate:

$ stutter 'foo|bar|baz'
foo
bar
baz

You can easily specify which parts you want to enumerate, and which parts should always be there:

$ stutter 'My name is (what\?|who\?|Slim Shady)'
My name is what?
My name is who?
My name is Slim Shady

Stutter can also enumerate file contents:

$ stutter 'foo|bar|baz' > test.txt
$ stutter '(@test.txt) -- stutter was here'
foo -- stutter was here
bar -- stutter was here
baz -- stutter was here

And read from stdin:

$ cat test.txt | stutter 'Check this out, paste: @-'
Check this out, paste: foo
Check this out, paste: bar
Check this out, paste: baz

Stutter also likes ranges:

$ stutter '[0-9a-f]'
0
1
2
3
4
5
6
7
8
9
a
b
c
d
e
f

Of course, it can all be used together:

$ stutter 'My name is (@test.txt) [a-c] (who\?|what\?|Slim Shady)'
My name is foo a who?
My name is foo a what?
My name is foo a Slim Shady
My name is foo b who?
My name is foo b what?
...
My name is baz c who?
My name is baz c what?
My name is baz c Slim Shady

Stutter can teach you binary:

$ stutter '(0b(0|1){#|5})|I know binary!'
0b00000
0b00001
0b00010
0b00011
0b00100
0b00101
...
0b11010
0b11011
0b11100
0b11101
0b11110
0b11111
I know binary!

Stutter can repeat a char:

$ stutter 'a{42}'
a
a
a
...
$ stutter 'a{42}' | wc -l
42

Release checklist

1. Make sure you're on (latest) master.

2. Bump the version in stutter.cabal: 0.MAJOR.MINOR.PATCH.

Given a version number MAJOR.MINOR.PATCH, increment the:

MAJOR version when you make incompatible API changes, MINOR version when you add functionality in a backwards-compatible manner, and PATCH version when you make backwards-compatible bug fixes.

1. Commit the updated stutter.cabal file with commit name Release v0.MAJOR.MINOR.PATCH.
2. Tag the commit with git tag v0.MAJOR.MINOR.PATCH.
3. Push with git push --follow-tags.
4. Run cabal sdist and cabal upload --publish ./dist/stutter... to upload stutter to hackage.