Metadata-Version: 2.1
Name: iamstew-excel-parser
Version: 0.0.1
Summary: This is module helps to parse xls and xlsx files
Home-page: https://github.com/iamstew/excel-parser
Author: iamstew
Author-email: kakylya_ija@bk.ru
Project-URL: GitHub, https://github.com/iamstew/excel-parser
Keywords: xls xlsx excel parser
Classifier: Programming Language :: Python :: 3.11
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.11.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: et-xmlfile >=1.1.0
Requires-Dist: openpyxl >=3.1.2
Requires-Dist: xlrd >=2.0.1

# Библиотека `iamstew-excel-parser`

### Что она делает?
Библиотека открывает xls/xlsx файл по ссылке, и возвращает двумерный массива со значениями ячеек.

### Быстрый гайд
```python
from iamstew_excel_parser import XlsxParser # если вам нужно парсить xlsx файл
from iamstew_excel_parser import XlsParser # если вам нужно парсить xls файл

...

path = "/your/absolute/path/to/excel/file"
excel_parser.open_book(file_path=path)
result = excel_parser.parse_sheet(
    sheet_name=sheet_name, # передаем название листа книги, если не указан, будет парсить 1 лист книги
    row_start=row_start, # передаем номер строки с которой начинать парсинг, если не указан, то начнется с 1 строки
    columns_letters=columns_letters # передаем массив со строковыми буквами колонок, например ["a","b","ac"]
)
```

```python
print(result)
# пример выходных данных
{ "Название листа": [
    ["Имя", "Фамилия", "Отчество"],
    ["Иван", "Иванов", "Иванович"],
    ["Петр", "Петров", "Петрович"],
    ["Алексей", "Алексеев", "Алексеевич"]
  ]
}

# если ячейка пустая - возвращает None
[
    ["Иван", "Иванов", None]
]
```
