Skip to content

Latest commit

 

History

History
88 lines (58 loc) · 1.99 KB

README.md

File metadata and controls

88 lines (58 loc) · 1.99 KB

Bencode

Bencode is a general purpose bencode encoder & decoder written in Swift 5.

Inspired by VFK SwiftyBencode & arvidsigvardsson/Bencode

Installation

⚠️ Xcode 9 is required ⚠️

Swift Package Manager

Just add a new package on your project, and point to this repository.

CocoaPods

Bencode is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'Bencode'

Usage

Initialize with URL:

let bencode: Bencode? = Bencode(file: torrentUrl)

Initialize with bencoded string:

let bencode: Bencode? = Bencode(bencodedString: content)

Would you like to know more of the parsing failures, use the decoder:

do {
    let bencode = Bencoder().decode(from: fileURL)
} catch let error {
    print(error)
}

Accessing properties:

Accessing properties is very handy with subscripts & accessors. Value accessors .int, .string, .list & .dict are optional. Subscripts produces BencodeOptional enums, by doing so you can chain optional subscripts without having to write ? or ! behind every one of them. Bencode also comfort to Sequence protocol, so you can use map, filter, foreach etc. on them. :)

let bencode = Bencode(file: torrentUrl)

let info = bencode["info"]
let files = info["files"]

// You can use them as a sequence
// .values is a shorthand for .map{ $0.value }
files.values.forEach {
    print($0["path"][0].string!)
}

// Easy optional chaning without unwapping every stage:
let filePath: String? = info["files"][0]["path"][0].string
let fileLength: Int? = bencode["info"]["files"]["length"].int

Help

  • Post any issues you find
  • Post new feature requests
  • Pull requests are welcome

Author

danieltmbr, daniel@tmbr.me

License

Bencode is available under the MIT license. See the LICENSE file for more info.