Skip to main content

Library for developers to extract data from Microsoft Excel (tm) .xls spreadsheet files

Project description

Build Status Coverage Status Documentation PyPI version

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

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:

pip install xlrd
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:

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

xlrd-2.0.2.tar.gz (100.2 kB view details)

Uploaded Source

Built Distribution

xlrd-2.0.2-py2.py3-none-any.whl (96.6 kB view details)

Uploaded Python 2Python 3

File details

Details for the file xlrd-2.0.2.tar.gz.

File metadata

  • Download URL: xlrd-2.0.2.tar.gz
  • Upload date:
  • Size: 100.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.9

File hashes

Hashes for xlrd-2.0.2.tar.gz
Algorithm Hash digest
SHA256 08b5e25de58f21ce71dc7db3b3b8106c1fa776f3024c54e45b45b374e89234c9
MD5 8afbdf48d53472530471a66e0978752d
BLAKE2b-256 075a377161c2d3538d1990d7af382c79f3b2372e880b65de21b01b1a2b78691e

See more details on using hashes here.

File details

Details for the file xlrd-2.0.2-py2.py3-none-any.whl.

File metadata

  • Download URL: xlrd-2.0.2-py2.py3-none-any.whl
  • Upload date:
  • Size: 96.6 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.9.9

File hashes

Hashes for xlrd-2.0.2-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 ea762c3d29f4cca48d82df517b6d89fbce4db3107f9d78713e48cd321d5c9aa9
MD5 9c7c92b37169d2d6df5b84fe3e48c771
BLAKE2b-256 1a62c8d562e7766786ba6587d09c5a8ba9f718ed3fa8af7f4553e8f91c36f302

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page