# ISO8211

ISO 8211 data format library

[![CI](https://github.com/sevenseas-io/iso8211/actions/workflows/ci.yml/badge.svg)](https://github.com/sevenseas-io/iso8211/actions)
[![crates.io](https://img.shields.io/crates/v/iso8211.svg)](https://crates.io/crates/iso8211)
[![Documentation](https://docs.rs/iso8211/badge.svg)](https://docs.rs/iso8211)

## File Format

    Data Descriptive File
     |
    [1] --- Data Descriptive Record
     |	\
     |	[1] --- Leader
     |	 |
     |	[1] --- Directory
     |	 |
     |	[1] --- File Control Field
     |   |  \
     |   |  [*] (tag, field description)
     |	 |
     |  [1] --- Data Descriptive Field
     |      \
     |      [1] Field Controls
     |       |
     |	    [1] Field Name
     |       |
     |      [1] Array Descriptor
     |       |
     |      [1] Format Controls
     |
    [*] --- Data Record
       \
       [1] --- Leader
        |
       [1] --- Directory
        |	 |
        |   [*] --- Field
        |    \
        |    [1] Tag
        |     |
        |    [1] Length
        |     |
        |    [1] Data
        |
       [1] --- Data Field

## Minimum Supported Rust Version (MSRV)

This crate is guaranteed to compile on stable Rust 1.56 and up. It *might*
compile with older versions but that may change in any new patch release.


## License

Licensed under either of

- Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or
  http://www.apache.org/licenses/LICENSE-2.0)
- MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)

at your option.

## Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be
dual licensed as above, without any additional terms or conditions.

## Credits

* Thank you to the [IHO](https://iho.int) for openly making available their standards and test data
* The source code from [GDAL](https://github.com/OSGeo/gdal), [py-iso8211](https://sourceforge.net/projects/py-iso8211) and [A Parser for the ISO 8211 Data Format](https://erdc-library.erdc.dren.mil/jspui/bitstream/11681/11333/1/TEC-0045.pdf) was examined to help understand the ISO 8211 file format