gelisam/hawk


Haskell text processor for the command-line

License: Apache-2.0

Language: Haskell


Hawk Hackage

Transform text from the command-line using Haskell expressions. Similar to awk, but using Haskell as the text-processing language.

Examples

In Unix the file /etc/passwd is used to keep track of every registered user in the system. Each entry in the file contains information about a single user, using a simple colon-separated format. For example:

root:x:0:0:root:/root:/bin/bash

The first field is the username. We can use Hawk to list all usernames as follows:

> cat /etc/passwd | hawk -d: -m 'head'
root

The -d option tells Hawk to use : as field delimiters, causing the first line to be interpreted as ["root", "x", "0", "0", "root", "/root", "/bin/bash"]. The -m tells Hawk to map a function over each line of the input. In this case, the function head extracts the first field of the line, which happens to be the username.

We could of course have achieved identical results by using awk instead of Hawk:

> cat /etc/passwd | awk -F: '{print $1}'
root

While Hawk and awk have similar use cases, the philosophy behind the two is very different. Awk uses a specialized language designed to concisely express many text transformations, while Hawk uses the general-purpose language Haskell, which is also known for being concise, among other things. There are many standard command-line tools that can be easily approximated using short Haskell expressions.

Another important difference is that while awk one-liners are self-contained, Hawk encourages the use of libraries and user-defined functions. By adding function definitions, module imports and language pragmas to Hawk's user-configurable prelude file, those functions, libraries and language extensions become available to Hawk one-liners. For instance, we could add a takeLast function extracting the last n elements from a list, and use it to (inefficiently) approximate tail:

> echo 'takeLast n = reverse . take n . reverse' >> ~/.hawk/prelude.hs
> seq 0 100 | hawk -a 'takeLast 3'
98
99
100

For more details, see the presentation and the documentation.

Installation

To install the stable version, simply use cabal install haskell-awk (not cabal install hawk, that's another unrelated package) and add ~/.cabal/bin (or your sandbox's bin folder) to your PATH. You should be ready to use Hawk:

> hawk '[1..3]'
1
2
3

To install the development version, clone this repository and use cabal install to compile Hawk and its dependencies. The first run will create a default configuration file into ~/.hawk/prelude.hs if it doesn't exist.

Build Status

Project Statistics

Sourcerank 7
Repository Size 713 KB
Stars 227
Forks 16
Watchers 14
Open issues 64
Dependencies 0
Contributors 10
Tags 6
Created
Last updated
Last pushed

Top Contributors See all

Samuel Gélineau Mario Pastorelli John Chee ssadler Ron catull Jens Petersen Iris Ward Ryan Max Treskin

Recent Tags See all

1.1.2 May 21, 2016
1.1.1 July 05, 2015
1.1 May 30, 2014
1.0 January 07, 2014
1.0rc2 January 05, 2014
1.0rc1 September 02, 2013

Something wrong with this page? Make a suggestion

Last synced: 2017-10-07 17:37:22 UTC

Login to resync this repository