swift-multiaddr

multiaddr：可组合且面向未来的网络地址，可作为现代、零依赖的 Swift 库使用。

安装

Swift Package Manager

要使用 Swift Package Manager，将 Multiaddr 添加到您的 Package.swift 文件中。或者，直接从 Xcode 添加。

let package = Package(
    name: "myproject",
    dependencies: [
        .package(url: "https://github.com/lukereichold/swift-multiaddr.git", from: "1.0.0"),
    ],
    targets: [
        .target(
            name: "myproject",
            dependencies: ["Multiaddr"]),
    ]
)

然后运行 swift build。

Carthage

要使用 Carthage，将 Multiaddr 添加到您的 Cartfile 中

github "lukereichold/swift-multiaddr" ~> 1.0.0

然后运行 carthage update 并在 Carthage/Build/<platform> 中使用该框架。

用法

人类可读的编码

let addr = try Multiaddr("/dns6/foo.com/tcp/443/https")
dump(addr)

▿ /dns6/foo.com/tcp/443/https
  ▿ addresses : 3 elements
    ▿ 0 : /dns6/foo.com
      - addrProtocol : Multiaddr.Protocol.dns6
      ▿ address : Optional<String>
        - some : "foo.com"
    ▿ 1 : /tcp/443
      - addrProtocol : Multiaddr.Protocol.tcp
      ▿ address : Optional<String>
        - some : "443"
    ▿ 2 : /https
      - addrProtocol : Multiaddr.Protocol.https
      - address : nil

使用打包的二进制编码

let serializedData = try addr.binaryPacked()
/// (`Data`) 14 bytes

二进制解码

let addrFromData = try Multiaddr(serializedData)
/// `[Multiaddr.Address]`  3 values

Equatable 支持

assert(addr == addrFromData) /// true

协议/地址枚举

print(addr.protocols())
/// `["dns6", "tcp", "https"]`

封装 (Encapsulate)

let encapsulated = try Multiaddr("/dns4/foo.com").encapsulate("tcp/80/http/bar/baz.jpg")
print(encapsulated) /// `/dns4/foo.com/tcp/80/http/bar/baz.jpg`

解封装 (Decapsulate)

let tcpComponent = try Multiaddr("tcp/80")
let decapsulated = encapsulated.decapsulate(tcpComponent)
print(decapsulated) /// `/dns4/foo.com`

`pop()`

let popped = addr.pop()
Optional<Address>
  ▿ some : /https
    - addrProtocol : Multiaddr.Protocol.https
    - address : nil

贡献

欢迎贡献。请查看这些问题。