eddie: Command line file filtering with haskell

[ bsd3, cli-tool, program ] [ Propose Tags ]

A tool to let you use short haskell expressions to filter files at the command line.


[Skip to Readme]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 0.1, 0.2, 0.5, 0.5.1, 1.0.0
Dependencies base (>=4.2.0 && <5), bifunctors (>=4.2), classy-prelude (>=0.12), hint (>=0.3.3.2), optparse-applicative (>=0.11), safe (>=0.3.8) [details]
License BSD-3-Clause
Copyright (c) 2014 Mike Meyer
Author Mike Meyer
Maintainer mwm@mired.org
Category CLI tool
Home page http://chiselapp.com/user/mwm/repository/eddie/
Source repo head: fossil clone https://chiselapp.com/user/mwm/repository/eddie/ eddie.fossil
this: fossil clone https://chiselapp.com/user/mwm/repository/eddie/ eddie.fossil
Uploaded by MikeMeyer at 2015-05-27T21:26:37Z
Distributions
Reverse Dependencies 1 direct, 0 indirect [details]
Executables eddie
Downloads 3951 total (9 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs not available [build log]
Last success reported on 2015-11-12 [all 7 reports]

Readme for eddie-1.0.0

[back to package description]

What is eddie?

A command line tool for running Haskell functions over text files.

It is also useful for prototyping Haskell text processing functions that you will later copy into a program.

Why is eddie?

This project actually started in response to a code bounty for a clojure shell scripting tool. That resulted in a specification for the requested program that had all the features of eddie, and then some. However, clojure code embedded on the command line looks clumsy, so the project was shelved.

In haskell, functional expression are much simpler and more elegant. In particular, in looking for haskell command line tools, I found http://www.haskell.org/haskellwiki/Simple_unix_tools, which convinced me that the original design would be not merely usable, but elegant if the expressions were done in haskell. Hence, eddie.

Why not ghc -e?

Eddie adds features to make using it for shell scripting easier:

  • When given file arguments, eddie feeds them to your function.
  • Eddie can easily add modules to the namespace you use.
  • Eddie has options for processing things a line or file at a time.
  • Eddie uses either Text or ByteStrings by default, not lists of characters.

More information

The best place to start is the manual. That's available in the source tree in both man format in eddie.1, and in html in eddie.html. The latter is also available online.

Installation

Install or build with cabal as usual.

Testing

Testing is done with the haskell shelltestrunner package (which can be installed with cabal). Run shelltest tests in the source directory to run the tests with the currently installed eddie. Use shelltest tests -w eddie.hs to run them using the current source. Use shelltest tests -w dist/build/eddie/eddie to run them with the compiled binary.

Documentation

The documenation is built with pandoc from eddie.md. Use the -s flag, and convert from pandoc's markdown to your chosen format.