pyproject.toml

[build-system]
requires = ["setuptools~=80.10.2", "wheel"]
build-backend = "setuptools.build_meta"

[project]
name = "nvda"
dynamic = ["version"]
description = "NonVisual Desktop Access (NVDA)"
maintainers = [
	{name = "NV Access", email = "info@nvaccess.org"},
]
requires-python = ">=3.13,<3.14"
classifiers = [
	"Development Status :: 5 - Production/Stable",
	"Intended Audience :: End Users/Desktop",
	"License :: OSI Approved :: GNU General Public License v2 or later (GPLv2+)",
	"Operating System :: Microsoft :: Windows",
	"Programming Language :: Python :: 3",
	"Topic :: Accessibility",
]
readme = "readme.md"
license = {file = "copying.txt"}
dependencies = [
	# NVDA's runtime dependencies
	"bleak==3.0.2",
	"comtypes==1.4.13",
	"cryptography==48.0.1",
	"pyserial==3.5",
	"wxPython==4.2.4",
	# pinned to a commit in tool.uv.sources
	"configobj",
	"requests==2.33.0",
	"url-normalize==2.2.1",
	"schedule==1.2.2",
	# NVDA_DMP requires diff-match-patch
	"fast-diff-match-patch==2.1.0",
	# pycaw is a Core Audio Windows Library used for sound split
	"pycaw==20251023",
	# NVDA bridge for 32 bit shim
	"rpyc==6.0.2",
	"pywin32==311",
	# Sanitize HTML for browsable messages and documentation output to prevent XSS from translators
	"nh3==0.3.2",
	# l10nUtil requires Crowdin
	"crowdin-api-client==1.24.1",
	# fuzzy search
	"fuzzysearch==0.8.1",
	# Building user documentation and the l10nUtil
	"Markdown==3.10",
	"lxml==6.1.1",
	"mdx_truly_sane_lists==1.3",
	"markdown-link-attr-modifier==0.2.1",
	"mdx-gh-links==0.4",
	"l2m4m==1.0.4",
	"pymdown-extensions==10.21.3",
	"pyphen==0.17.2",
	# secret scanning for logging
	"detect-secrets==1.5.0",
	"regex==2026.4.4",
]

[project.urls]
Homepage = "https://www.nvaccess.org/"
Repository = "https://github.com/nvaccess/nvda.git"
Issues = "https://github.com/nvaccess/nvda/issues"

[tool.ruff]
line-length = 110

builtins = [
	# translation lookup
	"_",
	# translation lookup
	"ngettext",
	# translation lookup
	"pgettext",
	# translation lookup
	"npgettext",
]

include = [
	"*.py",
	"*.pyw",
	"sconstruct",
	"*sconscript",
]

exclude = [
	".git",
	"__pycache__",
	".tox",
	"build",
	"output",
	".venv",
	# When excluding concrete paths relative to a directory,
	# not matching multiple folders by name e.g. `__pycache__`,
	# paths are relative to the configuration file.
	"./runtime-builders/synthDriverHost32/.venv",
	"./include/*",
	"./miscDeps",
	"./source/louis",
	# #10924: generated by third-party dependencies
	"./source/comInterfaces/*",
	# Code from add-ons
	"./source/userConfig/addons/*",
]

[tool.ruff.format]
indent-style = "tab"
line-ending = "lf"

[tool.ruff.lint.mccabe]
max-complexity = 15

[tool.ruff.lint]
ignore = [
	# indentation contains tabs
	"W191",
]
logger-objects = ["logHandler.log"]

[tool.ruff.lint.per-file-ignores]
# sconscripts contains many inbuilt functions not recognised by the lint,
# so ignore F821.
"sconstruct" = ["F821"]
"*sconscript" = ["F821"]

[tool.ruff.lint.flake8-tidy-imports.banned-api]
"winsound.PlaySound".msg= "PlaySound uses winmm, which is deprecated in favor of the Windows core audio APIs."

[tool.licensecheck]
only_licenses = ["BSD", "MIT", "Python", "LGPLV3+", "Apache"]
ignore_packages = [
	# Compatible licenses:
	"certifi",  # Mozilla Public License 2.0
	"Markdown",  # BSD-3-Clause, but not in PyPI correctly
	"markdown-link-attr-modifier",  # GPLV3 license, but not in PyPI correctly
	"pycaw",  # MIT license, but not in PyPI
	"wxPython",  # wxWindows Library License
]


[tool.pyright]
venvPath = ".venv"
venv = "."
pythonPlatform = "Windows"
typeCheckingMode = "strict"

include = [
	"**/*.py",
	"**/*.pyw",
]

exclude = [
	"sconstruct",
	"*sconscript",
	".git",
	"__pycache__",
	".tox",
	"build",
	"output",
	".venv",
	# When excluding concrete paths relative to a directory,
	# not matching multiple folders by name e.g. `__pycache__`,
	# paths are relative to the configuration file.
	"./runtime-builders/synthDriverHost32/.venv",
	"./include/*",
	"./miscDeps",
	"./source/louis",
	# #10924: generated by third-party dependencies
	"./source/comInterfaces/*",
	# Code from add-ons
	"./source/userConfig/addons/*",
]

# While exclude tells pyright not to scan files in the first instance,
# it will still analyse files included by other files.
ignore = [
	# We do not care about errors in our dependencies.
	".venv",
]

# Tell pyright where to load python code from
extraPaths = [
	"./source",
	# Used by system tests
	"./tests/system/libraries",
	# Used internally in NVDA
	"./miscDeps/python",
	"./include/nvda-mathcat/assets",
]

# General config
analyzeUnannotatedFunctions = true
deprecateTypingAliases = true

# Stricter typing
strictParameterNoneValue = true
strictListInference = true
strictDictionaryInference = true
strictSetInference = true

# Compliant rules
reportAssertAlwaysTrue = true
reportAssertTypeFailure = true
reportDuplicateImport = true
reportIncompleteStub = true
reportInconsistentOverload = true
reportInconsistentConstructor = true
reportInvalidStringEscapeSequence = true
reportInvalidStubStatement = true
reportInvalidTypeVarUse = true
reportMatchNotExhaustive = true
reportMissingModuleSource = true
reportMissingImports = true
reportNoOverloadImplementation = true
reportOptionalContextManager = true
reportOverlappingOverload = true
reportPrivateImportUsage = true
reportPropertyTypeMismatch = true
reportSelfClsParameterName = true
reportTypeCommentUsage = true
reportTypedDictNotRequiredAccess = true
reportUndefinedVariable = true
reportUnusedExpression = true
reportUnboundVariable = true
reportUnhashable = true
reportUnnecessaryCast = true
reportUnnecessaryContains = true
reportUnnecessaryTypeIgnoreComment = true
reportUntypedClassDecorator = true
reportUntypedFunctionDecorator = true
reportUnusedClass = true
reportUnusedCoroutine = true
reportUnusedExcept = true

# Should switch to true when possible
reportDeprecated = false  # 1834 errors

# Can be enabled by generating type stubs for modules via pyright CLI
reportMissingTypeStubs = false

# Bad rules
# These are roughly sorted by compliance to make it easier for devs to focus on enabling them.
# Errors were last checked Feb 2025.
# 1-50 errors
reportUnsupportedDunderAll = false  # 2 errors
reportAbstractUsage = false  # 3 errors
reportUntypedBaseClass = false  # 4 errors
reportOptionalIterable = false  # 5 errors
reportCallInDefaultInitializer = false  # 6 errors
reportInvalidTypeArguments = false  # 7 errors
reportUntypedNamedTuple = false  # 11 errors
reportRedeclaration = false  # 12 errors
reportOptionalCall = false  # 16 errors
reportConstantRedefinition = false  # 18 errors
reportWildcardImportFromLibrary = false  # 26 errors
reportIncompatibleVariableOverride = false  # 28 errors
reportInvalidTypeForm = false  # 38 errors


# 50-100 errors
reportGeneralTypeIssues = false  # 53 errors
reportOptionalOperand = false  # 59 errors
reportUnnecessaryComparison = false  # 67 errors
reportFunctionMemberAccess = false  # 80 errors
reportUnnecessaryIsInstance = false  # 88 errors
reportUnusedFunction = false  # 97 errors
reportImportCycles = false  # 99 errors
reportUnusedImport = false  # 113 errors
reportUnusedVariable = false  # 147 errors

# 100-1000 errors
reportOperatorIssue = false  # 102 errors
reportAssignmentType = false  # 103 errors
reportReturnType = false  # 104 errors
reportPossiblyUnboundVariable = false  # 126 errors
reportMissingSuperCall = false  # 159 errors
reportUninitializedInstanceVariable = false  # 179 errors
reportUnknownLambdaType = false  # 196 errors
reportMissingTypeArgument = false  # 204 errors
reportImplicitStringConcatenation = false  # 300+ errors
reportIncompatibleMethodOverride = false  # 300+ errors
reportPrivateUsage = false  # 900+ errors

# 1000+ errors
reportUnusedCallResult = false  # 1000+ errors
reportOptionalSubscript = false  # 1000+ errors, mostly failing to recognize config setter/getter
reportCallIssue = false  # 1000+ errors, mostly failing to recognize config setter/getter
reportOptionalMemberAccess = false  # 1683 errors
reportImplicitOverride = false  # 2000+ errors
reportIndexIssue = false  # 2000+ errors, mostly failing to recognize config setter/getter
reportAttributeAccessIssue = false  # 2000+ errors
reportArgumentType = false  # 2000+ errors
reportUnknownParameterType = false  # 4000+ errors
reportMissingParameterType = false  # 4000+ errors
reportUnknownVariableType = false  # 6000+ errors
reportUnknownArgumentType = false  # 6000+ errors
reportUnknownMemberType = false  # 20000+ errors

[tool.ty.environment]
python = ".venv"
python-platform = "win32"
# Tell ty where to load python code from (ported from pyright's extraPaths).
extra-paths = [
	"./source",
	# Used by system tests
	"./tests/system/libraries",
	# Used internally in NVDA
	"./miscDeps/python",
	"./include/nvda-mathcat/assets",
]

[tool.ty.src]
# Appended to ty's default excludes (which already cover e.g. .git, .venv and __pycache__ at any depth).
# Patterns are anchored to the project root.
exclude = [
	"build",
	"output",
	"./include/*",
	"./miscDeps",
	"./source/louis",
	# #10924: generated by third-party dependencies
	"./source/comInterfaces/*",
	# Code from add-ons
	"./source/userConfig/addons/*",
]

[tool.ty.terminal]
output-format = "concise"

[tool.ty.rules]
# ty (Astral's type checker) runs in parallel with pyright during the transition.
# To keep current code typing unchanged, rules that flood on the existing codebase
# are set to "ignore" (ty's rule taxonomy differs from pyright's, so this is
# analogous to, not a mirror of, the leniency configured in [tool.pyright]).
unresolved-attribute = "ignore"  # 3813 errors
not-subscriptable = "ignore"  # 1118 errors
invalid-argument-type = "ignore"  # 953 errors
invalid-assignment = "ignore"  # 455 errors
unsupported-operator = "ignore"  # 119 errors
invalid-method-override = "ignore"  # 113 errors
invalid-return-type = "ignore"  # 103 errors
invalid-type-form = "ignore"  # 37 errors
call-non-callable = "ignore"  # 32 errors
missing-argument = "ignore"  # 23 errors
not-iterable = "ignore"  # 22 errors
no-matching-overload = "ignore"  # 18 errors
# Unresolvable modules: generated COM stubs, optional native deps (brlapi,
# libmathcat_py), build-generated _buildVersion, and namespace-package quirks.
unresolved-import = "ignore"  # 13 errors
invalid-parameter-default = "ignore"  # 11 errors
invalid-yield = "ignore"  # 10 errors
unknown-argument = "ignore"  # 10 errors
too-many-positional-arguments = "ignore"  # 6 errors
invalid-super-argument = "ignore"  # 3 errors
call-top-callable = "ignore"  # 2 errors
invalid-attribute-access = "ignore"  # 1 error
empty-body = "ignore"  # 1 error
shadowed-type-variable = "ignore"  # 1 error
invalid-attribute-override = "ignore"  # 1 error
# Non-fatal warnings, ignored for the same reason as the errors above (ty 0.0.57).
possibly-missing-submodule = "ignore"  # 48 warnings
deprecated = "ignore"  # 24 warnings
invalid-enum-member-annotation = "ignore"  # 6 warnings
unused-type-ignore-comment = "ignore"  # 1 warning
unsupported-base = "ignore"  # 1 warning
redundant-cast = "ignore"  # 1 warning
mismatched-type-name = "ignore"  # 1 warning

[tool.uv]
default-groups = "all"
python-preference = "only-system"
environments = ["sys_platform == 'win32'"]
required-version = ">=0.9"

[tool.setuptools]
package-dir = {"" = "source"}

[tool.uv.sources]
nvda-misc-deps = { workspace = true }
configobj = { git = "https://github.com/DiffSK/configobj", rev = "9c8a0a80c767bf8a3d6493ed01df6c351bddca42" }
nvda-mathcat = { workspace = true }

[tool.uv.workspace]
members = [
	"miscDeps",
	"include/nvda-mathcat",
]

[dependency-groups]
dev = [
	"nvda-misc-deps",
	# NVDA's build system is SCons
	"SCons==4.10.1",
	# Packaging NVDA
	"py2exe==0.14.1.1",
	"setuptools~=80.10.2",
	"nvda-mathcat",
	"uv==0.11.29",
]
lint = [
	"ruff==0.15.9",
	"prek==0.4.4",
	"pyright[nodejs]==1.1.407",
	"ty==0.0.60",
]
license-check = [
	"licensecheck==2025.1",
]
dev-docs = [
	# For building developer documentation
	"sphinx==8.1.3",
	"sphinx_rtd_theme==3.0.1",
]
system-tests = [
	"robotframework==7.3.2",
	"robotremoteserver==1.1.1",
	"robotframework-screencaplibrary==1.6.0",
]
unit-tests = [
	# Creating XML unit test reports
	"unittest-xml-reporting==3.2.0",
	# Feed parameters to tests neatly
	"parameterized==0.9.0",
]

[tool.setuptools.dynamic]
version = {attr = "buildVersion.version_detailed"}