Repository files navigation

A simple wrapper around put.io api. PutioKit wraps all available endpoints and provides an easy and typesafe way to interact with it.Supports:

• macOS(>=10.15)
• iOS(>=13.0)
• iPadOS(>=13.0)
• watchOS(>=6.0)
• tvOS(>=13.0)

Add the following in thedependencies array in Package.swift

.package(url: "https://github.com/ipavlidakis/PutioKit.git", from: "1.0.0")

The kit is splitting the available endpoints from the API into seperate services: Currently you can find the following available services:

• Account
• Authentication
• Config
• Events
• Files
• Friends
• RSS
• Shares
• Transfers
• Zip

Each services requires 3 things:

1. An instance of theApiClientModel
2. An instance conforming to theNetworkHandling protocol
3. An instance confroming to theCredentialsStoring protocol

TheApiClientModel struct represents your put.io application. It contains values like:

• id
• secret
• name

TheApiClientModel is used to fill in the required information to communicate with the API.

The instance that will passed to the services will be used to perform all the network operations. The object is responsible to provide - additionally to the task execution role - a jsonDecoder responsible to parse the data received from the API but also adecode method that is used to seperate the different types of available results that may happen per request (e.g on a response for a File object the response may error. In that case the result is anErrorModel. The decode method inURLSession is already hanlind those cases for you, so it can always return a meaningful result)

For ease of use,URLSession conforms toNetworkHandling

The instance that will passed to the service will be used to as a provider for the access token, required to communicate with the API

• Write documentation
• Provide a playground app
• Setup actions on the repo
• Write unit tests
• Implement retry logic on failures
• Add progress on uploadTasks
• Add progress on dataTasks

Ilias Pavlidakis

• mail
• twitter

PutioKit is released under the MIT license. See LICENSE for details.