Introducing spell checking and fixing several typos (#934)

* fix: introduce cspell and fix spelling errors across codebase

Add cspell spell-checking configuration:
- cspell.json with file/path scoping and Mako template override
- cspell-dict.txt for project-specific technical terms
- cspell-ignore-words.txt for known abbreviations and API identifiers
- cspell-mako-keywords.txt for Mako template keywords

Fix spelling errors in variable, function, file names, comments,
docstrings, and test names throughout the codebase.

* chore: regenerate code after spelling fixes

* fix: address styleguide lint issues

* chore: remove temporary mypy output file

* fix: remove UTF-8 BOM from cspell-ignore-words.txt

* chore: move cspell dictionaries to .cspell/ directory

* chore: merge cspell-ignore-words.txt into cspell-dict.txt

* chore: add DAQmx abbreviations dictionary and deduplicate cspell-dict

* chore: improve cspell configuration and dictionaries

- Set noSuggest on all dictionaries so project-specific terms don't
  pollute suggestion lists
- Add cspell-dict and cspell-daqmx-abbreviations to the Mako template
  override so abbreviations are recognized in templates
- Merge duplicate entries in cspell-daqmx-abbreviations.txt (e.g.
  Conn # Connect / Connected / Connecting / Connector)
- Add '# Real words' section header to cspell-dict.txt

* chore: switch cspell to ignorePaths-only pattern and expand scope to docs

- Replace files allowlist with ignorePaths blocklist and useGitignore: true
- Add docs/**/*.rst to spell-check scope
- Add .cspell/cspell-sphinx-directives.txt dictionary for Sphinx RST directives
- Add *.rst override to apply Sphinx directives dictionary

* chore: expand cspell scope to .md files and fix spelling errors

- Add per-file dictionaries and overrides for CHANGELOG.md and CONTRIBUTING.md
- Add .cspell/cspell-changelog-words.txt with historical identifiers and bot names
- Add .cspell/cspell-contributing-words.txt with contribution workflow terms
- Add package names to cspell-dict.txt (numpy, ctypes, pytest, matplotlib, pyplot)
- Add HWCU and NIDAQ to cspell-dict.txt
- Add bitfields plural form to cspell-dict.txt
- Add backlinks to cspell-sphinx-directives.txt
- Add python dictionary to .rst override for code examples
- fix: correct domaindirectives typo in CHANGELOG.md

* chore: replace blanket extension exclusions with specific file paths in cspell

* chore: sort cspell ignorePaths in VS Code Explorer order

* chore: spell-check .env.sample and add MBCS, multibyte to dictionary

* chore: spell-check .gitignore

* chore: remove redundant comments from cspell overrides

* chore: use consistent dictionary order in cspell overrides

* chore: regenerate utils.py after cspell comment style fix

* chore: run cspell in CI

* docs: document cspell as a required step in the contribution workflow

* chore: consolidate cspell:ignore directives in test_internationalization.py

* chore: remove redundant bnptdms from dictionary

cspell treats \b as a regex metacharacter, so r"\bnptdms\b" produces
the token nptdms, which is already in the dictionary. The bnptdms
entry was never needed.

* refactor: rename FULLSCALE_RAW_MAX/MIN to FULL_SCALE_RAW_MAX/MIN in test_in_stream

* chore: alphabetize cspell dictionary and annotate each entry with its origin

* chore: sort and annotate sphinx directives and mako keywords dictionaries

* chore: sort and annotate changelog and contributing dictionaries, add python dict to changelog override

* chore: migrate changelog and contributing word lists to inline cspell ignores

* chore: extend cspell to codegen/generated files; fix typos

Add .cspell/cspell-codegen-dict.txt with ~115 entries covering
NI-DAQmx initialisms, abbreviations, compound identifiers, typos
locked in public API names, and real domain words specific to
codegen and generated source files.

Update cspell.json:
- Add cspell-codegen-dict dictionary definition
- Remove broad generated/** and src/codegen/** ignore paths so
  these files are now spell-checked
- Add generated/nidaqmx/_stubs/** back to ignorePaths (protobuf
  stubs are too noisy to check)
- Add override applying cspell-codegen-dict to src/codegen/**
  and generated/**
- Sort dictionaryDefinitions alphabetically
- Order ignorePaths to match VSCode Explorer layout
- Add ordering comments to both lists

Fix typos in metadata source (src/codegen/metadata/attributes.py):
- specfied -> specified
- thermcouple -> thermocouple
- thefilter -> the filter (two occurrences)

These propagate into generated files via codegen; also fix them
directly in the generated files that are already up to date.

Minor code fixes:
- src/codegen/generator.py: docstring "Codegenerator" -> "Code generator"
- src/codegen/stub_generator.py: rename grpc_codegened_file_paths
  -> grpc_code_generated_file_paths

* chore: clean up and annotate cspell.json -> ignorePaths

* chore: extend cspell coverage to pyproject.toml

- Remove pyproject.toml from cspell.json ignorePaths
- Add cspell override for pyproject.toml with [cspell-dict,
  cspell-daqmx-abbreviations, python] dictionaries; the python
  dictionary covers: mypy, pypy, grpcio, tzlocal, doctest,
  filterwarnings, xfail
- Add // cspell:disable-line to the override's filename line in
  cspell.json to suppress pyproject in that string literal
- Suppress maintainer names (Hindes, Maxx, Boehme, Keryan) using
  # cspell:disable / # cspell:enable around the maintainers block
- Add # cspell:ignore addopts above [tool.pytest.ini_options].addopts
- Add # cspell:ignore testpaths above [tool.pytest.ini_options].testpaths
- Add grpcdevice and styleguide to .cspell/cspell-dict.txt
- Remove grpcdevice from .cspell/cspell-changelog-words.txt
- Remove styleguide from .cspell/cspell-changelog-words.txt and
  .cspell/cspell-contributing-words.txt
- Remove <!-- cspell:ignore styleguide --> from CONTRIBUTING.md
- Remove <!-- cspell:ignore styleguide --> and
  <!-- cspell:ignore grpcdevice --> from CHANGELOG.md

* chore: align ignorePaths comments in cspell.json

* fix: wrap long list comprehension in stub_generator.py

* revert: undo _dotenv_path rename; add dotenvpath to cspell dict with TODO

* refactor: rename cfunc to c_func in _lib.py for consistency with _library_interpreter.py

* chore: remove unused words from cspell-daqmx-abbreviations.txt

* chore: consolidate NI-DAQmx words into cspell-daqmx-abbreviations.txt

* chore: reorganize cspell dictionaries by purpose

* chore: move cspell:ignore comments inline in CONTRIBUTING.md

* chore: delete cspell-changelog-words and cspell-contributing-words dictionaries

* chore: add python to global cspell dictionaries; remove redundant overrides

* fixup! chore: Consolidate cspell dictionaries into one project dictionary

Improve comments in cspell-daqmx-api-elements.txt for consistency:
- Use specific comment taxonomy: abbreviation, unseparated words,
  unseparated initialisms, initialism, Typo, Deprecated
- Move mioDAQ to cspell-real-words.txt
- Move forcebridge/pressurebridge/torquebridge to
  cspell-project-software-terms.txt (typo: filenames should be PascalCase)
- Move installdriver to cspell-project-software-terms.txt (CLI command)
- Reclassify BBULK, COULDNT, DOESNT, DAQError, notKnown, zidx
  with accurate comments instead of 'compatibility breaking name'

* chore: rename TEDS asset files to PascalCase for consistency

forcebridge.ted → ForceBridge.ted
pressurebridge.ted → PressureBridge.ted
torquebridge.ted → TorqueBridge.ted

Update conftest.py fixtures and remove the words from the cspell dictionary.

* chore: improve cspell-real-words.txt comments; correct SMIO expansion

- Remove redundant "Real word:" and "Initialism:" prefixes from comments
- Lowercase entries that are neither initialisms nor proper nouns
- Add descriptions to bare entries
- Standardize GPS initialism comments
- Correct SMIO expansion: Serial Memory I/O -> Simultaneously-sampling Multifunction I/O

* chore: use cspell-action instead of npx to run cspell

* chore: move cspell config to .config/; simplify dictionary names

- Move cspell.json to .config/cspell.json
- Move .cspell/ dictionary files to .config/cspell/, dropping the
  redundant "cspell-" prefix from each filename and dictionary name
- Add globRoot: "${cwd}" so paths resolve correctly from the new location
- Set noSuggest: false on real-words to enable spelling suggestions

* docs: add 1.5.0 changelog section; mention cspell under Major Changes

* docs: incorporate 1.4.1 section and fix 1.5.0 PR link in changelog

Author: KostaIlic2

.config/cspell.json

@@ -0,0 +1,46 @@
+{
+  "version": "0.2",
+  "globRoot": "${cwd}",
+  // Keep the following list of items in alphabetical order.
+  "dictionaryDefinitions": [
+    { "name": "daqmx-api-elements", "path": "./cspell/daqmx-api-elements.txt", "noSuggest": true },
+    { "name": "real-words", "path": "./cspell/real-words.txt", "noSuggest": false },
+    { "name": "mako-keywords", "path": "./cspell/mako-keywords.txt", "noSuggest": true },
+    { "name": "project-software-terms", "path": "./cspell/project-software-terms.txt", "noSuggest": true },
+    { "name": "sphinx-directives", "path": "./cspell/sphinx-directives.txt", "noSuggest": true }
+  ],
+  "dictionaries": ["real-words", "daqmx-api-elements", "project-software-terms", "python"],
+  "useGitignore": true,
+  // Keep the following list of items in the order that they appear in VSCode
+  // Explorer (directories in alphabetical order, followed by top-level files
+  // in alphabetical order).
+  "ignorePaths": [
+    ".config/cspell/**",           // dictionary source files; words here are not prose
+    "docs/img/**",                 // binary image files
+    "docs/conf.py",                // Sphinx config; extension names and config keys
+    "docs/make.bat",               // Sphinx build script; not prose
+    "docs/Makefile",               // Sphinx build script; not prose
+    "generated/nidaqmx/_stubs/**", // protobuf-generated stubs; too noisy to check
+    "tests/max_config/**",         // NI MAX config files; NI-specific identifiers
+    "tests/test_assets/**",        // test fixture files; not prose
+    "third_party/**",              // third-party code we don't own or control
+    ".readthedocs.yml",            // ReadTheDocs config
+    "poetry.lock",                 // auto-generated lock file; hashes and package URLs
+    "poetry.toml",                 // Poetry config
+    "tox.ini"                      // tox config
+  ],
+  "overrides": [
+    {
+      "filename": "**/*.mako",
+      "dictionaries": ["real-words", "daqmx-api-elements", "python", "mako-keywords"]
+    },
+    {
+      "filename": "**/*.rst",
+      "dictionaries": ["real-words", "daqmx-api-elements", "python", "sphinx-directives"]
+    },
+    {
+      "filename": "**/CONTRIBUTING.md",
+      "dictionaries": ["real-words"]
+    }
+  ]
+}

.config/cspell/daqmx-api-elements.txt

@@ -0,0 +1,115 @@
+acceld                # Deprecated; see attribute_helpers.py
+ACRMS                 # unseparated initialisms; AC RMS
+AHigh                 # unseparated words; A high
+AIAC                  # unseparated initialisms; AI AC
+AIADC                 # unseparated initialisms; AI ADC
+AIDC                  # unseparated initialisms; AI DC
+AIGnd                 # unseparated words; AI ground
+AILVDT                # unseparated initialisms; AI LVDT
+AIRTD                 # unseparated initialisms; AI RTD
+AIRTDA                # unseparated initialisms; AI RTD A
+AIRTDB                # unseparated initialisms; AI RTD B
+AIRTDC                # unseparated initialisms; AI RTD C
+AIRTDR0               # unseparated initialisms; AI RTD R0
+AIRVDT                # unseparated initialisms; AI RVDT
+AITEDS                # unseparated initialisms; AI TEDS
+anlg                  # abbreviation; analog
+AODAC                 # unseparated initialisms; AO DAC
+AOGnd                 # unseparated words; AO ground
+AOHW                  # unseparated initialisms; AO HW
+APFI                  # initialism; Analog Programmable Function Interface
+asyn                  # abbreviation; asynchronous
+atten                 # abbreviation; attenuation
+attentuation          # Typo; should be: attenuation
+BBULK                 # Typo; should be USB_BULK instead of US_BBULK
+BHigh                 # unseparated words; B high
+calibrationInfo       # unseparated words
+CAPI                  # unseparated words; C API
+certiticates          # Typo; should be: certificates
+cfgd                  # abbreviation; configured
+cfgs                  # abbreviation; configurations
+chans                 # abbreviation; channels
+CIGPS                 # unseparated initialisms; CI GPS
+CIHW                  # unseparated initialisms; CI HW
+CITC                  # unseparated initialisms; CI TC
+CIUTC                 # unseparated initialisms; CI UTC
+clks                  # abbreviation; clocks
+cmplt                 # abbreviation; complete
+coeff                 # abbreviation; coefficient
+coeffs                # abbreviation; coefficients
+COHW                  # unseparated initialisms; CO HW
+COHWTSP               # unseparated initialisms; CO HWTSP
+compen                # abbreviation; compensated / compensation
+conv                  # abbreviation; convert
+couldnt               # abbreviation; couldn't
+ctrs                  # abbreviation; counters
+DAQError              # unseparated words
+descr                 # abbreviation; description
+difft                 # abbreviation; different
+doesnt                # abbreviation; doesn't
+DSTAR                 # for further research; stands for differential star (PXIe trigger), but we also use D_STAR
+elec                  # abbreviation; electrical
+excit                 # abbreviation; excitation
+expir                 # abbreviation; expiration
+exportSignal          # unseparated words
+fltr                  # abbreviation; filter
+forceLb               # unseparated words; force in pounds
+freqOut               # abbreviation; frequency output
+frequencyWith         # unseparated words
+globalVirtualChannels # unseparated words; global virtual channels
+hshk                  # abbreviation; handshake
+HWTEDS                # unseparated initialisms; HW TEDS
+HWTSP                 # initialism; Hardware-Timed Single Point
+hyst                  # abbreviation; hysteresis
+hysts                 # abbreviation; hysteresis
+immed                 # abbreviation; immediate
+invalidc              # Typo; should be: INVALID_CDAQ_SYNC_PORT_CONNECTION_FORMAT
+IRIGB                 # initialism; IRIG-B
+isoc                  # abbreviation; isochronous
+lvls                  # abbreviation; levels
+MIOAI                 # unseparated initialisms; MIO AI
+mult                  # abbreviation; multiple
+multiDevice           # unseparated words
+NIDAQ                 # initialism; NI-DAQ (legacy product name)
+nidaqmx               # NI-DAQmx package name
+nonBuffered           # unseparated words
+notKnown              # unseparated words
+NRSE                  # initialism; Non-Referenced Single-Ended
+nums                  # abbreviation; numbers
+onbrd                 # abbreviation; onboard
+outp                  # abbreviation; output
+persistedChannel      # unseparated words
+persistedScale        # unseparated words
+persistedTask         # unseparated words
+physicalChannel       # unseparated words
+posssible             # Typo; should be: possible
+pretrig               # abbreviation; pre-trigger
+prpty                 # abbreviation; property
+rangeWith             # unseparated words
+regen                 # abbreviation; regeneration
+rngs                  # abbreviation; ranges
+rqst                  # abbreviation; request
+samp                  # abbreviation; sample
+samps                 # abbreviation; samples
+scanList              # unseparated words
+sensord               # Deprecated; see attribute_helpers.py
+sensitivit            # Typo; should be: sensitivity
+SMIO                  # initialism; Simultaneously-sampling Multifunction I/O
+specd                 # abbreviation; specified
+srcs                  # abbreviation; sources
+subsytem              # Typo; should be: subsystem
+taskToCopy            # unseparated words; task to copy
+tcpip                 # initialism; TCP/IP
+TEDSAI                # unseparated initialisms; TEDS AI
+TEDSAIRTD             # unseparated initialisms; TEDS AI RTD
+TEDSHWTEDS            # unseparated initialisms; TEDS HWTEDS
+thrmcpl               # abbreviation; thermocouple
+thrmstr               # abbreviation; thermistor
+timeTriggers          # unseparated words
+trigs                 # abbreviation; triggers
+unavail               # abbreviation; unavailable
+USBDAQ                # unseparated initialisms; USB DAQ
+verif                 # abbreviation; verification
+voltaged              # Deprecated; see attribute_helpers.py
+xfer                  # abbreviation; transfer
+ZIdx                  # abbreviation; Z index

.config/cspell/mako-keywords.txt

@@ -0,0 +1,10 @@
+# Mako template closing keywords for control structures (% endXXX markers).
+# Mako closes each % control block with a matching % end<keyword> line.
+# All seven closing keywords are included; they are all used in src/codegen/templates/.
+endblock
+enddef
+endfor
+endif
+endtry
+endwhile
+endwith

.config/cspell/project-software-terms.txt

@@ -0,0 +1,64 @@
+addoption         # Dependency: pytest
+allclose          # Dependency: numpy
+argtype           # Standard library: ctypes
+argtypes          # Standard library: ctypes
+ascontiguousarray # Dependency: numpy
+autoinstall       # Linux system tool names (external)
+byref             # Standard library: ctypes
+callspec          # Dependency: pytest
+caplog            # Dependency: pytest
+cdecl             # C calling convention name (used in codegen)
+chkconfig         # Linux system tool names (external)
+codegen           # codegen internals
+ctypes            # Standard library: ctypes
+ctypeslib         # Standard library: ctypes
+CVICALLBACK       # NI CVI calling convention macro (C interop comment)
+docstrings        # Python terminology
+dotenv            # Dependency: python-decouple / dotenv
+dotenvpath        # Typo - TODO - rename the files and make related changes
+dpkg              # Linux system tool names (external)
+dtype             # Dependency: numpy
+fixturenames      # Dependency: pytest
+frombuffer        # Dependency: numpy
+getfixturevalue   # Dependency: pytest
+grpcdevice        # NI package name; ni-grpcdevice
+hightime          # Dependency: hightime
+htmlcov           # Python tooling (directory/artifact names, not real words)
+iinfo             # Dependency: numpy
+insserv           # Linux system tool names (external)
+installdriver     # CLI command name and corresponding function
+localzone         # Dependency: tzlocal
+matplotlib        # Dependency: matplotlib
+metafunc          # Dependency: pytest
+modifyitems       # Dependency: pytest
+nbytes            # Dependency: numpy
+ndarray           # Dependency: numpy
+ndpointer         # Dependency: numpy
+NISHAREDDIR       # NI Linux install directory environment variable
+nicai             # NI-DAQmx C library filename (Windows DLL)
+nicaiu            # NI-DAQmx C library filename (Windows DLL, Unicode)
+nidevice          # NI package name; ni-device-grpc
+nitypes           # Dependency: nitypes
+nptdms            # Dependency: nptdms
+numpy             # Dependency: numpy
+parametrizing     # Dependency: pytest
+printoptions      # Dependency: numpy
+protoc            # Tool name: protobuf compiler
+pycache           # Python tooling (directory/artifact names, not real words)
+pykka             # Dependency: pykka
+pyplot            # Dependency: matplotlib
+pytest            # Dependency: pytest
+rtol              # Dependency: numpy
+scrapigen         # codegen internals
+styleguide        # ni-python-styleguide linting tool
+sint              # Protobuf type; signed integer
+tobytes           # Dependency: numpy
+tolist            # Dependency: numpy
+typeshed          # Python type stubs repository (mypy/pyright tooling)
+unraisable        # Dependency: pytest
+unraisablehook    # Dependency: pytest
+ulonglong         # C type: unsigned long long
+varargs           # Standard library: ctypes
+venv              # Python tooling (directory/artifact names, not real words)
+xlabel            # Dependency: matplotlib
+ylabel            # Dependency: matplotlib

.config/cspell/real-words.txt

@@ -0,0 +1,76 @@
+autozero            # Electronic instrumentation term
+backplane           # Digital electronics and computer engineering term
+bandpass            # Filter term
+bitfield            # Computing term; contiguous range of bits in a value
+bitfields           # Computing term; contiguous range of bits in a value
+bitstream           # Computing term; sequence of bits transmitted serially
+brickwall           # Filter term
+Butterworth         # Scientist name; Butterworth filter
+cDAQ                # CompactDAQ (NI hardware platform)
+Callendar           # Physicist name; Callendar-Van Dusen equation
+CPLD                # Complex Programmable Logic Device
+DAQmx               # Data Acquisition Measurement Extensions
+deassert            # Digital electronics and computer engineering term
+deasserting         # Digital electronics and computer engineering term
+deasserts           # Digital electronics and computer engineering term
+deleters            # Software term
+DKMS                # Dynamic Kernel Module Support
+Dusen               # Physicist name; Van Dusen of Callendar-Van Dusen equation
+EEPROM              # Electrically Erasable Programmable Read-Only Memory
+HDOP                # Horizontal Dilution of Precision (GPS)
+highpass            # Filter term
+HWCU                # Hardware Configuration Utility
+IEPE                # Integrated Electronics Piezo-Electric
+IRIG                # Inter-Range Instrumentation Group
+jumpered            # Electronics term
+lowpass             # Filter term
+LVDT                # Linear Variable Differential Transformer
+LVTTL               # Low Voltage Transistor-Transistor Logic
+MBCS                # Multi-Byte Character Set
+MDNS                # Multicast DNS
+MeasurementLink     # NI product name
+micropascals        # Unit of pressure
+mioDAQ              # NI product category
+milli               # SI prefix
+multibyte           # Computing term; character encoding using multiple bytes
+NIELVIS             # NI product name; NI ELVIS
+nonprintable        # Computing term
+overcurrent         # Electrical engineering term
+overrange           # Measurement term; signal exceeding the measurable range
+overread            # Data acquisition term
+overtemperature     # Electrical/safety term; exceeding a temperature limit
+overvoltage         # Electrical engineering term
+PDOP                # Position Dilution of Precision (GPS)
+pico                # SI prefix
+powerline           # Electrical engineering term
+powerup             # Electronics term
+pseudodifferential  # Electronics measurement term
+PXIe                # PCI eXtensions for Instrumentation, Express variant
+ratiometric         # Electronics measurement term
+RDMA                # Remote Direct Memory Access
+readall             # Software term; read all available data
+reglitch            # Electronics DAC term
+reglitching         # Electronics DAC term (gerund)
+replug              # Hardware term
+retriggerable       # Electronics term; able to be triggered again before previous cycle ends
+RTSI                # Real-Time System Integration
+RVDT                # Rotary Variable Differential Transformer
+SCXI                # Signal Conditioning eXtensions for Instrumentation
+Steinhart           # Physicist name; Steinhart-Hart thermistor equation
+stopband            # Filter term
+subsecond           # Time measurement term; less than one second
+subseconds          # Time measurement term; less than one second
+TDMS                # Technical Data Management Streaming
+timebase            # Electronics term; reference clock signal
+timebases           # Electronics term
+tristated           # Electronics term
+tristates           # Electronics term (verb/noun)
+unflatten           # Software term; deserialize/reconstruct nested data
+unloadable          # Computing term
+unreserve           # Software term; release a reserved resource
+unreserves          # Software term; release a reserved resource
+VCXO                # Voltage-Controlled Crystal Oscillator
+VDOP                # Vertical Dilution of Precision (GPS)
+yoctosecond         # Unit of time; SI prefix
+yoctoseconds        # Unit of time; SI prefix
+

.config/cspell/sphinx-directives.txt

@@ -0,0 +1,11 @@
+# Sphinx directive names and option values flagged by cspell in this project's .rst files.
+# This is not an exhaustive list of Sphinx directives — only words that cspell does not
+# recognize from its built-in dictionaries and that appear in docs/ are included here.
+automodule
+backlinks
+bysource
+currentmodule
+genindex
+modindex
+toctree
+undoc

.github/workflows/build.yml

@@ -32,6 +32,11 @@ jobs:
           install-args: "--all-extras --with examples"
       - name: Run Bandit security checks
         run: poetry run bandit -c pyproject.toml -r generated/nidaqmx
+      - name: Run cspell
+        uses: streetsidesoftware/cspell-action@v8
+        with:
+          incremental_files_only: false
+          check_dot_files: explicit
       - name: Generate ni-daqmx files
         if: ${{ runner.os == 'Linux' && matrix.python-version == env.codegen-python-version }}
         run: |