CHANGELOG.md

Change Log

[Unreleased][unreleased]

Changed/Fixed

Added

Thanks

9.0.0

Changed/Fixed

• Upgrade asn1-rs to 0.6.0
• Set MSRV to 1.63.0
• Update hex-literal to 0.4.0
• Implement BerObject::try_from(Any) (#67)

8.2.0

Changed/Fixed

• Fix parser name to parse_der_visiblestring for VisibleString (Closes #64). Keep previous function for compatibility (mark it as deprecated).
• Fix clippy warnings (rustc 1.67.1)
• Update test-case from 2.0 to 3.0

8.1.0

Changed/Fixed

• Upgrade asn1-rs to 0.5.0 (new features only: only increment minor number)

8.0.0

Changed/Fixed

• Upgrade asn1-rs to 0.4.0 This causes an increment of the major number, because asn1-rs is re-exported

7.0.0

This release marks the beginning of the merge with the asn1-rs crate. This will break things.

However, this is necessary, because the asn1-rs crate is much cleaner and supports more types and features (like serialization, custom derive, etc.). Ultimately, this crate will become a frontend to asn1-rs, that will be optional: crate users can switch to asn1-rs and use it directly.

Changed/Fixed

MSRV: The minimum supported rust version is now 1.53.

BerObjectHeader:

• BerSize has been renamed to Length
• BerClass has been renamed to Class
• BerTag has been renamed to Tag
• Header fields are now private. Getters/setters have been added, and must be used to access/modify fields

BerObjectContent:

• Unknown variant now contains an Any object, with both the header and object content
• Private variant has been merged into Unknown
• BmpString, GeneralString, GraphicString, T61String, VideotexString and ObjectDescriptor are now decoded
• GeneralizedTime and UtcTime are now decoded

BerError:

• Add error types UnexpectedClass and UnexpectedTag
• Store expected and found item in error to help debugging
• Keep InvalidTag for tags with invalid form (length/encoding/etc.)
• Use displaydoc for BerError
• Parsing an indefinite length in DER now raises IndefiniteLengthUnexpected
• Error: when a DER constraint fails, store constraint identifier

DER:

• DerClass and DerTag have been deprecated. Use Class and Tag instead.
• DerObjectHeader has been deprecated. Use Header instead.

Oid:

• The Oid object is now the same as asn1_rs::Oid (simply reexported)
• Remove dependency on crate der-oid-macro

Misc:

• ber_read_element_content_as now requires a non-zero depth, or it will raise a BerMaxDepth error (previously, 0 allowed one level of parsing)
• crate rusticata-macros is now re-exported (#55)

Thanks

• @lilyball
• @erikmarkmartin

6.0.0

This release has several major changes:

• upgrade to nom 7
• add support for no_std
• remove all macros
• update MSRV to 1.48

Changed/Fixed

• Do not attempt to parse PRIVATE object contents (closes #48)
• BER: raise error if using Indefinite length and not constructed
• Fix oid! macro to be independant of der_parser crate name and path (#46)
• Simplify der-oid-macro, do not depend on nom
• Fix INTEGER signed/unsigned parsing (#49)
• Change as_bigint() and as_uint() to return a Result
• Remove deprecated functions

Added

• Added support for no_std (#50)
• Make BerError Copy + Clone (#51)
• Add feature 'bitvec' for .as_bitslice() methods

Removed

• Remove all macros

Thanks

• @yoguorui for no_std support
• @SergioBenitez for BerError traits
• @lilyball for INTEGER parsing

5.1.0

Changed/Fixed

• Remove dependency on proc-macro-hack (attempt to fix #36)
• Update pretty_assertions requirement from 0.6 to 0.7
• Update num-bigint to 0.4 (Closes #42)

5.0.1

Changed/Fixed

• Fix typos in the parse_[ber|der]_[u32|u64] doc comments
• Add documentation for BerObjectContent variants (#41)
• Fixes for clippy

Added

5.0.0

See changelog entries for 5.0.0-beta1 and -beta2 for changes since 4.1

Changed/Fixed

The following changes applies since 5.0.0-beta1, and do not affect 4.x

• Fix potential integer underflow in bytes_to_u64
• Fix potential stack recursion overflow for indefinite length objects (Add maximum depth).
• Fix potential UB in bitstring_to_u64 with large input and many ignored bits
• Fix constructed objects parsing with indefinite length (do not include EOC)
• Constructed objects: use InvalidTag everywhere if tag is not expected
• Integer parsing functions now all return IntegerTooLarge instead of MapRes
• Ensure Indefinite length form is only used in BER constructed objects

Added

• Add new error StringInvalidCharset and update string parsing methods
• Add methods parse_ber_slice and parse_der_slice to parse an expected Tag and get content as slice

5.0.0-beta2

Changed/Fixed

• Consistency: reorder arguments or function callbacks, always set input slice as first argument (parse_ber_sequence_defined_g, parse_ber_container, parse_ber_tagged_explicit_g, ...)
• Make functions parse_ber_sequence_of_v and parse_ber_set_of_v accept generic error types

Added

• Add parse_ber_content2, owned version of parse_ber_content, which can directly be combined with parse_ber_tagged_implicit_g
• Add methods to parse DER tagged values and containers (with constraints)

5.0.0-beta1

Changed/Fixed

• Upgrade to nom 6
• Switch all parsers to function-based parsers
• Change representation of size (new type BerSize) to support BER indefinite lengths
• Rewrite BER/DER parsing macros to use functional parsing combinators
• The constructed bit is now tested for explicit tagged structures
• Some checks (for ex. tags in constructed objects) now return specific errors (InvalidTag) instead of generic errors (Verify)
• Refactor BerObject for parsing of tagged and optional values
• Add method as_bitslice() to BerObject
• Remove Copy trait from BerObjectHeader, copy is non-trivial and should be explicit
• Fix the bug that caused OIDs longer than two subidentifiers which started by subidentifiers "0.0" ("itu-t recommenation") not to be decoded correctly
• Implement the as_u64 and as_u32 methods for BerObjects with contents of type BerObjectContent::BitString.
• Implement the VideotexString, ObjectDescriptor GraphicString, and VisibleString string types. (Non-breaking changes)
• Correctly decode BMPString as UTF-16 instead of UTF-8 when printing. (Non-breaking change)
• Turn UTCTime and GeneralizedTime into a &str instead of &[u8], as they inherit from VisibleString which is a subset of ASCII. (Breaking change)

Added

• Add combinator parse_ber_optional

Thanks

By alphabetic order of handle:

• @cccs-sadugas
• @nickelc
• @p1-mmr

4.1.0

Added/Changed

• Re-export num-bigint so crate users do not have to import it
• Add function versions to parse BER sequences/sets (#20)
• Add function versions to parse BER tagged objects (#20)
• Add generic error type to structured parsing functions
• Add function to parse a generic BER container object
• Document that trailing bytes from SEQUENCE/SET are ignored
• Deprecate functions parse_{ber,der}_explicit (use _optional)

4.0.2

Changed/Fixed

• Upgrade dependencies on num-bigint and der-oid-macro

4.0.1

Changed/Fixed

• Add workaround to fix parsing of empty sequence or set

4.0.0

Attention This is a major release, with several API-breaking changes. See UPGRADING.md for instructions.

Thanks

• Jannik Schürg (oid, string verifications)

Added

• Add functions parse_ber_recursive and parse_der_recursive, allowing to specify maximum recursion depth when parsing
• The string types IA5String, NumericString, PrintableString and UTF8String do now only parse if the characters are valid.
• as_str() was added to BerObjectContent to obtain a &str for the types above. as_slice() works as before.
• Implement Error trait for BerError
• Add method to extract raw tag from header
  • BerObjectHeader now has a lifetime and a raw_tag field
  • BerObject now has a raw_tag field
  • Implement PartialEq manually for BerObject: raw_tag is compared only if both fields provide it
• Add type BerClass
• Start adding serialization support (experimental) using the serialize feature

Changed/Fixed

• Make header part of BerObject, remove duplicate fields
• Maximum recursion logic has changed. Instead of providing the current depth, the argument is now the maximum possible depth.
• Change the api around Oid to achieve zero-copy. The following changed:
  • The Oid struct now has a lifetime and uses Cow internally.
  • The procedural macro oid! was added.
  • Oid::from returns a Result now.
  • The Oid struct now encodes whether the oid is relative or not.
  • The Debug implementation now shows whether the oid is relative and uses the bigint feature if available.
  • The Oid::iter method now returns an Option. Oid::iter_bigint was added.
  • Hash is now derived for Oid.
• Minimum rust version is now 1.34

3.0.3

• Make the pretty-printer function public
• Fix DER datestring sanity check
• CI
  • add rusfmt check
  • add cargo clippy

3.0.2

• Add parse_ber_u32 and parse_ber_u64 functions
• Fix typo in description

3.0.1

• Add crate BerResult and DerResult types
• Use crate result types, remove uneeded imports
  • Crates using der-parser do not need to import nom or rusticata-macros anymore
  • Result types are aliases, so API is unchanged

3.0.0

• Upgrade to nom 5 (breaks API)
• New error types, now all functions use BerError

2.1.0

• Handle BER/DER tags that are longer than one byte.
• Set edition to 2018

2.0.2

• Revert 2.0.1 release, breaks API

2.0.1

• Handle BER/DER tags that are longer than one byte.

2.0.0

• Refactor code, split BER and DER, check DER constraints
• Add recursion limit for sequences and sets
• Rustfmt
• Documentation
• Remove unused function ber_read_element_content

1.1.1

• Fix OID parsing, and add support for relative OIDs
• Add FromStr trait for Oid

1.1.0

• Use num-bigint over num and upgrade to 0.2

1.0.0

• Upgrade to nom 4

0.5.5

• Add functions parse_der_u32 and parse_der_u64 to quickly parse integers
• Remove Oid::from_vec, Oid::from does the same
• Enforce constraints on DER booleans

0.5.4

• Add BitStringObject to wrap BitString objects
• Mark constructed BitStrings as unsupported
• Do not try to parse application-specific data in parse_der

0.5.3

• Add function DerObject::as_u64
• Add function DerObject::as_oid_val
• Add parse_der_struct! variant to check tag

0.5.2

• Add functions to test object class and primitive/constructed state
• Add macro parse_der_application!
• Add macro parse_der_tagged! to parse [x] EXPLICIT or [x] IMPLICIT tagged values

0.5.1

• Add type GeneralString
• Add macro parse_der_struct!

0.5.0

• Allow use of crate without extra use statements
• Use constants for u32 errors instead of magical numbers
• Rename tag_of_der_content() to DerObjectContent::tag
• Rename DerElementxxx structs to have a consistent naming scheme
• Add documentation for parsing DER sequences and sets, and fix wrong return type for sets
• Fix a lot of clippy warnings
• QA: add pragma rules (disable unsafe code, unstable features etc.)
• More documentation
• Switch license to MIT + APLv2

0.4.4

• Add macro parse_der_defined_m, to parse a defined sequence or set This macro differs from parse_der_defined because it allows using macros
• Rename DerObject::new_int to DerObject::from_int_slice
• Rename Oid::to_hex to Oid::to_string
• Document more functions

0.4.1

• Add new feature 'bigint' to export DER integers
• OID is now a specific type
• Add new types T61String and BmpString
• Fix wrong expected tag in parse_der_set_of

0.4.0

• Der Integers are now represented as slices (byte arrays) since they can be larger than u64.