numbers-parser

numbers-parser is a Python module for parsing Apple Numbers.numbers files. It supports Numbers files generated by Numbers version 10.3, and up with the latest tested version being 14.1 (current as of June 2024).

It supports and is tested against Python versions from 3.9 onwards. It is not compatible with earlier versions of Python.

Getting started

Start with these documents to get you up and running:

• Quick Start
  • Cell Data
  • Pandas Support
  • Writing Numbers Documents
  • Styles
  • Cell Data Formatting
  • Borders
• Installation
• Command-line scripts
  • cat-numbers
  • csv2numbers
    • Deleting columns
    • Renaming columns
    • Date columns
    • Transforming columns
• Limitations

API Reference

• Document Class
  • Document
• Sheet Class
  • Sheet
• Table Class
  • Table
• Cell Classes
  • Cell
  • MergedCell
  • RichTextCell
• Date/time Formatting
• Style Class
  • Style
  • BackgroundImage
• Border Class
  • Border
• Cell Reference Functions
  • xl_cell_to_rowcol()
  • xl_range()
  • xl_rowcol_to_cell()
  • xl_col_to_name()
• Enumerations
  • NegativeNumberStyle
  • FractionAccuracy
  • PaddingType
• Development
  • Numbers File Formats
  • Credits
• Changes in version 4.0

License

All code in this repository is licensed under the MIT License.