allow user to ignore trailing bytes

[Niedzwiedzw]

Pull Request Overview

it allows for user to ignore trailing bytes, which made the crate unusable for me personally

Testing Strategy

This pull request was tested by...

• Added relevant unit tests.
• Added relevant end-to-end tests (such as .lzma, .lzma2, .xz files).

[Niedzwiedzw]

I have also considered feature flag given that this changes the API a bit, I'll leave it up to your judgement

[7ERr0r]

That's a breaking change. Your API functions have different params.
I would suggest:

• renaming your LzmaDecoder::new to maybe LzmaDecoder::new_with_options
• renaming allow_trailing_bytes to allow_trailing_bytes_lzma since it's not effective for LZMA2 and XZ
• maybe separating Options into LzmaOptions from StreamOptions

[gendx]

• Breaking API changes are not a problem per se, as they can be guarded by features and a SemVer bump at the next release.
• As far as I understand it, this new option only applies to the raw stream, and therefore doesn't need to be part of the LZMA2 and xz APIs (which can simply invoke the LZMA layer with the default option).
• In any case, unit tests are needed.