IdParser 3.0.4

Parses AAMVA-compliant driver's licenses and ID cards

There is a newer version of this package available.
See the version list below for details.
Install-Package IdParser -Version 3.0.4
dotnet add package IdParser --version 3.0.4
<PackageReference Include="IdParser" Version="3.0.4" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add IdParser --version 3.0.4
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

ID Parser

Build Status

ID Parser can be used to parse AAMVA-compliant driver's licenses and ID cards into objects that you can
work with. More information on the versions of the AAMVA standard.

Usage

  1. Include the using
using IdParser;
  1. Then you're off to the races!
var idCard = Barcode.Parse(barcode);
Console.WriteLine(idCard.StreetLine1); // "123 NORTH STATE ST."
Console.WriteLine(idCard.IssuerIdentificationNumber.GetDescription()); // "New York"

if (idCard is DriversLicense) {
    var license = (DriversLicense)idCard;
    Console.WriteLine(license.Jurisdiction.VehicleClass); // "C"
}

More Examples

Take a look at the unit test project for more examples and usage.

Client

The IdParser.Client project is a handy GUI application to help test and verify that an ID
will be parsed correctly. The app works with both OPOS and HID keyboard emulation scanners.

FAQ

  • I can't build IdParser.Client. It's missing a required dependency.
    You need to have Microsoft POS for .NET
    installed. The Microsoft.PointOfService dll is GAC'd and will allow you to build and run
    the client app.

  • The Height class has the wrong TotalInches or Centimeters.
    The AAMVA standard has no decimal places in the height subfile record.
    As a result, the conversion between inches and centimeters will be off.

  • The library is throwing ArgumentExcpetions for every barcode I'm passing in.
    By default, all barcodes are parsed using the Strict validation level. All barcodes are expected to
    adhere exactly to the AAMVA standard as defined in the PDFs for parsing to succeed. This is the
    recommended level for scanners using OPOS. However, if HID keyboard emulation is used, especially when
    scanning using a web browser, the expected data can become malformed. You can try using the None
    validation level, however this is not guaranteed to work in all cases. Data elements may be skipped
    and exceptions may still be thrown.

ID Parser

Build Status

ID Parser can be used to parse AAMVA-compliant driver's licenses and ID cards into objects that you can
work with. More information on the versions of the AAMVA standard.

Usage

  1. Include the using
using IdParser;
  1. Then you're off to the races!
var idCard = Barcode.Parse(barcode);
Console.WriteLine(idCard.StreetLine1); // "123 NORTH STATE ST."
Console.WriteLine(idCard.IssuerIdentificationNumber.GetDescription()); // "New York"

if (idCard is DriversLicense) {
    var license = (DriversLicense)idCard;
    Console.WriteLine(license.Jurisdiction.VehicleClass); // "C"
}

More Examples

Take a look at the unit test project for more examples and usage.

Client

The IdParser.Client project is a handy GUI application to help test and verify that an ID
will be parsed correctly. The app works with both OPOS and HID keyboard emulation scanners.

FAQ

  • I can't build IdParser.Client. It's missing a required dependency.
    You need to have Microsoft POS for .NET
    installed. The Microsoft.PointOfService dll is GAC'd and will allow you to build and run
    the client app.

  • The Height class has the wrong TotalInches or Centimeters.
    The AAMVA standard has no decimal places in the height subfile record.
    As a result, the conversion between inches and centimeters will be off.

  • The library is throwing ArgumentExcpetions for every barcode I'm passing in.
    By default, all barcodes are parsed using the Strict validation level. All barcodes are expected to
    adhere exactly to the AAMVA standard as defined in the PDFs for parsing to succeed. This is the
    recommended level for scanners using OPOS. However, if HID keyboard emulation is used, especially when
    scanning using a web browser, the expected data can become malformed. You can try using the None
    validation level, however this is not guaranteed to work in all cases. Data elements may be skipped
    and exceptions may still be thrown.

  • .NETStandard 2.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version History

Version Downloads Last updated
4.1.2 9,555 7/17/2019
4.1.1 2,833 2/18/2019
4.1.0 1,024 12/17/2018
4.0.1 3,218 6/4/2018
4.0.0 648 3/11/2018
3.0.4 483 2/11/2018
3.0.3 743 10/1/2017
3.0.2 698 9/12/2017
3.0.2-beta 869 9/10/2017
3.0.1 464 9/1/2017
3.0.0 513 8/11/2017
2.1.2 548 3/7/2017
2.1.1 441 2/28/2017
2.1.0 454 2/23/2017
2.0.1 498 10/16/2016
2.0.0 484 10/16/2016
1.1.1 511 9/25/2016
1.1.0 693 9/25/2016
1.0.0 865 9/23/2016
Show less