Metadata-Version: 2.1
Name: ti842py
Version: 0.1.0
Summary: TI-BASIC to Python 3 Transpiler
Home-page: https://github.com/TabulateJarl8/ti842py
Author: Tabulate
Author-email: tabulatejarl8@gmail.com
License: UNKNOWN
Description: # ti842py
        
        [![PyPI version](https://badge.fury.io/py/ti842py.svg)](https://badge.fury.io/py/ti842py)
        [![Downloads](https://pepy.tech/badge/ti842py)](https://pepy.tech/project/ti842py)
        [![PyPI license](https://img.shields.io/pypi/l/ansicolortags.svg)](https://pypi.python.org/pypi/ansicolortags/)
        [![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://GitHub.com/TabulateJarl8/ti842py/graphs/commit-activity)
        [![GitHub issues](https://img.shields.io/github/issues/TabulateJarl8/ti842py.svg)](https://GitHub.com/TabulateJarl8/ti842py/issues/)
        
        ----
        
        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`:
        
        ```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`
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
