xlrd


Namexlrd JSON
Version 2.0.1 PyPI version JSON
download
home_pagehttp://www.python-excel.org/
SummaryLibrary for developers to extract data from Microsoft Excel (tm) .xls spreadsheet files
upload_time2020-12-11 10:14:22
maintainer
docs_urlNone
authorChris Withers
requires_python>=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*
licenseBSD
keywords xls excel spreadsheet workbook
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            xlrd
====

|Build Status|_ |Coverage Status|_ |Documentation|_ |PyPI version|_

.. |Build Status| image:: https://circleci.com/gh/python-excel/xlrd/tree/master.svg?style=shield
.. _Build Status: https://circleci.com/gh/python-excel/xlrd/tree/master

.. |Coverage Status| image:: https://codecov.io/gh/python-excel/xlrd/branch/master/graph/badge.svg?token=lNSqwBBbvk
.. _Coverage Status: https://codecov.io/gh/python-excel/xlrd

.. |Documentation| image:: https://readthedocs.org/projects/xlrd/badge/?version=latest
.. _Documentation: http://xlrd.readthedocs.io/en/latest/?badge=latest

.. |PyPI version| image:: https://badge.fury.io/py/xlrd.svg
.. _PyPI version: https://badge.fury.io/py/xlrd


xlrd is a library for reading data and formatting information from Excel
files in the historical ``.xls`` format.

.. warning::

  This library will no longer read anything other than ``.xls`` files. For
  alternatives that read newer file formats, please see http://www.python-excel.org/.

The following are also not supported but will safely and reliably be ignored:

*   Charts, Macros, Pictures, any other embedded object, **including** embedded worksheets.
*   VBA modules
*   Formulas, but results of formula calculations are extracted.
*   Comments
*   Hyperlinks
*   Autofilters, advanced filters, pivot tables, conditional formatting, data validation

Password-protected files are not supported and cannot be read by this library.

Quick start:

.. code-block:: python

    import xlrd
    book = xlrd.open_workbook("myfile.xls")
    print("The number of worksheets is {0}".format(book.nsheets))
    print("Worksheet name(s): {0}".format(book.sheet_names()))
    sh = book.sheet_by_index(0)
    print("{0} {1} {2}".format(sh.name, sh.nrows, sh.ncols))
    print("Cell D30 is {0}".format(sh.cell_value(rowx=29, colx=3)))
    for rx in range(sh.nrows):
        print(sh.row(rx))

From the command line, this will show the first, second and last rows of each sheet in each file:

.. code-block:: bash

    python PYDIR/scripts/runxlrd.py 3rows *blah*.xls



            

Raw data

            {
    "_id": null,
    "home_page": "http://www.python-excel.org/",
    "name": "xlrd",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*",
    "maintainer_email": "",
    "keywords": "xls,excel,spreadsheet,workbook",
    "author": "Chris Withers",
    "author_email": "chris@withers.org",
    "download_url": "https://files.pythonhosted.org/packages/a6/b3/19a2540d21dea5f908304375bd43f5ed7a4c28a370dc9122c565423e6b44/xlrd-2.0.1.tar.gz",
    "platform": "",
    "description": "xlrd\n====\n\n|Build Status|_ |Coverage Status|_ |Documentation|_ |PyPI version|_\n\n.. |Build Status| image:: https://circleci.com/gh/python-excel/xlrd/tree/master.svg?style=shield\n.. _Build Status: https://circleci.com/gh/python-excel/xlrd/tree/master\n\n.. |Coverage Status| image:: https://codecov.io/gh/python-excel/xlrd/branch/master/graph/badge.svg?token=lNSqwBBbvk\n.. _Coverage Status: https://codecov.io/gh/python-excel/xlrd\n\n.. |Documentation| image:: https://readthedocs.org/projects/xlrd/badge/?version=latest\n.. _Documentation: http://xlrd.readthedocs.io/en/latest/?badge=latest\n\n.. |PyPI version| image:: https://badge.fury.io/py/xlrd.svg\n.. _PyPI version: https://badge.fury.io/py/xlrd\n\n\nxlrd is a library for reading data and formatting information from Excel\nfiles in the historical ``.xls`` format.\n\n.. warning::\n\n  This library will no longer read anything other than ``.xls`` files. For\n  alternatives that read newer file formats, please see http://www.python-excel.org/.\n\nThe following are also not supported but will safely and reliably be ignored:\n\n*   Charts, Macros, Pictures, any other embedded object, **including** embedded worksheets.\n*   VBA modules\n*   Formulas, but results of formula calculations are extracted.\n*   Comments\n*   Hyperlinks\n*   Autofilters, advanced filters, pivot tables, conditional formatting, data validation\n\nPassword-protected files are not supported and cannot be read by this library.\n\nQuick start:\n\n.. code-block:: python\n\n    import xlrd\n    book = xlrd.open_workbook(\"myfile.xls\")\n    print(\"The number of worksheets is {0}\".format(book.nsheets))\n    print(\"Worksheet name(s): {0}\".format(book.sheet_names()))\n    sh = book.sheet_by_index(0)\n    print(\"{0} {1} {2}\".format(sh.name, sh.nrows, sh.ncols))\n    print(\"Cell D30 is {0}\".format(sh.cell_value(rowx=29, colx=3)))\n    for rx in range(sh.nrows):\n        print(sh.row(rx))\n\nFrom the command line, this will show the first, second and last rows of each sheet in each file:\n\n.. code-block:: bash\n\n    python PYDIR/scripts/runxlrd.py 3rows *blah*.xls\n\n\n",
    "bugtrack_url": null,
    "license": "BSD",
    "summary": "Library for developers to extract data from Microsoft Excel (tm) .xls spreadsheet files",
    "version": "2.0.1",
    "split_keywords": [
        "xls",
        "excel",
        "spreadsheet",
        "workbook"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "5396ec15eeb7e38a5e73e25451ff7a9e",
                "sha256": "6a33ee89877bd9abc1158129f6e94be74e2679636b8a205b43b85206c3f0bbdd"
            },
            "downloads": -1,
            "filename": "xlrd-2.0.1-py2.py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "5396ec15eeb7e38a5e73e25451ff7a9e",
            "packagetype": "bdist_wheel",
            "python_version": "py2.py3",
            "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*",
            "size": 96531,
            "upload_time": "2020-12-11T10:14:20",
            "upload_time_iso_8601": "2020-12-11T10:14:20.877979Z",
            "url": "https://files.pythonhosted.org/packages/a6/0c/c2a72d51fe56e08a08acc85d13013558a2d793028ae7385448a6ccdfae64/xlrd-2.0.1-py2.py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "ae3f951c857a490d432f0a7d722352bf",
                "sha256": "f72f148f54442c6b056bf931dbc34f986fd0c3b0b6b5a58d013c9aef274d0c88"
            },
            "downloads": -1,
            "filename": "xlrd-2.0.1.tar.gz",
            "has_sig": false,
            "md5_digest": "ae3f951c857a490d432f0a7d722352bf",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*",
            "size": 100259,
            "upload_time": "2020-12-11T10:14:22",
            "upload_time_iso_8601": "2020-12-11T10:14:22.201974Z",
            "url": "https://files.pythonhosted.org/packages/a6/b3/19a2540d21dea5f908304375bd43f5ed7a4c28a370dc9122c565423e6b44/xlrd-2.0.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2020-12-11 10:14:22",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "lcname": "xlrd"
}
        
Elapsed time: 0.02476s