ti842py 0.1.0

TI-BASIC to Python 3 Transpiler

ti842py

---

ti842py is a TI-BASIC to Python 3 transpiler. A transpiler is a piece of software that can convert code from one language to another. This program should be able to convert a lot of programs, but if you find something that it can't convert yet, start an issue.

Features

---

• Converts string literals to comments
• Disp
• Variable assignment
• If/Then/Else statements, including Else If
• ClrHome
• Input
• For loops
• While loops
• Repeat loops
• Pause
• Wait
• Stop
• DelVar
• Prompt
• getKey

Planned Features

• Goto
• Lbl
• IS>(
• DS<(
• Return
• eval()/expr()
• toString()
• Output()
• Ans

Installation

---

ti842py can be installed via PyPI or by cloning the repository. To install it with PyPI, just run pip3 install ti842py in a terminal. To install it locally, you can clone the repository and run python setup.py install --user.

Usage

---

ti842py can be used in 2 different ways. The first way is just running it from the command line. For example, if you wanted to convert the program in tiprogram.txt to tiprogram.py, you can this command: ti842py -i tiprogram.txt -o tiprogram.py. If no value is specified for -o, the converted program will be written to stdout. The -n flag can be added to force the transpiler to not decompile the input file, and the -d flag can be added to force the transpiler to attempt and decompile the input file

usage: ti842py [-h] [-o O] -i I [-n] [-d]

optional arguments:
  -h, --help            show this help message and exit
  -o O                  Optional output file to write to. Defaults to standard out.
  -i I                  Input file.
  -n, --force-normal    Forces the program to not attempt and decompile the input file. Useful for false positives
  -d, --force-decompile
                        Forces the program to attempt to decompile the input file

ti842py can also be imported and used in a program. Here is an example program to convert tiprogram.txt to tiprogram.py:

from ti842py import transpile

transpile("tiprogram.txt", "tiprogram.py")

Again, if the second argument is not supplied, the program will be written to stdout. The transpile command can be supplied with 2 optional arguments, decompileFile and forceDecompile. decompileFile defaults to True, and forceDecompile defaults to False