Swiftでライブラリを書く際のプラクティス

Swiftでライブラリ（人から使われるコード）を書く際のベストプラクティスを考える

Transcript

1. 4XJGU੡ϥΠϒϥϦͷ
   ྑ͍ॻ͖ํΛߟ͑Δ
2. kishikawa katsumi http://kishikawakatsumi.com Twitter @k_katsumi https://github.com/kishikawakatsumi http://kishikawakatsumi.hatenablog.com
6. let keychain = Keychain(service: "com.example.github-token") keychain["kishikawakatsumi"] = "01234567-89ab-...abcdef" let token = keychain["kishikawakatsumi"]
7. let keychain = Keychain(service: "com.example.github-token") keychain.set("01234567-...", key: “kishikawakatsumi") let token = keychain.get("kishikawakatsumi")
8. let keychain = Keychain(service: "com.example.github-token", accessGroup: “12ABCD3E4F.shared") keychain .accessibility(.AfterFirstUnlock) .synchronizable(true) .set("01234567-89ab-cdef-0123-456789abcdef", key: "kishikawakatsumi")
9. let keychain = Keychain(service: "com.example.github-token") dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0)) { keychain .accessibility(.WhenPasscodeSetThisDeviceOnly, authenticationPolicy: .UserPresence) .set("01234567-89ab-...", key: "kishikawakatsumi") }
10. 0CKFDUJWF$ͱͷҧ͍
11. Objective-Cͱͷҧ͍ • σʔλܕ • Optional • Φʔόʔϩʔυ • σϑΥϧτҾ਺ • ϝιουνΣʔϯ • Τϥʔॲཧ
12. σʔλܕ
13. σʔλܕ • Class • Struct • Enum • Tuple • Function • Array • Dictionary • Set *New* • Optional
14. 0QUJPOBM
15. public class func requestSharedWebCredential(completion: (credentials: [[String: Stri public class func requestSharedWebCredential(#domain: String, completion: (credential public class func requestSharedWebCredential(#domain: String, account: String, comple private class func requestSharedWebCredential(#domain: String?, account: String?, com
16. Φʔόʔϩʔυ
17. func set(value: String, key: String) -> NSError? func set(value: NSData, key: String) -> NSError?
18. func set(value: String, key: String) -> NSError? func set(value: NSData, key: String) -> NSError?
19. convenience init() convenience init(service: String) convenience init(accessGroup: String) convenience init(service: String, accessGroup: String) convenience init(server: String, protocolType: ProtocolType) convenience init(server: String, protocolType: ProtocolType, authenticationTy convenience init(server: NSURL, protocolType: ProtocolType) convenience init(server: NSURL, protocolType: ProtocolType, authenticationTyp
20. σϑΥϧτҾ਺
21. convenience init(service: String = "", accessGroup: String = "") convenience init(server: NSURL, protocolType: ProtocolType = .HTTPS, authenticationType: AuthenticationType = .HTMLForm)
22. ิ׬͕ΠϚΠν
23. convenience init(service: String = default, accessGroup: String = default) convenience init(server: NSURL, protocolType: KeychainAccess.ProtocolType = default, authenticationType: KeychainAccess.AuthenticationType = default) ࣮ࡍͷ஋΋Θ͔Βͳ͍
24. func setSharedPassword(password: String, account: String, completion: (error: NSError?) -> () = { e -> () in }) ྫ֎: Closure
25. ྫ֎: Closure keychain.setSharedPassword(password, account: username) keychain.setSharedPassword(password, account: username) { (error) -> () in println(error) }
26. ໭Γ஋ͷΦʔόʔϩʔυ
27. func get(key: String) -> String? func get(key: String) -> NSData?
29. let keychain = Keychain() let data: NSData? = keychain.get("somedata")
30. func getString(key: String) -> String? func getData(key: String) -> NSData?
31. func get(key: String) -> (asString: String?, asData: NSData?)
32. let keychain = Keychain() let string = keychain.get("somestring").asString
33. ϝιουνΣʔϯ
34. keychain .accessibility(.AfterFirstUnlock) .synchronizable(true) .set("01234567-89ab-...", key: "kishikawakatsumi") keychain .accessibility(.WhenUnlocked) .set("01234567-89ab-...", key: "kishikawakatsumi")
35. keychain = Keychain(server: "https://github.com", protocolType: .HTTPS) .label("github.com (kishikawakatsumi)") .comment("github access token") .set("01234567-89ab-...", key: "kishikawakatsumi") keychain = Keychain(server: "https://github.com", protocolType: .HTTPS) .label("github.com (Hiro Hamada)") .comment("github access token") .set("01234567-89ab-...", key: "hirohamada")
36. Τϥʔॲཧ
37. - (NSString *)stringForKey:(NSString *)key error:(NSError * __autoreleasing *)error;
38. &JUIFSܕ
39. // // Either.swift // swiftz // // Created by Maxwell Swadling on 3/06/2014. // Copyright (c) 2014 Maxwell Swadling. All rights reserved. // import class Foundation.NSError /// The Either type represents values with two possibilities: a value of type Either <A, B> is either /// Left <A> or Right <B>. /// /// The Either type is sometimes used to represent a value which is either correct or an error; by /// convention, the Left constructor is used to hold an error value and the Right constructor is /// used to hold a correct value (mnemonic: "right" also means "correct"). public enum Either<L, R> { case Left(Box<L>) case Right(Box<R>) /// Converts a Either to a Result, which is a more specialized type that /// contains an NSError or a value. public func toResult(ev : L -> NSError) -> Result<R> { return either({ e in Result.Error(ev(e)) }, { v in .Value(Box(v)) }); } /// Much like the ?? operator for Optional types, takes a value and a function, /// and if the Either is Left, returns the value, otherwise maps the function over /// the value in Right and returns that value. public func fold<B>(value : B, f : R -> B) -> B { return either({ _ in value }, { r in f(r) }); }
40. // // Result.swift // swiftz // // Created by Maxwell Swadling on 9/06/2014. // Copyright (c) 2014 Maxwell Swadling. All rights reserved. // import class Foundation.NSError import typealias Foundation.NSErrorPointer /// Result is similar to an Either, except specialized to have an Error case that can /// only contain an NSError. public enum Result<V> { case Error(NSError) case Value(Box<V>) public init(_ e: NSError?, _ v: V) { if let ex = e { self = Result.Error(ex) } else { self = Result.Value(Box(v)) } } /// Converts a Result to a more general Either type. public func toEither() -> Either<NSError, V> { switch self { case let Error(e): return .Left(Box(e)) case let Value(v): return Either.Right(Box(v.value)) } }
41. public enum FailableOf<T> { case Success(Value<T?>) case Failure(NSError) init(_ value: T?) { self = .Success(Value(value)) } init(_ error: NSError) { self = .Failure(error) } public var error: NSError? { switch self { case .Failure(let error): return error default: return nil } } public var value: T? { switch self { case .Success(let success): return success.value default: return nil } } }
42. let failable = keychain.getStringOrError("kishikawakatsumi") switch failable { case .Success: println("token: \(failable.value)") case .Failure: println("error: \(failable.error)") }
43. let failable = keychain.getStringOrError("kishikawakatsumi") if let error = failable.error { println("error: \(failable.error)") } else { println("token: \(failable.value)") }
44. let failable = keychain.getStringOrError("kishikawakatsumi") if failable.failed { println("error: \(failable.error)") } else { println("token: \(failable.value)") }
45. ඇಉظϝιουίʔϧόοΫ
46. keychain.getSharedPassword(username) { (password, error) -> () in if error != nil { } else { } }
47. ಉظϝιου໭Γ஋ͳ͠
48. let error = keychain.remove("kishikawakatsumi") if error != nil { println("error: \(error?.localizedDescription)") }
49. 1MBZHSPVOE
51. 'VODUJPOBM
    TUZMF
    "1*
52. IUUQTHJUIVCDPNUZQFMJGU4XJGUY IUUQTHJUIVCDPNUZQFMJGU4XJGU[