feat: allow reading uncompressed size

[FineFindus]

Implements support for reading the uncompressed size without decompressing the input. As this is not supported by all formats, None may be returned.

[NobodyXu]

Thanks, one suggestion for the API

[FineFindus]

Changed.
After thinking about it a bit more, maybe it would be better to move this to a separate trait to more clearly indicate that the compression format does not support retrieving the uncompressed size? Since right now None can indicate either that a format does not support reading the uncompressed size/it's not yet implemented or an error occurred whilst reading. What's your opinion on this?

[NobodyXu]

Yeah putting it in a separate trait sounds reasonable, and , I suggest we could name it

trait DecodedSize {
    fn get_decoded_size(input: &[u8]) -> Result<usize>;
}
}

I also notice that this function does not depend on the state of decoder, so we should make that clear.

We could also just expose it as a regular function

[FineFindus]

I also notice that this function does not depend on the state of decoder, so we should make that clear.

Not for the ones I implemented, but I didn't want to force a breaking change when adding other/future formats (for example gzip has an ISIZE field, but that's limited to 4GB, which is why I didn't implemented it).

We could also just expose it as a regular function

I think a trait works better here, as that allows it to be used in trait bounds.

[NobodyXu]

Thanks, I'm currently working on refactoring on this repo, so I planned to cut a new release in at least one week's time

If you need it now, I can try to cut a release this week instead

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 0.00%. Comparing base (1fa960f) to head (eb0efd1).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

@@     Coverage Diff     @@
##   main   #396   +/-   ##
===========================
===========================

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[FineFindus]

Thanks, I'm happy to wait (or use a git commit :))