https://github.com/leifg/excellent

Excel Parser written in Elixir (currently only Excel 2000)
https://github.com/leifg/excellent

Last synced: 3 months ago
JSON representation

Excel Parser written in Elixir (currently only Excel 2000)

• Host: GitHub
• URL: https://github.com/leifg/excellent
• Owner: leifg
• License: apache-2.0
• Created: 2015-08-29T01:04:55.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2019-01-08T14:00:43.000Z (about 6 years ago)
• Last Synced: 2024-10-11T03:11:12.377Z (3 months ago)
• Language: Elixir
• Homepage:
• Size: 51.8 KB
• Stars: 23
• Watchers: 4
• Forks: 4
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• freaking_awesome_elixir - Elixir - An OpenXL (Excel 2000) Parser for Elixir. (Office)
• fucking-awesome-elixir - excellent - An OpenXL (Excel 2000) Parser for Elixir. (Office)
• awesome-elixir - excellent - An OpenXL (Excel 2000) Parser for Elixir. (Office)

README

        
# Excellent 

[![Build Status](https://travis-ci.org/leifg/excellent.svg?branch=master)](https://travis-ci.org/leifg/excellent)

[![Coverage Status](https://coveralls.io/repos/leifg/excellent/badge.png?branch=master)](https://coveralls.io/r/leifg/excellent?branch=master)

[![hex.pm version](https://img.shields.io/hexpm/v/excellent.svg?style=flat)](https://hex.pm/packages/excellent)

**DISCLAIMER:** Completely abandoned. No further development will take place.

If you're looking for an xlxs parsing library, consider using [xlsxir](https://github.com/jsonkenl/xlsxir)

This is a library for parsing `.xlsx` files (Open XML format). It is targeted for reading Excel 2000 files into a list of lists.

Sample output:

```elixir

[

  ["A1", "B1", "C1", "D1"],

  ["A2", "B2", "C2", "D2"],

  ["A3", "B3", "C3", "D3"],

  ["A4", "B4", "C4", "D4"],

  ["A5", "B5", "C5", "D5"],

]

```

## Installation

You can add Excellent as a dependency in your `mix.exs` file. Since it only requires Elixir and Erlang there are no other dependencies.

```elixir

def deps do

  [ { :excellent, "~> 0.0.1" } ]

end

```

If you aren't using hex, add the a reference to the github repo.

``` elixir

def deps do

  [ { :excellent, github: "leifg/excellent" } ]

end

```

Then run `mix deps.get` in the shell to fetch and compile the dependencies

## Usage

The top level funtion takes 2 arguments: the filename and the number of the worksheet you want to parse (zero based).

```elixir

Excellent.parse('spreadsheet.xlsx', 0)

=> [

  ["A1", "B1", "C1", "D1"],

  ["A2", "B2", "C2", "D2"],

  ["A3", "B3", "C3", "D3"],

  ["A4", "B4", "C4", "D4"],

  ["A5", "B5", "C5", "D5"],

]

```

There is also a function to return the names of the worksheets as a tuple:

```elixir

Excellent.worksheet_names('spreadsheet.xlsx')

=> {"Worksheet 1", "Worksheet 2"}

```

## TODO

  - Read worksheets as stream from ZIP archive

  - Implement different data types (curently only strings and numbers are supported)