Swiftpack.co - gematik/ASN1Kit as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
See all packages published by gematik.
gematik/ASN1Kit 1.1.0
ASN.1 Encoder\Decoder for Swift
⭐️ 12
🕓 6 days ago
iOS macOS watchOS tvOS
.package(url: "https://github.com/gematik/ASN1Kit.git", from: "1.1.0")

ASN1Kit

ASN.1 Decoder for Swift

API Documentation

Generated API docs are available at https://gematik.github.io/ASN1Kit.

License

Licensed under the Apache License, Version 2.0.

Overview

This library can be used for ASN.1 (Abstract Syntax Notation One) encoding/decoding using distinguished encoding rules (DER) according to the ITU-T X.690

For more info, please find the complete X.690-0207.pdf specification.

Getting Started

ASN1Kit requires Swift 5.1.

Setup for integration

  • Carthage: Put this in your Cartfile:

    github "gematik/ASN1Kit" ~> 1.0
    

Setup for development

You will need Bundler, XcodeGen and fastlane to conveniently use the established development environment.

  1. Checkout (and build) dependencies and generate the xcodeproject

    $ make setup
    
  2. Build the project

    $ make cibuild
    

Code Samples

Use ASN1Decoder.decode(asn1:) to decode serialized data and String(from:) to get a hex representation of it:

Construct an ASN1Object of your choice and serialize it:

let data = Data([0x0, 0x1, 0x2, 0x4]) as ASN1EncodableType
let data2 = Data([0x4, 0x3, 0x2, 0x1]) as ASN1EncodableType
let array = [data, data2]

let expected = Data([0x30, 0xc, 0x4, 0x4, 0x0, 0x1, 0x2, 0x4, 0x4, 0x4, 0x4, 0x3, 0x2, 0x1])
expect(try array.asn1encode().serialize()) == expected

ASN.1-encode Swift primitives and extract the encoded value(s):

//0x0080 = 128
let expected = Data([0x00, 0x80])
expect(try 128.asn1encode(tag: nil).data.primitive) == expected

Extract the tag of the first element of a constructed ASN1Object:

let data = Data([0x1, 0x2, 0x3, 0x4, 0x8])
let tag1 = ASN1Primitive(data: .primitive(data), tag: .taggedTag(3)) // context-specific class tag
let tag2 = ASN1Primitive(data: .primitive(data), tag: .universal(ASN1Tag.octetString))
let implicitTag = ASN1Primitive(data: .constructed([tag1, tag2]), tag: .taggedTag(83))

expect(implicitTag.data.items?.first?.tag) == .taggedTag(3)

GitHub

link
Stars: 12
Last commit: 6 days ago
jonrohan Something's broken? Yell at me @ptrpavlik. Praise and feedback (and money) is also welcome.

Dependencies

Release Notes

1.1.0
5 days ago
  • Update Xcode Version to 13.3.1
  • Update dependencies
  • Change mac deployment target to macOS 11

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics