Skip to content

Fix up braille deprecations#20458

Merged
SaschaCowley merged 16 commits into
masterfrom
braille-deprecations
Jul 16, 2026
Merged

Fix up braille deprecations#20458
SaschaCowley merged 16 commits into
masterfrom
braille-deprecations

Conversation

@SaschaCowley

@SaschaCowley SaschaCowley commented Jul 7, 2026

Copy link
Copy Markdown
Member

Link to issue number:

Closes #20431
Follow-up to #20390

Summary of the issue:

In #20252, source/braille.py was split into the source/braille/ package. In #20390, the moved symbols were marked as deprecated. Internal code that uses these symbols was not updated to use the new paths, so logs are being flooded with deprecation warnings.

Description of user facing changes:

None.

Description of developer facing changes:

NVDA's logs should once again be useable.

Description of development approach:

Marked the tests.unit.test_braille.test_publicSurface.TestBraillePublicSurface.test_deprecatedNamesReturnCorrectObject test as skipped.

For each symbol in:

  • Searched NVDA's python code (source/ and tests/) for that symbol.
  • For each found instance:
    • Updated it to use the new path; and
    • Where the calling module did not already do so, imported the new symbol's module.
  • Commented out the redirect.
  • Ran unit tests.

Testing strategy:

Unit and system tests.

Known issues with pull request:

None known.

Code Review Checklist:

  • Documentation:
    • Change log entry
    • User Documentation
    • Developer / Technical Documentation
    • Context sensitive help for GUI changes
  • Testing:
    • Unit tests
    • System (end to end) tests
    • Manual testing
  • UX of all users considered:
    • Speech
    • Braille
    • Low Vision
    • Different web browsers
    • Localization in other languages / culture than English
  • API is compatible with existing add-ons.
  • Security precautions taken.

Comment thread source/brailleDisplayDrivers/alva.py Dismissed
Comment thread source/brailleDisplayDrivers/baum.py Dismissed
Comment thread source/brailleDisplayDrivers/brailleNote.py Dismissed
Comment thread source/brailleDisplayDrivers/brailliantB.py Dismissed
Comment thread source/brailleDisplayDrivers/eurobraille/gestures.py Dismissed
Comment thread source/brailleDisplayDrivers/handyTech.py Dismissed
Comment thread source/brailleDisplayDrivers/hidBrailleStandard.py Dismissed
Comment thread source/brailleDisplayDrivers/hims.py Dismissed
Comment thread source/_remoteClient/input.py Dismissed
Comment thread source/brailleDisplayDrivers/nlseReaderZoomax.py Dismissed
@LeonarddeR

Copy link
Copy Markdown
Collaborator

@SaschaCowley Thanks for taking this!

@hwf1324

hwf1324 commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

I noticed that there are still some deprecation warnings in the logs.

@seanbudd

seanbudd commented Jul 9, 2026

Copy link
Copy Markdown
Member

That's okay - several smaller PRs that tackle these individually is much easier to review

@SaschaCowley
SaschaCowley force-pushed the braille-deprecations branch from 09160f5 to ddb470f Compare July 9, 2026 10:04
@SaschaCowley
SaschaCowley requested a review from LeonarddeR July 9, 2026 10:07
@SaschaCowley

Copy link
Copy Markdown
Member Author

I believe this is done, pending system tests

@LeonarddeR

Copy link
Copy Markdown
Collaborator

I'm not sure how to review this properly, at first sight this looks good to me.

@seanbudd seanbudd added the conceptApproved Similar 'triaged' for issues, PR accepted in theory, implementation needs review. label Jul 13, 2026
@hwf1324

hwf1324 commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

Can this PR be merged as soon as possible?

@SaschaCowley SaschaCowley added this to the 2026.3 milestone Jul 15, 2026
@SaschaCowley
SaschaCowley marked this pull request as ready for review July 15, 2026 23:58
@SaschaCowley
SaschaCowley requested a review from a team as a code owner July 15, 2026 23:58
@SaschaCowley
SaschaCowley requested a review from seanbudd July 15, 2026 23:58
@SaschaCowley
SaschaCowley marked this pull request as draft July 16, 2026 02:00
@SaschaCowley
SaschaCowley marked this pull request as ready for review July 16, 2026 02:07
@SaschaCowley
SaschaCowley enabled auto-merge (squash) July 16, 2026 02:08
@hwf1324

hwf1324 commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

@SaschaCowley, Due to a system test failure, automatic merging is not possible.

@SaschaCowley
SaschaCowley merged commit baecfe2 into master Jul 16, 2026
84 of 86 checks passed
@SaschaCowley
SaschaCowley deleted the braille-deprecations branch July 16, 2026 05:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

conceptApproved Similar 'triaged' for issues, PR accepted in theory, implementation needs review. release/blocking-beta

Projects

None yet

Development

Successfully merging this pull request may close these issues.

A large number of deprecation warnings are flooding the logs.

4 participants