An implementation of Project Haystack in Swift.
To use this package, add it to your Package.swift dependencies:
dependencies: [
.package(url: "https://github.com/NeedleInAJayStack/swift-haystack.git", from: "0.0.0"),
],
targets: [
.target(
name: "MyTarget",
dependencies: [
.product(name: "Haystack", package: "swift-haystack"),
]
),
]You can then import and use the different libraries:
import Haystack
func testGrid() throws -> Grid {
return try ZincReader(
"""
ver:"3.0" foo:"bar"
dis dis:"Equip Name", equip, siteRef, installed
"RTU-1", M, @153c-699a HQ, 2005-06-01
"RTU-2", M, @153c-699b Library, 1997-07-12
"""
).readGrid()
}See below for available libraries and descriptions.
This contains the Haystack type-system primitives and utilities to interact with them.
A Darwin-only client driver for the Haystack HTTP API that requires minimal dependencies. Use this if you are only deploying to MacOS, iOS, etc and want to reduce dependencies.
Here's an example of how to use it:
import HaystackClientDarwin
func client() throws -> Client {
return try Client(
baseUrl: "https://mydomain.com/api/",
username: "username",
password: "password"
)
}A cross-platform client driver for the Haystack HTTP API that has larger dependency requirements. Use this if you are only deploying to Linux or if you are deploying to Darwin platforms and are willing to accept more dependencies.
Here's an example of how to use it:
import HaystackClientNIO
func client() throws -> Client {
let httpClient = HTTPClient(eventLoopGroupProvider: .createNew)
return try Client(
baseUrl: "https://mydomain.com/api/",
username: "username",
password: "password",
httpClient: httpClient
)
}This defines the main functionality of Haystack API clients. It should not be imported directly;
its assets are imported automatically by HaystackClientDarwin or HaystackClientNIO.
Once you create a client, you can use it to make requests:
func yesterdaysValues() async throws -> Grid {
let client = ...
// Open and authenticate. This must be called before requests can be made
try await client.open()
// Request the historical values for @28e7fb7d-e20316e0
let grid = try await client.hisRead(id: Ref("28e7fb7d-e20316e0"), range: .yesterday)
// Close the client session and log out
try await client.close()
return grid
}This package is licensed under the Academic Free License 3.0 for maximum compatibility with Project Haystack itself.