固定长度格式解析器

快速编写固定长度格式平面文件的解析器。

目标

此项目提供了一组宏，可以快速构建具有标识符开头且格式为固定长度的记录格式的解析器。

示例

考虑以下文件

AA20231201
PNDarth     Vader               123 Death Star Way            AB12 3CD
ZZ001

模式

这可以看作是以下指定格式的文件

记录类型

• 标题 ("AA")
• 个人 ("PN")
• 尾随 ("ZZ")

注意：记录类型可以由任意数量的字符表示，但必须始终位于记录的开始处，并且必须始终具有相同的长度。

标题:

个人:

尾随:

示例解析器

use fixedlength_format_parser::FixedLengthFormatParser;

#[derive(FixedLengthFormatParser)]
pub enum PersonRecord {
    #[record_type = "AA"]
    Header {
        #[field_starts = 2]
        #[field_length = 8]
        // You could also specify the end instead of the length. End is exclusive.
        // #[field_ends = 10]
        date: String,
    },

    #[record_type = "PN"]
    Person {
        #[field_starts = 2]
        #[field_length = 10]
        forename: String,

        // `field_starts` is optional. If unspecified, it starts at 0 then increments by the length for each field.
        #[field_length = 20]
        surname: String,

        #[field_length = 30]
        address_line: String,

        #[field_length = 8]
        postcode: String,
    },

    #[record_type = "ZZ"]
    Trailer {
        // Any type is allowed, as long as it implements [`std::str::FromStr`].
        #[field_starts = 2]
        #[field_length = 3]
        num_records: usize,
    },
}

// You can now invoke the parser for each record:
fn parse_record(record: &str) -> PersonRecord {
    record.parse::<PersonRecord>().expect("the record should be valid")
}