putio-sdk-swift

Swift SDK for the put.io API

Swift Package: PutioSDK · CocoaPods package: PutioSDK

Installation

Install with Swift Package Manager in Xcode using:

https://github.com/putdotio/putio-sdk-swift.git

Or add it to Package.swift:

dependencies: [
    .package(url: "https://github.com/putdotio/putio-sdk-swift.git", from: "1.0.0")
]

Then depend on the PutioSDK product.

Import it as:

import PutioSDK

If you use CocoaPods today, install with:

pod 'PutioSDK'

Quick Start

import PutioSDK

let api = PutioSDK(
    config: PutioSDKConfig(
        clientID: "<your-client-id>",
        token: "<your-access-token>"
    )
)

api.getAccountInfo { result in
    switch result {
    case .success(let account):
        print(account.username)
    case .failure(let error):
        print(error.message)
    }
}

Verification

The repo exposes one local verification command:

make verify

Use make bootstrap first on a fresh clone. make verify installs the example workspace, prefers any Xcode-advertised iPhone simulator destination on iOS 26.0+, and falls back to the installed iphonesimulator SDK when Xcode is not exposing one yet

Releases are continuous on main: every merge is treated as releasable. Conventional commits drive version selection through semantic-release, GitHub releases run automatically after make verify passes, and CocoaPods publishing runs from the same workflow when COCOAPODS_TRUNK_TOKEN is configured

Authentication Example

The example app shows a minimal ASWebAuthenticationSession flow and a follow-up account fetch:

• Example/PutioSDK/ViewController.swift
• Example/README.md

Docs

• CONTRIBUTING.md for local setup and verification
• SECURITY.md for private vulnerability reporting
• AGENTS.md for repo-specific agent guidance
• Example for the example app and smoke-test workspace

Contributing

Start with CONTRIBUTING.md so local setup, verification, and release expectations stay aligned with CI

License

This project is available under the MIT License