Tivars

Newest stable release for `tivars_lib_py`. Install from this tag or [from PyPI](https://pypi.org/project/tivars/0.9.2/).

**Full Changelog**: https://github.com/TI-Toolkit/tivars_lib_py/commits/v0.9.2

New features
- Several new and improved f-string formatting options for various entries (check the README for specs)
- `TokenizedEntry.load_string` now supports tokenization `mode` as a keyword argument
- Byte literal `\xXXXX` support in tokenization
- `TIEntry.type_id` can be accessed as a class attribute to return the entry type's ID
- New methods for `TIRealRadical`: `signed_left_scalar` and `signed_right_scalar`
- More examples
- More warnings about invalid data and unrecognized arguments

Bug fixes
- Fixed `TIRealRadical.sign_type`
- Meta bytes are now correctly ignored when exporting flashless vars

Breaking changes
- The `j` format spec for numbers has been removed
- The `t` format spec for token-representable entries now always uses accessible names; use `d` to force display names

Contributions
- rpitasky - Contributed to and compartmentalized the examples

Newest stable release for `tivars_lib_py`. Install from this tag or [from PyPI](https://pypi.org/project/tivars/0.9.1/).

**Full Changelog**: https://github.com/TI-Toolkit/tivars_lib_py/commits/v0.9.1

New features
- Smart tokenization mode — token munching better reflects program context
- New `tokenizer.normalize` function to normalize certain Unicode chars for tokenization
- New `Self` type annotations for 3.11+ to help static type analyzers
- All `typing` type aliases (to-be deprecated in a future version of Python) have been removed
- More warnings about invalid files and entry names

Bug fixes
- Fixed `ListEntry.load_list` and `TIMatrix.load_matrix` not working
- Entry name tokenization is now more consistent

Breaking changes
- Smart tokenization mode is now the default; use `mode=max` to enable previous behavior
- Some functions in `tokenizer` now use keyword-only arguments

Contributions
- adriweb - Set the spec for smart tokenization, reflecting much of the TI Connect CE program editor's behavior

Newest stable release for `tivars_lib_py`. Install from this tag or [from PyPI](https://pypi.org/project/tivars/0.9.0/).

**Full Changelog**: https://github.com/TI-Toolkit/tivars_lib_py/commits/v0.9.0

New features
- Support for flash files — check out `TIFlashHeader` and its subclasses
- DoorsCSE tokenized assembly programs are now (somewhat crudely) detected on load
- All `ByteString` usages (to-be deprecated in Python 3.14) have been removed
- Enhanced `TIFeature` docs
- More frequent and verbose warnings

Newly-supported types (https://github.com/TI-Toolkit/tivars_lib_py/issues/5)
- `TIOperatingSystem`
- `TIApp`
- `TICertificate`
- `TILicense`

Bug fixes
- Fixed a bug when initializing a `ComplexEntry`
- Fixed a type mismatch in `TIGroup.group`
- Removed a crash when detokenizing null bytes
- Typing issues

Breaking changes
- `Flags` values are now `int` instead of `bytes`
- The default model is now `TI_84PCE` instead of `TI_83P`

Contributions
- LogicalJoe - Knows everything there is to know about flash files
- Zaalan3 - Reported a few bugs and insufficient warnings in `TIGroup`

Newest stable release for `tivars_lib_py`. Install from this tag or [from PyPI](https://pypi.org/project/tivars/0.8.2/).

**Full Changelog**: https://github.com/TI-Toolkit/tivars_lib_py/commits/v0.8.2

Bug fixes
- Fixed plugin crash for PIL 10.1.0

Newest stable release for `tivars_lib_py`. Install from this tag or [from PyPI](https://pypi.org/project/tivars/0.8.1/).

**Full Changelog**: https://github.com/TI-Toolkit/tivars_lib_py/commits/v0.8.1

New features
- New program subtypes: `TIAsmProgram` and `TIProtectedAsmProgram`
- Crosslinks to PIL docs
- Module and package docstrings

Newest stable release for `tivars_lib_py`. Install from this tag or [from PyPI](https://pypi.org/project/tivars/0.8.0/).

**Full Changelog**: https://github.com/TI-Toolkit/tivars_lib_py/commits/v0.8.0

New features
- PIL plugins — import `tivars.PIL` to register the TI image types with PIL
- Enhanced API docs and docstrings with `pydoctor`
- Types which are normally archived on-calc are archived by default
- List loaders now accept any `Sequence` type
- New methods for GDBs: `get_equations` and `get_color_data`
- New methods for programs: `protect` and `unprotect`
- New attribute for pictures: `np_shape`

Newly-supported types (https://github.com/TI-Toolkit/tivars_lib_py/issues/5)
- `TIGroup`

Bug fixes
- `get_version` and `get_min_os` now accept arbitrary data for all entry types
- Fixed a crash in `TIComplexList.get_version` and `TIComplexList.get_min_os`
- Fixed lingering `bytes != int` comparisons
- Typing issues

Breaking changes
- `open` is now a classmethod for all types to permit shorter initialization calls
- The `data_length` property has been renamed `calc_data_length` to avoid confusion for sized entries

Contributions
- LogicalJoe - Provided functional references for the layout of group objects