{"id":14065226,"url":"https://github.com/thombashi/excelrd","last_synced_at":"2025-05-07T08:31:21.353Z","repository":{"id":57427480,"uuid":"231866981","full_name":"thombashi/excelrd","owner":"thombashi","description":"excelrd is a modified version of xlrd to work for the latest Python versions.","archived":false,"fork":false,"pushed_at":"2023-07-08T06:59:03.000Z","size":4220,"stargazers_count":8,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-27T07:35:58.872Z","etag":null,"topics":["excel","excel-reader","python-library","xlrd"],"latest_commit_sha":null,"homepage":"https://excelrd.rtfd.io/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thombashi.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2020-01-05T04:27:13.000Z","updated_at":"2025-04-07T14:26:21.000Z","dependencies_parsed_at":"2022-09-19T06:40:22.761Z","dependency_job_id":null,"html_url":"https://github.com/thombashi/excelrd","commit_stats":{"total_commits":523,"total_committers":50,"mean_commits":10.46,"dds":0.7609942638623327,"last_synced_commit":"376feefc8833825cee3a776be88dde00e14076fa"},"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thombashi%2Fexcelrd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thombashi%2Fexcelrd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thombashi%2Fexcelrd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thombashi%2Fexcelrd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thombashi","download_url":"https://codeload.github.com/thombashi/excelrd/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252842370,"owners_count":21812656,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["excel","excel-reader","python-library","xlrd"],"created_at":"2024-08-13T07:04:22.641Z","updated_at":"2025-05-07T08:31:21.322Z","avatar_url":"https://github.com/thombashi.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":".. contents:: **excelrd**\n   :backlinks: top\n   :depth: 2\n\n.. image:: https://badge.fury.io/py/excelrd.svg\n    :target: https://badge.fury.io/py/excelrd\n    :alt: PyPI package version\n\n.. image:: https://img.shields.io/pypi/pyversions/excelrd.svg\n    :target: https://pypi.org/project/excelrd\n    :alt: Supported Python versions\n\n.. image:: https://img.shields.io/pypi/implementation/excelrd.svg\n    :target: https://pypi.org/project/excelrd\n    :alt: Supported Python implementations\n\n.. image:: https://github.com/thombashi/excelrd/actions/workflows/ci.yml/badge.svg\n    :target: https://github.com/thombashi/excelrd/actions/workflows/ci.yml\n    :alt: CI status of Linux/macOS/Windows\n\n.. image:: https://coveralls.io/repos/github/thombashi/excelrd/badge.svg?branch=master\n    :target: https://coveralls.io/github/thombashi/excelrd?branch=master\n    :alt: Test coverage\n\nexcelrd\n==================\n``excelrd`` is a modified version of `xlrd \u003chttp://www.python-excel.org/\u003e`__ to work for the latest Python versions.\n``xlrd`` will not work in Python 3.9 or newer versions.\n\n**Purpose**: Provide a library for developers to use to extract data from Microsoft Excel (tm) spreadsheet files. It is not an end-user tool.\n\n**Author**: John Machin\n\n**Licence**: BSD-style (see licences.py)\n\n**Versions of Python supported**: 3.5+.\n\n**Outside scope**: excelrd will safely and reliably ignore any of these\nif present in the file:\n\n-  Charts, Macros, Pictures, any other embedded object. WARNING:\n   currently this includes embedded worksheets.\n-  VBA modules\n-  Formulas (results of formula calculations are extracted, of course).\n-  Comments\n-  Hyperlinks\n-  Autofilters, advanced filters, pivot tables, conditional formatting,\n   data validation\n-  Handling password-protected (encrypted) files.\n\n\nInstallation\n============================================\n::\n\n    pip install excelrd\n\n\nQuick start\n==================\nPrint all of the cell values in a specific sheet:\n\n:Sample Code:\n    .. code:: python\n\n        import excelrd\n\n\n        def main():\n            book = excelrd.open_workbook(\"namesdemo.xls\")\n\n            print(\"The number of worksheets is {}\".format(book.nsheets))\n            print(\"Worksheet name(s): {}\".format(\", \".join(book.sheet_names())))\n\n            sh = book.sheet_by_index(2)\n            print(\"{}: rows={}, cols={}\".format(sh.name, sh.nrows, sh.ncols))\n\n            for row_idx in range(sh.nrows):\n                for col_idx in range(sh.ncols):\n                    cell = sh.cell(row_idx, col_idx)\n\n                    if not cell.value:\n                        continue\n\n                    print(\"row={}, col={}, value={}\".format(row_idx, col_idx, cell.value))\n\nTransition from xlrd to excelrd\n------------------------------------\nReplace the import from ``import xlrd`` to ``import excelrd``:\n\n.. code:: python\n\n    import excelrd as xlrd\n\n\nAnother quick start\n------------------------------------\nThis will show the first, second and last rows\nof each sheet in each file:\n\n::\n\n    python PYDIR/scripts/runxlrd.py 3rows *blah*.xls\n\n\nAcknowledgements\n====================================\n-  This package started life as a translation from C into Python of\n   parts of a utility called \"xlreader\" developed by David Giffin. \"This\n   product includes software developed by David Giffin\n   david@giffin.org.\"\n-  OpenOffice.org has truly excellent documentation of the Microsoft\n   Excel file formats and Compound Document file format, authored by\n   Daniel Rentz. See http://sc.openoffice.org\n-  U+5F20 U+654F: over a decade of inspiration, support, and interesting\n   decoding opportunities.\n-  Ksenia Marasanova: sample Macintosh and non-Latin1 files, alpha\n   testing\n-  Backporting to Python 2.1 was partially funded by Journyx - provider\n   of timesheet and project accounting solutions (http://journyx.com/).\n-  Provision of formatting information in version 0.6.1 was funded by\n   Simplistix Ltd (http://www.simplistix.co.uk/)\n\n\nDocumentation\n==================\nhttps://excelrd.rtfd.io/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthombashi%2Fexcelrd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthombashi%2Fexcelrd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthombashi%2Fexcelrd/lists"}