GitHub - nerdishbynature/octokit.swift: A Swift API Client for GitHub and GitHub...
source link: https://github.com/nerdishbynature/octokit.swift
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
README.md
Octokit.swift
Installation
- Using Swift Package Manager:
import PackageDescription let package = Package( name: "MyAwesomeApp", dependencies: [ .Package(url: "https://github.com/nerdishbynature/octokit.swift", from: "0.8.0"), ] )
Authentication
Octokit supports both, Github and Github Enterprise. Authentication is handled using Configurations.
There are two types of Configurations, TokenConfiguration
and OAuthConfiguration
.
TokenConfiguration
TokenConfiguration
is used if you are using Access Token based Authentication (e.g. the user
offered you an access token he generated on the website) or if you got an Access Token through
the OAuth Flow
You can initialize a new config for github.com
as follows:
let config = TokenConfiguration(token: "12345")
or for Github Enterprise
let config = TokenConfiguration("12345", url: "https://github.example.com/api/v3/")
After you got your token you can use it with Octokit
Octokit(config).me() { response in switch response { case .success(let user): print(user.login) case .failure(let error): print(error) } }
OAuthConfiguration
OAuthConfiguration
is meant to be used, if you don't have an access token already and the
user has to login to your application. This also handles the OAuth flow.
You can authenticate an user for github.com
as follows:
let config = OAuthConfiguration(token: "<Your Client ID>", secret: "<Your Client secret>", scopes: ["repo", "read:org"]) let url = config.authenticate()
or for Github Enterprise
let config = OAuthConfiguration("https://github.example.com/api/v3/", webURL: "https://github.example.com/", token: "<Your Client ID>", secret: "<Your Client secret>", scopes: ["repo", "read:org"])
After you got your config you can authenticate the user:
// AppDelegate.swift config.authenticate() func application(application: UIApplication, openURL url: NSURL, sourceApplication: String?, annotation: AnyObject?) -> Bool { config.handleOpenURL(url) { config in self.loadCurrentUser(config) // purely optional of course } return false } func loadCurrentUser(config: TokenConfiguration) { Octokit(config).me() { response in switch response { case .success(let user): print(user.login) case .failure(let error): print(error) } } }
Please note that you will be given a TokenConfiguration
back from the OAuth flow.
You have to store the accessToken
yourself. If you want to make further requests it is not
necessary to do the OAuth Flow again. You can just use a TokenConfiguration
.
let token = // get your token from your keychain, user defaults (not recommended) etc. let config = TokenConfiguration(token) Octokit(config).user("octocat") { response in switch response { case .success(let user): print("User login: \(user.login!)") case .failure(let error): print("Error: \(error)") } }
Users
Get a single user
let username = ... // set the username Octokit().user(username) { response in switch response { case .success(let user): // do something with the user case .failure(let error): // handle any errors } }
Get the authenticated user
Octokit().me() { response in switch response { case .success(let user): // do something with the user case .failure(let error): // handle any errors }
Repositories
Get a single repository
let (owner, name) = ("owner", "name") // replace with actual owner and name Octokit().repository(owner, name) { response in switch response { case .success(let repository): // do something with the repository case .failure(let error): // handle any errors } }
Get repositories of authenticated user
Octokit().repositories() { response in switch response { case .success(let repository): // do something case .failure(let error): // handle any errors } }
Starred Repositories
Get starred repositories of some user
let username = "username" Octokit().stars(username) { response in switch response { case .success(let repositories): // do something with the repositories case .failure(let error): // handle any errors } }
Get starred repositories of authenticated user
Octokit().myStars() { response in switch response { case .success(let repositories): // do something with the repositories case .failure(let error): // handle any errors } }
Follower and Following
Get followers of some user
let username = "username" Octokit().followers(username) { response in switch response { case .success(let users): // do something with the users case .failure(let error): // handle any errors } }
Get followers of authenticated user
Octokit().myFollowers() { response in switch response { case .success(let users): // do something with the users case .failure(let error): // handle any errors } }
Get following of some user
let username = "username" Octokit().following(username) { response in switch response { case .success(let users): // do something with the users case .failure(let error): // handle any errors } }
Get following of authenticated user
Octokit().myFollowing() { response in switch response { case .success(let users): // do something with the users case .failure(let error): // handle any errors } }
Issues
Get issues of authenticated user
Get all issues across all the authenticated user's visible repositories including owned repositories, member repositories, and organization repositories.
Octokit(config).myIssues() { response in switch response { case .success(let issues): // do something with the issues case .failure: // handle any errors } }
Get a single issue
let (owner, repo, number) = ("owner", "repo", 1347) // replace with actual owner, repo name, and issue number Octokit(config).issue(owner, repository: repo, number: number) { response in switch response { case .success(let issue): // do something with the issue case .failure: // handle any errors } }
Open a new issue
Octokit(config).postIssue("owner", repository: "repo", title: "Found a bug", body: "I'm having a problem with this.", assignee: "octocat") { response in switch response { case .success(let issue): // do something with the issue case .failure: // handle any errors } }
Edit an existing issue
Octokit(config).patchIssue("owner", repository: "repo", number: 1347, title: "Found a bug", body: "I'm having a problem with this.", assignee: "octocat", state: .Closed) { response in switch response { case .success(let issue): // do something with the issue case .failure: // handle any errors } }
Pull requests
Get a single pull request
let task = Octokit().pullRequest(session, owner: "octocat", repository: "Hello-World", number: 1) { response in switch response { case .success(let pullRequests): // do something with a pull request case .failure: // handle any errors } }
List a pull requests
let task = Octokit().pullRequests(session, owner: "octocat", repository: "Hello-World", base: "develop", state: Openness.Open) { response in switch response { case .success(let pullRequests): // do something with a pull request list case .failure: // handle any errors } }
Recommend
About Joyk
Aggregate valuable and interesting links.
Joyk means Joy of geeK