pyproject.toml

[build-system]
requires = ['setuptools']
build-backend = 'setuptools.build_meta'

[project]
name = 'pyvista'
description = 'Easier Pythonic interface to VTK'
authors = [
    {name = 'PyVista Developers', email = 'info@pyvista.org'},
]
readme = 'README.rst'
requires-python = '>=3.8'
keywords = ['vtk', 'numpy', 'plotting', 'mesh']
license = {text = 'MIT'}
classifiers = [
    'Development Status :: 5 - Production/Stable',
    'Intended Audience :: Science/Research',
    'Topic :: Scientific/Engineering :: Information Analysis',
    'License :: OSI Approved :: MIT License',
    'Operating System :: Microsoft :: Windows',
    'Operating System :: POSIX',
    'Operating System :: MacOS',
    'Programming Language :: Python :: 3.8',
    'Programming Language :: Python :: 3.9',
    'Programming Language :: Python :: 3.10',
    'Programming Language :: Python :: 3.11',
]
dependencies = [
    'matplotlib>=3.0.1',
    'numpy',
    'pillow',
    'pooch',
    'scooby>=0.5.1',
    'vtk',  # keep without version constraints
]
dynamic = ['version']

[project.optional-dependencies]
all = ['pyvista[colormaps,io,jupyter,trame]']
colormaps = [
    'cmocean',
    'colorcet',
]
io = [
    'imageio',
    'meshio>=5.2'
]
jupyter = [
    'ipywidgets',
    'jupyter-server-proxy',
    'nest_asyncio',
    'trame>=2.5.2',
    'trame-client>=2.10.0',
    'trame-server>=2.11.7',
    'trame-vtk>=2.5.8',
    'trame-vuetify>=2.3.1',
]

[project.urls]
Documentation = 'https://docs.pyvista.org/'
"Bug Tracker" = 'https://github.com/pyvista/pyvista/issues'
"Source Code" = 'https://github.com/pyvista/pyvista'

[tool.setuptools.dynamic]
version = {attr = 'pyvista._version.__version__'}

[tool.setuptools.packages.find]
include = [
    'pyvista',
    'pyvista.*',
]

[tool.setuptools.package-data]
pyvista = [
    'py.typed',
]
"pyvista.examples" = [
    '2k_earth_daymap.jpg',
    'airplane.ply',
    'ant.ply',
    'channels.vti',
    'globe.vtk',
    'hexbeam.vtk',
    'nut.ply',
    'rectilinear.vtk',
    'sphere.ply',
    'uniform.vtk',
]

[tool.isort]
profile = 'black'
line_length = 100
# Sort by name, don't cluster "from" vs "import"
force_sort_within_sections = true
# Combines "as" imports on the same line
combine_as_imports = true

[tool.black]
line-length = 100
skip-string-normalization = true
target-version = ['py39']
exclude='\.eggs|\.git|\.mypy_cache|\.tox|\.venv|_build|buck-out|build|dist|node_modules'

[tool.blackdoc]
# From https://numpydoc.readthedocs.io/en/latest/format.html
# Extended discussion: https://github.com/pyvista/pyvista/pull/4129
# The length of docstring lines should be kept to 75 characters to facilitate
# reading the docstrings in text terminals.
line-length = 75

[tool.build_sphinx]
source-dir = 'doc'
build-dir  = './doc/_build'
all_files  = 1

[tool.upload_sphinx]
upload-dir = 'doc/_build/html'

[tool.pydocstyle]
match = '(?!coverage).*.py'
convention = "numpy"
add-ignore = ["D404"]

[tool.codespell]
skip = '*.pyc,*.txt,*.gif,*.png,*.jpg,*.ply,*.vtk,*.vti,*.vtu,*.js,*.html,*.doctree,*.ttf,*.woff,*.woff2,*.eot,*.mp4,*.inv,*.pickle,*.ipynb,flycheck*,./.git/*,./.hypothesis/*,*.yml,doc/_build/*,./doc/images/*,./dist/*,*~,.hypothesis*,./doc/examples/*,*.mypy_cache/*,*cover,./tests/tinypages/_build/*,*/_autosummary/*'
ignore-words = "doc/styles/Vocab/pyvista/accept.txt"
quiet-level = 3

[tool.coverage.run]
omit = [
    'pyvista/ext/coverage.py',
    'pyvista/conftest.py',
    # kept for backwards compatibility:
    'pyvista/plotting/theme.py',
]

[tool.pytest.ini_options]
junit_family='legacy'
filterwarnings = [
    'ignore::FutureWarning',
    'ignore::PendingDeprecationWarning',
    'ignore::DeprecationWarning',
    # bogus numpy ABI warning (see numpy/#432)
    'ignore:.*numpy.dtype size changed.*:RuntimeWarning',
    'ignore:.*numpy.ufunc size changed.*:RuntimeWarning',
    'ignore:.*Given trait value dtype "float64":UserWarning',
    'ignore:.*The NumPy module was reloaded*:UserWarning',
    'error::pyvista.PyVistaDeprecationWarning'
]
doctest_optionflags = 'NUMBER ELLIPSIS'
testpaths = 'tests'
markers = [
    'needs_vtk_version(version): skip test unless VTK version is at least as specified.',
    'needs_download: this test downloads data during execution',
]
image_cache_dir = "tests/plotting/image_cache"

[tool.mypy]
ignore_missing_imports = true

[tool.numpydoc_validation]
checks = [
    "all",  # all but the following:
    "GL01",  # Contradicts numpydoc examples
    "GL02",  # Permit a blank line after the end of our docstring
    "GL03",  # Considering enforcing
    "GL09",  # Deprecation warning should precede extended summary (check broken)
    "SA01",  # Not all docstrings need a see also
    "SA04",  # See also section does not need descriptions
    "SS05",  # Appears to be broken.
    "ES01",  # Not all docstrings need an extend summary.
    "EX01",  # Examples: Will eventually enforce
    "YD01",  # Yields: No plan to enforce
]

exclude = [  # don't report on objects that match any of these regex
    '\.BasePlotter$',  # Issue with class parameter documentation
    '\.Plotter$',  # Issue with class parameter documentation
    '\.WidgetHelper$',
    '\.PickingHelper$',
    '\.from_dict$',
    '\.to_dict$',
    '\.__init__$',
    '\.__new__$',
    '\.__getattr__$',
    '\.keys$',
    '\.values$',
    '\.items$',
    '\._.*$',  # Ignore anything that's private (e.g., starts with _)
    # parm of abstract classes
    '\._BaseMapper$',
    '\.CompositeFilters$',
    '\.DataObject$',
    '\.DataSet$',
    '\.DataSetFilters$',
    '\.ExplicitStructuredGrid$',
    '\.Grid$',
    '\.MultiBlock$',
    '\.PointGrid$',
    '\.PointSet$',
    '\.PolyDataFilters$',
    '\.RectilinearGrid$',
    '\.StructuredGrid$',
    '\.Table$',
    '\.Table\.save$',
    '\.ImageData$',
    '\.ImageDataFilters$',
    '\.UnstructuredGrid$',
    '\.UnstructuredGridFilters$',
    # classes inherit from BaseReader
    '\.*Reader(\.|$)',
    # internal
    '\.Renderer$',
    # deprecated
    '\.boolean_add$',
    '\.boolean_cut$',
    '\.add_field_array$',
    '\.DataSetAttributes\.append$',
    # will be removed or refactored
    '^pv_pythreejs\..*$',
    '^pv_ipygany\..*$',
    '^notebook\..*$',
    # Documentation extensions or utilities
    '^viewer_directive\..*$',
    '^plot_directive\..*$',
    '^coverage\..*$',
    '\.pv_html_page_context$',
    # Internal
    '^observers\..*$',
    # methods we probably should make private
    '\.store_click_position$',
    '\.store_mouse_position$',
    '\.fly_to_mouse_position$',
    '\.key_press_event$',
    '\.left_button_down$',
    # MISC
    '\.ActiveArrayInfo$',
    '\.CellType$',
    '\.DataObject\.copy_meta_from$',
    '\.FieldAssociation$',
    '\.InterpolationType$',
    '\.RepresentationType$',
    '\.ElementType$',
    '\.MultiBlock\.copy_meta_from$',
    # wraps
    '\.Plotter\.enable_depth_peeling$',
    '\.add_scalar_bar$',
    # called from inherited
    '\.Table\.copy_meta_from$',
    # Type alias
    '\.ColorLike$',
    '\.Chart$',
    # PointSet *args and **kwargs for wrapped parameters
    '\.PointSet(\.|$)',
    # Mixin methods from collections.abc
    '\.MultiBlock\.clear$',
    '\.MultiBlock\.count$',
    '\.MultiBlock\.index$',
    '\.MultiBlock\.remove$',
    # Enumerations
    '\.Plot3DFunctionEnum$',
    # VTK methods
    '\.override$',
    # trame
    '\.Viewer(\.|$)',
    '\.PyVistaRemoteView(\.|$)',
    '\.PyVistaLocalView(\.|$)',
    '\.PyVistaRemoteLocalView(\.|$)',
    '\.Texture(\.|$)',  # awaiting Texture refactor
]