xls-0.1.2: README.md

## Haskell xls Parsing

`xls` is a Haskell library to parse Microsoft Excel spreadsheet files. It
parses the xls file format (extension `.xls`) more specifically known as
`BIFF/Excel 97-2004`.

It can be useful for mining data from old Microsoft Excel spreadsheets.

## API
Use `decodeXls` to get a streaming Conduit. For example to convert an
xls file to comma separated csv:

```haskell
xlsToCSV :: String -> IO ()
xlsToCSV file =
      runResourceT
    $ decodeXls file
    $$ CL.mapM_ (liftIO . putStrLn . intercalate ",")
```

An `xls2csv` utility is shipped with the package.
See the haddock documentation for API details.

## Under the hood
The library is based on the C library 
[libxls](https://github.com/libxls/libxls).

## See Also

* [xlsior](https://hackage.haskell.org/package/xlsior): Streaming Excel (xslx) file generation and parsing
* [xlsx](https://hackage.haskell.org/package/xlsx): Excel xslx file parser/writer

## Contributing
Welcome! If you would like to have something changed or added go ahead,
raise an issue or send a pull request.