Projects for the Blind python programmer

 Access module 'addend' at open source  https://github.com/kds215/addend

 install via pip under Windows or MacOS:
pip install addend

 addend

'addend.py' is a python utility intended for BLIND python programmers.

For Visual Impaired (VI) programmers it is NOT easy to listen to and explore large python code files where the number of indent spaces on each line of code has a syntactical meaning for python interpreters.

'addend' adds #comments, like '# @end: if', '# @end: for', etc, for easier sound recognition when a syntax block structure has ended as defined by python's space indentation rules. Those added '# @end:' comment lines are placed whenever a syntax block has ended. Hopefully, these #comments provides guidance for VI folks while they simultaneously decipher python code and intently listen to unfamiliar python code with their favorite reader like JAWS, NVDA, or VO.

Python started in 1991 and is now a popular programming language because of its syntax simplicity and success in Data Science & ML Projects. With the advent of python-based LLMs the use of python has increased dramatically leaving blind python programmers at a disadvantage in that field. Python is an "offside" language depending solely on the different space indentation to close syntax blocks. This makes it difficult for blind folks to study unfamiliar python code and to listen at the same time to their readers.

Below highlights today's blind python programmer's dilemma when advice is given by a python developer to folks working in python:

"Generally, if you're used to curly braces {} language, just indent the code like them and you'll be fine."

should be expanded to ==> "except when you are blind and depend on a reader".

Blind folks are disadvantaged in today's fast past AI work environments when it comes to programming in python.

'addend' is hopefully making it easier for blind python programmers navigating and analyzing large & unfamiliar python files with the help of a reader calling out: '# @end: ...' whenever a python syntax block has ended.

The basics for working with 'addend':

 [1] use it in conjunction with VScode or ANY other text editor:

   ==>  'code my_large.py'       launch python file in VScode

   ==>  'addend my_large.py'     run in cmd or terminal window

      a backup file 'my_large.MMDD.hhmmss.py' is automatically created

      and VScode updates showing '# @end:' comments.

 [2] use it to keep the original file untouched by providing an

   optional output file and continue editing in the new file that was generated:

   ==> 'addend my_large.py new_large.py'

       'code new_large.py' VScode shows the added '# @end:' comments.

 [3] to remove ALL added '# @end:' comments use:

   ==> 'addend -r new_large.py'       (output to same file)

   ==> 'addend -r new_large.py final_large.py'    (output to different file)

   ==> 'addend -r -d new_large.py'    (also lists all ignored lines)

 Python version: >=3.7 installation is required.

 Optional requirement:     for [-b] option: 'black' python syntax checker

       to install use:     'pip install black'

 To install 'addend' on MacOS or Windows platform use:

   'pip install addend'

 Run 'addend' from command line without leading 'python' or '.py' :

 % 'addend --help' 

 usage: addend [-h] [-b] [-r] [-d] [-v] [inFilename] [outFilename]

 positional arguments:

   inFilename     process input inFilename.py to add '# @end:' lines based on python indent rules.

   outFilename    specify OPTIONAL outFilename.py ; DEFAULT output is same inFilename.

 optional arguments:

   -h, --help     show this help message and exit

   -b, --black    run 'black' python syntax checker before & after 'addend' processing.

   -r, --remove   ONLY remove ALL '# @end:' comment lines from input filename.

   -d, --debug    print debugging lines.

   -v, --version  print version number.

    Default output is 'inFilename.py' with the '# @end:' comments added.

    The unchanged input file is SAVED as 'inFilename.MMDD-hhmmss.py'

 NOTE: all prior added "# @end:" comment lines are automatically removed

 during the next addend run and are re-added accordingly.