Athena is a library that provides type-safe APIs for working with JSON objects in Swift. It provides an idiomatic solution that is both faster and easier to use than Foundation’s JSONSerialization API. It takes advantage of modern Swift language features, and provides APIs for easily creating, mutating, serializing, and deserializing JSON values. It also provides a system to easily encode other Swift types into a JSON representation and decode those same types from correctly shaped JSON values.
Athena is based on Freddy, an early library for working with JSON in Swift that is no longer maintained by its original authors. The library itself has no non-Apple dependencies, but the package does use the SwiftFormat and DocC Swift Package Manager plugins.
To add Athena as a dependency to an Xcode Project:
Choose File → Add Packages...
Enter package URL https://github.com/vsanthanam/Athena.git and select your release and of choice.
Other distribution mechanisms like CocoaPods or Carthage may be added in the future.
Usage & Documentation
Athena’s documentation is built with DocC and included in the repository as a DocC archive. The latest version is hosted on GitHub Pages and is available here.
Additional installation instructions are available on the Swift Package Index
Athena
Athena is a library that provides type-safe APIs for working with JSON objects in Swift. It provides an idiomatic solution that is both faster and easier to use than Foundation’s
JSONSerialization
API. It takes advantage of modern Swift language features, and provides APIs for easily creating, mutating, serializing, and deserializing JSON values. It also provides a system to easily encode other Swift types into a JSON representation and decode those same types from correctly shaped JSON values.Athena is based on Freddy, an early library for working with JSON in Swift that is no longer maintained by its original authors. The library itself has no non-Apple dependencies, but the package does use the SwiftFormat and DocC Swift Package Manager plugins.
Installation
Athena currently distributed exclusively through the Swift Package Manager.
To add Athena as a dependency to an existing Swift package, add the following line of code to the
dependencies
parameter of yourPackage.swift
file:To add Athena as a dependency to an Xcode Project:
File
→Add Packages...
https://github.com/vsanthanam/Athena.git
and select your release and of choice.Other distribution mechanisms like CocoaPods or Carthage may be added in the future.
Usage & Documentation
Athena’s documentation is built with DocC and included in the repository as a DocC archive. The latest version is hosted on GitHub Pages and is available here.
Additional installation instructions are available on the Swift Package Index
Explore the documentation for more details.
License
Athena is available under the MIT license. See the LICENSE file for more information.