Swiftpack.co - SwiftScream/URITemplate as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
See all packages published by SwiftScream.
SwiftScream/URITemplate 3.1.0
Robust and performant Swift implementation of RFC6570 URI Template
⭐️ 9
🕓 1 year ago
.package(url: "https://github.com/SwiftScream/URITemplate.git", from: "3.1.0")

ScreamURITemplate

A robust and performant Swift 5 implementation of RFC6570 URI Template. Full Level 4 support is provided.

CI Codecov branch

license GitHub release

Getting Started

Swift Package Manager

Add .package(url: "https://github.com/SwiftScream/URITemplate.git", from: "3.0.0") to your Package.swift dependencies

Usage

Template Processing

import ScreamURITemplate

let template = try URITemplate(string:"https://api.github.com/repos/{owner}/{repository}/traffic/views")
let variables = ["owner":"SwiftScream", "repository":"URITemplate"]
let urlString = try template.process(variables)
// https://api.github.com/repos/SwiftScream/URITemplate/traffic/views

When Things Go Wrong

Both template initialization and processing can fail; throwing a URITemplate.Error The error cases contain associated values specifying a string reason for the error and the index into the template string that the error occurred.

do {
    _ = try URITemplate(string: "https://api.github.com/repos/{}/{repository}")
} catch URITemplate.Error.malformedTemplate(let position, let reason) {
    // reason = "Empty Variable Name"
    // position = 29th character
}

Get variable names used in a template

let template = try URITemplate(string:"https://api.github.com/repos/{owner}/{repository}/traffic/views")
let variableNames = template.variableNames
// ["owner", "repository"]

Codable Support

URITemplate implements the Codable protocol, enabling easy serialization to or from JSON objects.

struct HALObject : Codable {
    let _links : [String:URITemplate]
}

Tests

The library is tested against the standard test suite, as well as some additional tests for behavior specific to this implementation. It is intended to keep test coverage as high as possible.

GitHub

link
Stars: 9
Last commit: 7 weeks ago
Advertisement: IndiePitcher.com - Cold Email Software for Startups

Related Packages

Release Notes

3.1.0
1 year ago
  • Allow single-quote as literal, refer RFC errata 6937
  • Add Sendable conformance
  • Do not encode percent-encoded-triplets in reserved or fragment expansion
  • Update test suite
  • Support back to Swift 5.4

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