Swift library for accessing some of the meal related data the Studentenwerk Dresden has to offer.
let meals = try await Meal.for(canteen: .alteMensa, on: Date())
for meal in meals {
print(meal.name)
}
let canteens = try await Canteen.all()
for canteen in canteens {
print(canteen.name)
}
A completion block based API and one built on Combine are also available.
Talk to the Cardservice to acquire data about your Emeal card. You will need to have registered for Autoload to have the necessary authentication details.
let cardservice = try await Cardservice.login(username: "1234567890", password: "hunter2")
let carddata = try await cardservice.carddata()
print(carddata)
let ninetyDaysAgo = Date().addingTimeInterval(-60 * 60 * 24 * 90)
let transactions = try await cardservice.transactions(begin: ninetyDaysAgo)
print(transactions)
EmealKit also handles scanning the Emeal card via NFC if your device supports it. Just create an Emeal
object, conform to EmealDelegate
and call beginNFCSession
.
class YourEmealHandler: EmealDelegate {
let emeal: Emeal
init() {
let strings = LocalizedEmealStrings(/*...*/)
emeal = Emeal(localizedStrings: strings)
emeal.delegate = self
// Call this to start the NFC session.
emeal.beginNFCSession()
}
func readData(currentBalance: Double, lastTransaction: Double) {
// Gets called on a successful scan.
}
func invalidate(with error: Error) {
// Called on errors.
}
}
It's even easier if you use ObservableEmeal
in your SwiftUI views. It could look something like this.
struct MyView: View {
@StateObject private var emeal = ObservableEmeal(localizedStrings: .init(/* ... */))
var body: some View {
VStack {
Text("Balance: \(emeal.currentBalance ?? 0.0)")
Text("Last Transaction: \(emeal.lastTransaction ?? 0.0)")
if let error = emeal.error {
Text(error.localizedDescription)
.foregroundColor(.red)
}
Button(action: emeal.beginNFCSession) {
Text("Scan Emeal")
}
}
}
}
EmealKit is available through Swift Package Manager.
.package(url: "https://github.com/kiliankoe/EmealKit.git", from: "<#latest#>")
This library is currently being used in the following applications:
Know of any others? Please open a PR and add it to the list! 😊