Skip to content

Latest commit

 

History

History
128 lines (83 loc) · 5.11 KB

RELEASE-NOTES.md

File metadata and controls

128 lines (83 loc) · 5.11 KB
Raw

0.20.0

Next

  • Update MSRV to 1.57.0

0.20.0-alpha.1

Breaking changes

  • Extended the Config concept into the Engine abstraction, allowing the user to pick different encoding / decoding implementations.
    • What was formerly the only algorithm is now the FastPortable engine, so named because it's portable (works on any CPU) and relatively fast.
    • This opens the door to a portable constant-time implementation (#153, presumably ConstantTimePortable?) for security-sensitive applications that need side-channel resistance, and CPU-specific SIMD implementations for more speed.
    • Standard base64 per the RFC is available via DEFAULT_ENGINE. To use different alphabets or other settings (padding, etc), create your own engine instance.
  • CharacterSet is now Alphabet (per the RFC), and allows creating custom alphabets. The corresponding tables that were previously code-generated are now built dynamically.
  • Since there are already multiple breaking changes, various functions are renamed to be more consistent and discoverable.
  • MSRV is now 1.47.0 to allow various things to use const fn.
  • DecoderReader now owns its inner reader, and can expose it via into_inner(). For symmetry, EncoderWriter can do the same with its writer.
  • encoded_len is now public so you can size encode buffers precisely.

0.13.1

  • More precise decode buffer sizing, avoiding unnecessary allocation in decode_config.

0.13.0

  • Config methods are const
  • Added EncoderStringWriter to allow encoding directly to a String
  • EncoderWriter now owns its delegate writer rather than keeping a reference to it (though refs still work)
    • As a consequence, it is now possible to extract the delegate writer from an EncoderWriter via finish(), which returns Result<W> instead of Result<()>. If you were calling finish() explicitly, you will now need to use let _ = foo.finish() instead of just foo.finish() to avoid a warning about the unused value.
  • When decoding input that has both an invalid length and an invalid symbol as the last byte, InvalidByte will be emitted instead of InvalidLength to make the problem more obvious.

0.12.2

  • Add BinHex alphabet

0.12.1

  • Add Bcrypt alphabet

0.12.0

  • A Read implementation (DecoderReader) to let users transparently decoded data from a b64 input source
  • IMAP's modified b64 alphabet
  • Relaxed type restrictions to just AsRef<[ut8]> for main encode*/decode* functions
  • A minor performance improvement in encoding

0.11.0

  • Minimum rust version 1.34.0
  • no_std is now supported via the two new features alloc and std.

0.10.1

  • Minimum rust version 1.27.2
  • Fix bug in streaming encoding (#90): if the underlying writer didn't write all the bytes given to it, the remaining bytes would not be retried later. See the docs on EncoderWriter::write.
  • Make it configurable whether or not to return an error when decoding detects excess trailing bits.

0.10.0

  • Remove line wrapping. Line wrapping was never a great conceptual fit in this library, and other features (streaming encoding, etc) either couldn't support it or could support only special cases of it with a great increase in complexity. Line wrapping has been pulled out into a line-wrap crate, so it's still available if you need it.
    • Base64Display creation no longer uses a Result because it can't fail, which means its helper methods for common configs that unwrap() for you are no longer needed
  • Add a streaming encoder Write impl to transparently base64 as you write.
  • Remove the remaining unsafe code.
  • Remove whitespace stripping to simplify no_std support. No out of the box configs use it, and it's trivial to do yourself if needed: filter(|b| !b" \n\t\r\x0b\x0c".contains(b).
  • Detect invalid trailing symbols when decoding and return an error rather than silently ignoring them.

0.9.3

  • Update safemem

0.9.2

  • Derive Clone for DecodeError.

0.9.1

  • Add support for crypt(3)'s base64 variant.

0.9.0

  • decode_config_slice function for no-allocation decoding, analogous to encode_config_slice
  • Decode performance optimization

0.8.0

  • encode_config_slice function for no-allocation encoding

0.7.0

  • STANDARD_NO_PAD config
  • Base64Display heap-free wrapper for use in format strings, etc

0.6.0

  • Decode performance improvements
  • Use unsafe in fewer places
  • Added fuzzers

0.5.2

  • Avoid usize overflow when calculating length
  • Better line wrapping performance

0.5.1

  • Temporarily disable line wrapping
  • Add Apache 2.0 license

0.5.0

  • MIME support, including configurable line endings and line wrapping
  • Removed decode_ws
  • Renamed Base64Error to DecodeError

0.4.1

  • Allow decoding a AsRef<[u8]> instead of just a &str

0.4.0

  • Configurable padding
  • Encode performance improvements

0.3.0

  • Added encode/decode functions that do not allocate their own storage
  • Decode performance improvements
  • Extraneous padding bytes are no longer ignored. Now, an error will be returned.