https://github.com/tamc/excel_to_code

Roughly translate some Excel spreadsheets to Ruby or C.
https://github.com/tamc/excel_to_code

c excel ruby spreadsheet

Last synced: 11 days ago
JSON representation

Roughly translate some Excel spreadsheets to Ruby or C.

• Host: GitHub
• URL: https://github.com/tamc/excel_to_code
• Owner: tamc
• License: mit
• Created: 2012-01-04T19:54:44.000Z (almost 13 years ago)
• Default Branch: master
• Last Pushed: 2023-11-22T15:01:37.000Z (12 months ago)
• Last Synced: 2024-10-28T23:11:56.952Z (14 days ago)
• Topics: c, excel, ruby, spreadsheet
• Language: Ruby
• Homepage:
• Size: 14.4 MB
• Stars: 227
• Watchers: 16
• Forks: 30
• Open Issues: 10
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGES.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# Excel to Code

[![Tests Passing](https://travis-ci.org/tamc/excel_to_code.svg?branch=master)](https://travis-ci.org/tamc/excel_to_code)

excel_to_c - roughly translate some Excel files into C.

excel_to_ruby - roughly translate some Excel files into Ruby.

This allows spreadsheets to be:

1. Embedded in other programs, such as web servers, or optimisers

2. Without depending on any Microsoft code

For example, running [these commands](examples/simple/compile.sh) turns [this spreadsheet](examples/simple/simple.xlsx) into [this Ruby code](examples/simple/ruby/simple.rb) or [this C code](examples/simple/c/simple.c).

# Install

Requires Ruby. Install by:

    gem install excel_to_code

# Run

To just have a go:

	excel_to_c 

This will produce a file called excelspreadsheet.c

For a more complex spreadsheet:

	

	excel_to_c --compile --run-tests --settable  --prune-except   

	

See the full list of options:

	excel_to_c --help

# Gotchas, limitations and bugs

0. No custom functions, no macros for generating results

1. Results are cached. So you must call reset(), then set values, then read values.

2. It must be possible to replace INDIRECT and OFFSET formula with standard references at compile time (e.g., INDIRECT("A"&"1") is fine, INDIRECT(userInput&"3") is not.

3. Doesn't implement all functions. [See which functions are implemented](docs/Which_functions_are_implemented.md).

4. Doesn't implement references that involve range unions and lists (but does implement standard ranges)

5. Sometimes gives cells as being empty, when excel would give the cell as having a numeric value of zero

6. The generated C version does not multithread and will give bad results if you try.

7. The generated code uses floating point, rather than fully precise arithmetic, so results can differ slightly.

8. The generated code uses the sprintf approach to rounding (even-odd) rather than excel's 0.5 rounds away from zero.

9. Ranges like this: Sheet1!A10:Sheet1!B20 and 3D ranges don't work.

Report bugs: 

# Changelog

See [Changes](CHANGES.md).

# License

See [License](LICENSE.md)

# Hacking

Source code: 

Documentation:

* [Installing from source](docs/installing_from_source.md)

* [Structure of this project](docs/structure_of_this_project.md)

* [How does the calculation work](docs/how_does_the_calculation_work.md)

* [How to fix parsing errors](docs/How_to_fix_parsing_errors.md)

* [How to implement a new Excel function](docs/How_to_add_a_missing_function.md)

Some notes on how Excel works under the hood:

* [The Excel file structure](docs/implementation/excel_file_structure.md)

* [Relationships](docs/implementation/relationships.md)

* [Workbooks](docs/implementation/workbook.md)

* [Worksheets](docs/implementation/worksheets.md)

* [Cells](docs/implementation/cell.md)

* [Tables](docs/implementation/tables.md)

* [Shared Strings](docs/implementation/shared_strings.md)

* [Array formulae](docs/implementation/array_formulae.md)