Metadata-Version: 2.1
Name: robocorp-excel
Version: 0.4.2
Summary: Robocorp Excel automation library
Home-page: https://github.com/robocorp/robocorp/
License: Apache-2.0
Author: Fabio Z.
Author-email: fabio@robocorp.com
Requires-Python: >=3.9,<4.0
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: openpyxl (>=3.0.9,<4.0.0)
Requires-Dist: pillow (>=9.1.1,<11.0.0)
Requires-Dist: typing-extensions (>=4.5.0,<5.0.0)
Requires-Dist: xlrd (>=2.0.1,<3.0.0)
Requires-Dist: xlutils (>=2.0.0,<3.0.0)
Requires-Dist: xlwt (>=1.3.0,<2.0.0)
Project-URL: Repository, https://github.com/robocorp/robocorp/
Description-Content-Type: text/markdown

# robocorp-excel

This library provides a simple way to deal with both legacy `.xls` files
and newer `.xlsx` files directly. It can be used to read and edit them
directly without having Microsoft Excel installed.

> 👉 `robocorp-excel` is not yet production ready. 
> We work in semver and consider versions below 1.0.0 as development phase releases, you can use them but to get to v1 we need to get the 
> feature support and testing to a level where we feel comfortable recommending production usage.

## Getting started

```python
from robocorp import excel
from robocorp.tasks import task

@task
def inspect_workbook():
    workbook = excel.open_workbook("orders.xlsx")
    worksheet = workbook.worksheet("Sheet1")

    for row in worksheet.as_table(header=True):
    	print(row)
```

Further user guides and tutorials can be found in [Robocorp Docs](https://robocorp.com/docs).

## API Reference

Information on specific functions or classes: [robocorp.excel](https://github.com/robocorp/robocorp/blob/master/excel/docs/api/robocorp.excel.md)

## Changelog

A list of releases and corresponding changes can be found in the
[changelog](https://github.com/robocorp/robocorp/blob/master/excel/docs/CHANGELOG.md).

