Module rfc9557

This module provides parsing facilities for RFC 9557 extensions to RFC 3339.

This only provides internal helper routines that can be used in other parsers. Namely, RFC 9557 is just a backward compatible expansion to RFC 3339.

The parser in this module checks for full syntactic validity of the annotation syntax defined in RFC 9557. However, Jiff doesn’t make use of any of these annotations except for time zone annotations. So for example, 2024-05-25T13:33:00-05[America/New_York][foo=bar] is valid, but the parser will only expose the America/New_York annotation.

Note though that even for things that are ignored, validity and criticality are still respected. So for example, 2024-05-25T13:33:00-05[America/New_York][!foo=bar] will fail to parse because of the ! indicating that consumers must take action on the annotation, including by returning an error if it isn’t supported.

Structs

• ParsedAnnotations 🔒
  The result of parsing RFC 9557 annotations.
• Parser 🔒
  A parser for RFC 9557 annotations.

Enums

• ParsedTimeZone 🔒
  The result of parsing a time zone annotation.