setup.cfg

[metadata]
name = pandas
description = Powerful data structures for data analysis, time series, and statistics
long_description = file: README.md
long_description_content_type = text/markdown
url = https://pandas.pydata.org
author = The Pandas Development Team
author_email = pandas-dev@python.org
license = BSD-3-Clause
license_files = LICENSE
platforms = any
classifiers =
    Development Status :: 5 - Production/Stable
    Environment :: Console
    Intended Audience :: Science/Research
    License :: OSI Approved :: BSD License
    Operating System :: OS Independent
    Programming Language :: Cython
    Programming Language :: Python
    Programming Language :: Python :: 3
    Programming Language :: Python :: 3 :: Only
    Programming Language :: Python :: 3.8
    Programming Language :: Python :: 3.9
    Programming Language :: Python :: 3.10
    Programming Language :: Python :: 3.11
    Topic :: Scientific/Engineering
project_urls =
    Bug Tracker = https://github.com/pandas-dev/pandas/issues
    Documentation = https://pandas.pydata.org/pandas-docs/stable
    Source Code = https://github.com/pandas-dev/pandas

[options]
packages = find:
install_requires =
    numpy>=1.20.3; python_version<'3.10'
    numpy>=1.21.0; python_version>='3.10'
    numpy>=1.23.2; python_version>='3.11'
    python-dateutil>=2.8.2
    pytz>=2020.1
python_requires = >=3.8
include_package_data = True
zip_safe = False

[options.entry_points]
pandas_plotting_backends =
    matplotlib = pandas:plotting._matplotlib

[options.exclude_package_data]
* =
    *.c
    *.h

[options.extras_require]
test =
    hypothesis>=5.5.3
    pytest>=6.0
    pytest-xdist>=1.31
    pytest-asyncio>=0.17.0
# optional extras for recommended dependencies
# see: doc/source/getting_started/install.rst
performance =
    bottleneck>=1.3.2
    numba>=0.53.1
    numexpr>=2.7.1
timezone =
    tzdata>=2022.1
computation =
    scipy>=1.7.1
    xarray>=0.19.0
fss =
    fsspec>=2021.07.0
aws =
    s3fs>=2021.08.0
gcp =
    gcsfs>=2021.07.0
    pandas-gbq>=0.15.0
excel =
    odfpy>=1.4.1
    openpyxl>=3.0.7
    pyxlsb>=1.0.8
    xlrd>=2.0.1
    xlsxwriter>=1.4.3
parquet =
    pyarrow>=6.0.0
feather =
    pyarrow>=6.0.0
hdf5 =
    # blosc only available on conda (https://github.com/Blosc/python-blosc/issues/297)
    # blosc>=1.20.1
    tables>=3.6.1
spss =
    pyreadstat>=1.1.2
postgresql =
    SQLAlchemy>=1.4.16
    psycopg2>=2.8.6
mysql =
    SQLAlchemy>=1.4.16
    pymysql>=1.0.2
sql-other =
    SQLAlchemy>=1.4.16
html =
    beautifulsoup4>=4.9.3
    html5lib>=1.1
    lxml>=4.6.3
xml =
    lxml>=4.6.3
plot =
    matplotlib>=3.6.1
output_formatting =
    jinja2>=3.0.0
    tabulate>=0.8.9
clipboard=
    PyQt5>=5.15.1
    qtpy>=2.2.0
compression =
    brotlipy>=0.7.0
    python-snappy>=0.6.0
    zstandard>=0.15.2
# `all` supersets all the above options.
# Also adds the following redundant, superseded packages that are listed as supported:
#    fastparquet  (by pyarrow https://github.com/pandas-dev/pandas/issues/39164)
# `all ` should be kept as the complete set of pandas optional dependencies for general use.
all =
    beautifulsoup4>=4.9.3
    # blosc only available on conda (https://github.com/Blosc/python-blosc/issues/297)
    # blosc>=1.21.0
    bottleneck>=1.3.2
    brotlipy>=0.7.0
    fastparquet>=0.6.3
    fsspec>=2021.07.0
    gcsfs>=2021.07.0
    html5lib>=1.1
    hypothesis>=6.13.0
    jinja2>=3.0.0
    lxml>=4.6.3
    matplotlib>=3.6.1
    numba>=0.53.1
    numexpr>=2.7.3
    odfpy>=1.4.1
    openpyxl>=3.0.7
    pandas-gbq>=0.15.0
    psycopg2>=2.8.6
    pyarrow>=6.0.0
    pymysql>=1.0.2
    PyQt5>=5.15.1
    pyreadstat>=1.1.2
    pytest>=6.0
    pytest-xdist>=1.31
    pytest-asyncio>=0.17.0
    python-snappy>=0.6.0
    pyxlsb>=1.0.8
    qtpy>=2.2.0
    scipy>=1.7.1
    s3fs>=2021.08.0
    SQLAlchemy>=1.4.16
    tables>=3.6.1
    tabulate>=0.8.9
    tzdata>=2022.1
    xarray>=0.19.0
    xlrd>=2.0.1
    xlsxwriter>=1.4.3
    zstandard>=0.15.2

[build_ext]
inplace = True

[options.packages.find]
include = pandas, pandas.*

# See the docstring in versioneer.py for instructions. Note that you must
# re-run 'versioneer.py setup' after changing this section, and commit the
# resulting files.
[versioneer]
VCS = git
style = pep440
versionfile_source = pandas/_version.py
versionfile_build = pandas/_version.py
tag_prefix = v
parentdir_prefix = pandas-

[flake8]
max-line-length = 88
ignore =
    # space before : (needed for how black formats slicing)
    E203,
    # line break before binary operator
    W503,
    # line break after binary operator
    W504,
    # module level import not at top of file
    E402,
    # do not assign a lambda expression, use a def
    E731,
    # found modulo formatter (incorrect picks up mod operations)
    S001,
    # controversial
    B006,
    # controversial
    B007,
    # controversial
    B008,
    # setattr is used to side-step mypy
    B009,
    # getattr is used to side-step mypy
    B010,
    # tests use assert False
    B011,
    # tests use comparisons but not their returned value
    B015,
    # false positives
    B019,
    # Use of functools.lru_cache or functools.cache on methods can lead to memory leaks.
    B020
    # Loop control variable overrides iterable it iterates
    B023
    # Functions defined inside a loop must not use variables redefined in the loop
    B301,
    # single-letter variables
    PDF023,
    # "use 'pandas._testing' instead" in non-test code
    PDF025,
    # If test must be a simple comparison against sys.platform or sys.version_info
    Y002,
    # Use "_typeshed.Self" instead of class-bound TypeVar
    Y019,
    # Docstrings should not be included in stubs
    Y021,
    # Use typing_extensions.TypeAlias for type aliases
    Y026,
    # Use "collections.abc.*" instead of "typing.*" (PEP 585 syntax)
    Y027,
    # while int | float can be shortened to float, the former is more explicit
    Y041
exclude =
    doc/sphinxext/*.py,
    doc/build/*.py,
    doc/temp/*.py,
    .eggs/*.py,
    versioneer.py,
    # exclude asv benchmark environments from linting
    env
per-file-ignores =
    # private import across modules
    pandas/tests/*:PDF020
    # pytest.raises without match=
    pandas/tests/extension/*:PDF009
    # os.remove
    doc/make.py:PDF008
    # import from pandas._testing
    pandas/testing.py:PDF014
    # can't use fixtures in asv
    asv_bench/*:PDF016


[flake8-rst]
max-line-length = 84
bootstrap =
    import numpy as np
    import pandas as pd
    # avoiding error when importing again numpy or pandas
    np
    # (in some cases we want to do it to show users)
    pd
ignore =
    # space before : (needed for how black formats slicing)
    E203,
    # module level import not at top of file
    E402,
    # line break before binary operator
    W503,
    # Classes/functions in different blocks can generate those errors
    # expected 2 blank lines, found 0
    E302,
    # expected 2 blank lines after class or function definition, found 0
    E305,
    # We use semicolon at the end to avoid displaying plot objects
    # statement ends with a semicolon
    E703,
    # comparison to none should be 'if cond is none:'
    E711,
exclude =
    doc/source/development/contributing_docstring.rst,
    # work around issue of undefined variable warnings
    # https://github.com/pandas-dev/pandas/pull/38837#issuecomment-752884156
    doc/source/getting_started/comparison/includes/*.rst

[codespell]
ignore-words-list = blocs,coo,hist,nd,sav,ser,recuse
ignore-regex = https://([\w/\.])+

[coverage:run]
branch = True
omit =
    pandas/_typing.py
    pandas/_version.py
plugins = Cython.Coverage
source = pandas

[coverage:report]
ignore_errors = False
show_missing = True
omit =
    pandas/_version.py
# Regexes for lines to exclude from consideration
exclude_lines =
    # Have to re-enable the standard pragma
    pragma: no cover

    # Don't complain about missing debug-only code:
    def __repr__
    if self\.debug

    # Don't complain if tests don't hit defensive assertion code:
    raise AssertionError
    raise NotImplementedError
    AbstractMethodError

    # Don't complain if non-runnable code isn't run:
    if 0:
    if __name__ == .__main__.:
    if TYPE_CHECKING:

[coverage:html]
directory = coverage_html_report