tok8x - convert between plaintext files and tokenised files for the TI8x series of calculators
tok8x [OPTION]... [FILE]...
tok8x -i [-p] [-t=token set] TOKEN...
tok8x is a utility for two-way conversion between human-readable text files and TI's .8xp file format for storing TI-BASIC calculator programs. This format is also used by several user-created calculator languages, so support for some of them (currently Axe and Grammer) is included as well.
By default, input is read for the designated files, or stdin if no file names are provided, converted based on the type of the input data (if input is in 8xp format, output will be plain textl if input is plaintext, output will be 8xp), and written to the designated output file, or stdout if none is provided. If options are passed which do not apply to the current input and output formats, they will be ignored.
If the -i option is designated, arguments should be representations of tokens
provided either as their string names (i.e. ">DMS", "Asm(") or their hexadecimal
values (i.e. "01", "BB6A").
-
-h,--help: display help dialogue -
-i,--info: rather than converting files, return information on one or more tokens provided either as their string names (i.e. ">DMS", "Asm(") or their hexadecimal values (i.e. "01", "BB6A"). -
-t,--token_set=(axe|basic|grammer): define token set to be used -
-o,--output=FILE: define file to be written (defaults to stdout) -
-n,--name=NAME: define on-calc name (defaults to 'A'. affects only 8xp output) -
-a,--archived: generate archived program (affects only 8xp output) -
-p,--pretty: use "pretty" output, i.e. unicode approximations that more closely resemble the true appearances (affects plaintext output or printing information with -i) -
-s,--safe: when outputting to plain text, insert backslashes before single-character strings which could be misconstrued as the beginning of a token name to ensure they will remain distinct tokens if converted back to 8xp (affects only plaintext output) -
-c,--condense: strip excess whitespace to reduce on-calc size (affects only 8xp output) -
-e,--expand: insert whitespace to make output more easily human readable (affects only plaintext output)
Please report any bugs to https://github.com/shmibs/tok8x/issues
Katherine Martin shmibs@shmibbles.me