thonny-blvdiff 0.1.4

BLVDIFF plugin for Thonny

blvdiff - Thonny

About:

• An on-going individual study project at the University of Mary Washington
• Parts of the Rust structure based from blvrun: https://arxiv.org/pdf/2401.16654
• Designed to improve debugging directly on the command line for blind and low-vision (blv) developers.
• The associated paper for this project can be found here: https://dl.acm.org/doi/10.1145/3663547.3759716

Features:

• Rust based shell script.

• Automatic script versioning.

• Three Flags

  • --explain flag: feeds error tracebacks into an LLM powered by Meta Llama. Outputs an error explanation in a screen-readable format.
  • --diff flag: Utilizes previously saved script versions to generate a screen-readable display of changes made. Similiar functionality to that of vim-diff, but with automatic versioning.
  • --revert flag: Revert current script version back to most recently saved version. Similiar to that of git's revert feature.

Install:

Note: This version is for Thonny only.

For command-line support: blvdiff

Steps:

1. Open Thonny.

2. In the Tool menu select, Manage Plugins.

3. Search for, "thonny-blvdiff" and install.

4. Reload Thonny, open the tools menu.

You are now ready to use the tools functions described above.

First run, BLVDIFF: Setup.

Then, write a Python script and run it with.

• blvflag yourScriptName.py
• BLVDIFF: --explain
• BLVDIFF: --diff
• BLVDIFF: --revert