# Библиотека `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]
]
```
Raw data
{
"_id": null,
"home_page": "https://github.com/iamstew/excel-parser",
"name": "iamstew-excel-parser",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.11.6",
"maintainer_email": "",
"keywords": "xls xlsx excel parser",
"author": "iamstew",
"author_email": "kakylya_ija@bk.ru",
"download_url": "https://files.pythonhosted.org/packages/f6/af/e7e17213f8b3dc53340621aefff715d68e1b3d4fb5eb71d3a3e15df82ba9/iamstew-excel-parser-0.0.3.tar.gz",
"platform": null,
"description": "# \u0411\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0430 `iamstew-excel-parser`\n\n### \u0427\u0442\u043e \u043e\u043d\u0430 \u0434\u0435\u043b\u0430\u0435\u0442?\n\u0411\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0430 \u043e\u0442\u043a\u0440\u044b\u0432\u0430\u0435\u0442 xls/xlsx \u0444\u0430\u0439\u043b \u043f\u043e \u0441\u0441\u044b\u043b\u043a\u0435, \u0438 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u0434\u0432\u0443\u043c\u0435\u0440\u043d\u044b\u0439 \u043c\u0430\u0441\u0441\u0438\u0432\u0430 \u0441\u043e \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u044f\u043c\u0438 \u044f\u0447\u0435\u0435\u043a.\n\n### \u0411\u044b\u0441\u0442\u0440\u044b\u0439 \u0433\u0430\u0439\u0434\n```python\nfrom iamstew_excel_parser import XlsxParser # \u0435\u0441\u043b\u0438 \u0432\u0430\u043c \u043d\u0443\u0436\u043d\u043e \u043f\u0430\u0440\u0441\u0438\u0442\u044c xlsx \u0444\u0430\u0439\u043b\nfrom iamstew_excel_parser import XlsParser # \u0435\u0441\u043b\u0438 \u0432\u0430\u043c \u043d\u0443\u0436\u043d\u043e \u043f\u0430\u0440\u0441\u0438\u0442\u044c xls \u0444\u0430\u0439\u043b\n\n...\n\npath = \"/your/absolute/path/to/excel/file\"\nexcel_parser.open_book(file_path=path)\nresult = excel_parser.parse_sheet(\n sheet_name=sheet_name, # \u043f\u0435\u0440\u0435\u0434\u0430\u0435\u043c \u043d\u0430\u0437\u0432\u0430\u043d\u0438\u0435 \u043b\u0438\u0441\u0442\u0430 \u043a\u043d\u0438\u0433\u0438, \u0435\u0441\u043b\u0438 \u043d\u0435 \u0443\u043a\u0430\u0437\u0430\u043d, \u0431\u0443\u0434\u0435\u0442 \u043f\u0430\u0440\u0441\u0438\u0442\u044c 1 \u043b\u0438\u0441\u0442 \u043a\u043d\u0438\u0433\u0438\n row_start=row_start, # \u043f\u0435\u0440\u0435\u0434\u0430\u0435\u043c \u043d\u043e\u043c\u0435\u0440 \u0441\u0442\u0440\u043e\u043a\u0438 \u0441 \u043a\u043e\u0442\u043e\u0440\u043e\u0439 \u043d\u0430\u0447\u0438\u043d\u0430\u0442\u044c \u043f\u0430\u0440\u0441\u0438\u043d\u0433, \u0435\u0441\u043b\u0438 \u043d\u0435 \u0443\u043a\u0430\u0437\u0430\u043d, \u0442\u043e \u043d\u0430\u0447\u043d\u0435\u0442\u0441\u044f \u0441 1 \u0441\u0442\u0440\u043e\u043a\u0438\n columns_letters=columns_letters # \u043f\u0435\u0440\u0435\u0434\u0430\u0435\u043c \u043c\u0430\u0441\u0441\u0438\u0432 \u0441\u043e \u0441\u0442\u0440\u043e\u043a\u043e\u0432\u044b\u043c\u0438 \u0431\u0443\u043a\u0432\u0430\u043c\u0438 \u043a\u043e\u043b\u043e\u043d\u043e\u043a, \u043d\u0430\u043f\u0440\u0438\u043c\u0435\u0440 [\"a\",\"b\",\"ac\"]\n)\n```\n\n```python\nprint(result)\n# \u043f\u0440\u0438\u043c\u0435\u0440 \u0432\u044b\u0445\u043e\u0434\u043d\u044b\u0445 \u0434\u0430\u043d\u043d\u044b\u0445\n{ \"\u041d\u0430\u0437\u0432\u0430\u043d\u0438\u0435 \u043b\u0438\u0441\u0442\u0430\": [\n [\"\u0418\u043c\u044f\", \"\u0424\u0430\u043c\u0438\u043b\u0438\u044f\", \"\u041e\u0442\u0447\u0435\u0441\u0442\u0432\u043e\"],\n [\"\u0418\u0432\u0430\u043d\", \"\u0418\u0432\u0430\u043d\u043e\u0432\", \"\u0418\u0432\u0430\u043d\u043e\u0432\u0438\u0447\"],\n [\"\u041f\u0435\u0442\u0440\", \"\u041f\u0435\u0442\u0440\u043e\u0432\", \"\u041f\u0435\u0442\u0440\u043e\u0432\u0438\u0447\"],\n [\"\u0410\u043b\u0435\u043a\u0441\u0435\u0439\", \"\u0410\u043b\u0435\u043a\u0441\u0435\u0435\u0432\", \"\u0410\u043b\u0435\u043a\u0441\u0435\u0435\u0432\u0438\u0447\"]\n ]\n}\n\n# \u0435\u0441\u043b\u0438 \u044f\u0447\u0435\u0439\u043a\u0430 \u043f\u0443\u0441\u0442\u0430\u044f - \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 None\n[\n [\"\u0418\u0432\u0430\u043d\", \"\u0418\u0432\u0430\u043d\u043e\u0432\", None]\n]\n```\n",
"bugtrack_url": null,
"license": "",
"summary": "This is module helps to parse xls and xlsx files",
"version": "0.0.3",
"project_urls": {
"GitHub": "https://github.com/iamstew/excel-parser",
"Homepage": "https://github.com/iamstew/excel-parser"
},
"split_keywords": [
"xls",
"xlsx",
"excel",
"parser"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c76e67fd1aab82d9ca4a546129380158896e40b41df1cbfcb65deb8890a9cdb6",
"md5": "831e2b56542c306566b5c58520522800",
"sha256": "c65eb7996618fd6bbde542c17b8aa777e954b86155802ffa4c54931b92913efd"
},
"downloads": -1,
"filename": "iamstew_excel_parser-0.0.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "831e2b56542c306566b5c58520522800",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11.6",
"size": 4456,
"upload_time": "2024-02-18T15:04:50",
"upload_time_iso_8601": "2024-02-18T15:04:50.786155Z",
"url": "https://files.pythonhosted.org/packages/c7/6e/67fd1aab82d9ca4a546129380158896e40b41df1cbfcb65deb8890a9cdb6/iamstew_excel_parser-0.0.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f6afe7e17213f8b3dc53340621aefff715d68e1b3d4fb5eb71d3a3e15df82ba9",
"md5": "f64036b6da30be2efa6eae8c5924f4cd",
"sha256": "42998d659fe13e9a6a42435e5b33f546a5987e541691e10eeab101bae7988f6e"
},
"downloads": -1,
"filename": "iamstew-excel-parser-0.0.3.tar.gz",
"has_sig": false,
"md5_digest": "f64036b6da30be2efa6eae8c5924f4cd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11.6",
"size": 3606,
"upload_time": "2024-02-18T15:04:52",
"upload_time_iso_8601": "2024-02-18T15:04:52.231065Z",
"url": "https://files.pythonhosted.org/packages/f6/af/e7e17213f8b3dc53340621aefff715d68e1b3d4fb5eb71d3a3e15df82ba9/iamstew-excel-parser-0.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-18 15:04:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "iamstew",
"github_project": "excel-parser",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "iamstew-excel-parser"
}
JSON
