Foundation/URLProtectionSpace.swift - third_party/swift-corelibs-foundation - Git at Google

 // This source file is part of the Swift.org open source project
 //
 // Copyright (c) 2014 - 2016 Apple Inc. and the Swift project authors
 // Licensed under Apache License v2.0 with Runtime Library Exception
 //
 // See http://swift.org/LICENSE.txt for license information
 // See http://swift.org/CONTRIBUTORS.txt for the list of Swift project authors
 //

 #if os(macOS) || os(iOS) || os(watchOS) || os(tvOS)
 import SwiftFoundation
 #else
 import Foundation
 #endif

 /*!
    @const NSURLProtectionSpaceHTTP
    @abstract The protocol for HTTP
 */
 public let NSURLProtectionSpaceHTTP: String = "NSURLProtectionSpaceHTTP"

 /*!
    @const NSURLProtectionSpaceHTTPS
    @abstract The protocol for HTTPS
 */
 public let NSURLProtectionSpaceHTTPS: String = "NSURLProtectionSpaceHTTPS"

 /*!
    @const NSURLProtectionSpaceFTP
    @abstract The protocol for FTP
 */
 public let NSURLProtectionSpaceFTP: String = "NSURLProtectionSpaceFTP"

 /*!
     @const NSURLProtectionSpaceHTTPProxy
     @abstract The proxy type for http proxies
 */
 public let NSURLProtectionSpaceHTTPProxy: String = "NSURLProtectionSpaceHTTPProxy"

 /*!
     @const NSURLProtectionSpaceHTTPSProxy
     @abstract The proxy type for https proxies
 */
 public let NSURLProtectionSpaceHTTPSProxy: String = "NSURLProtectionSpaceHTTPSProxy"

 /*!
     @const NSURLProtectionSpaceFTPProxy
     @abstract The proxy type for ftp proxies
 */
 public let NSURLProtectionSpaceFTPProxy: String = "NSURLProtectionSpaceFTPProxy"

 /*!
     @const NSURLProtectionSpaceSOCKSProxy
     @abstract The proxy type for SOCKS proxies
 */
 public let NSURLProtectionSpaceSOCKSProxy: String = "NSURLProtectionSpaceSOCKSProxy"

 /*!
     @const NSURLAuthenticationMethodDefault
     @abstract The default authentication method for a protocol
 */
 public let NSURLAuthenticationMethodDefault: String = "NSURLAuthenticationMethodDefault"

 /*!
     @const NSURLAuthenticationMethodHTTPBasic
     @abstract HTTP basic authentication. Equivalent to
     NSURLAuthenticationMethodDefault for http.
 */
 public let NSURLAuthenticationMethodHTTPBasic: String = "NSURLAuthenticationMethodHTTPBasic"

 /*!
     @const NSURLAuthenticationMethodHTTPDigest
     @abstract HTTP digest authentication.
 */
 public let NSURLAuthenticationMethodHTTPDigest: String = "NSURLAuthenticationMethodHTTPDigest"

 /*!
     @const NSURLAuthenticationMethodHTMLForm
     @abstract HTML form authentication. Applies to any protocol.
 */
 public let NSURLAuthenticationMethodHTMLForm: String = "NSURLAuthenticationMethodHTMLForm"

 /*!
    @const NSURLAuthenticationMethodNTLM
    @abstract NTLM authentication.
 */
 public let NSURLAuthenticationMethodNTLM: String = "NSURLAuthenticationMethodNTLM"

 /*!
    @const NSURLAuthenticationMethodNegotiate
    @abstract Negotiate authentication.
 */
 public let NSURLAuthenticationMethodNegotiate: String = "NSURLAuthenticationMethodNegotiate"

 /*!
     @const NSURLAuthenticationMethodClientCertificate
     @abstract SSL Client certificate.  Applies to any protocol.
  */
 @available(*, deprecated, message: "swift-corelibs-foundation does not currently support certificate authentication.")
 public let NSURLAuthenticationMethodClientCertificate: String = "NSURLAuthenticationMethodClientCertificate"

 /*!
     @const NSURLAuthenticationMethodServerTrust
     @abstract SecTrustRef validation required.  Applies to any protocol.
  */
 @available(*, deprecated, message: "swift-corelibs-foundation does not support methods of authentication that rely on the Darwin Security framework.")
 public let NSURLAuthenticationMethodServerTrust: String = "NSURLAuthenticationMethodServerTrust"


 /*!
     @class URLProtectionSpace
     @discussion This class represents a protection space requiring authentication.
 */
 open class URLProtectionSpace : NSObject, NSCopying {

     private let _host: String
     private let _isProxy: Bool
     private let _proxyType: String?
     private let _port: Int
     private let _protocol: String?
     private let _realm: String?
     private let _authenticationMethod: String

     open override func copy() -> Any {
         return copy(with: nil)
     }

     open func copy(with zone: NSZone? = nil) -> Any {
         return self // These instances are immutable.
     }

     /*!
         @method initWithHost:port:protocol:realm:authenticationMethod:
         @abstract Initialize a protection space representing an origin server, or a realm on one
         @param host The hostname of the server
         @param port The port for the server
         @param protocol The sprotocol for this server - e.g. "http", "ftp", "https"
         @param realm A string indicating a protocol-specific subdivision
         of a single host. For http and https, this maps to the realm
         string in http authentication challenges. For many other protocols
         it is unused.
         @param authenticationMethod The authentication method to use to access this protection space -
         valid values include nil (default method), @"digest" and @"form".
         @result The initialized object.
     */
     public init(host: String, port: Int, protocol: String?, realm: String?, authenticationMethod: String?) {
         _host = host
         _port = port
         _protocol = `protocol`
         _realm = realm
         _authenticationMethod = authenticationMethod ?? NSURLAuthenticationMethodDefault
         _proxyType = nil
         _isProxy = false
     }

     /*!
         @method initWithProxyHost:port:type:realm:authenticationMethod:
         @abstract Initialize a protection space representing a proxy server, or a realm on one
         @param host The hostname of the proxy server
         @param port The port for the proxy server
         @param type The type of proxy - e.g. "http", "ftp", "SOCKS"
         @param realm A string indicating a protocol-specific subdivision
         of a single host. For http and https, this maps to the realm
         string in http authentication challenges. For many other protocols
         it is unused.
         @param authenticationMethod The authentication method to use to access this protection space -
         valid values include nil (default method) and @"digest"
         @result The initialized object.
     */
     public init(proxyHost host: String, port: Int, type: String?, realm: String?, authenticationMethod: String?) {
         _host = host
         _port = port
         _proxyType = type
         _realm = realm
         _authenticationMethod = authenticationMethod ?? NSURLAuthenticationMethodDefault
         _isProxy = true
         _protocol = nil
     }

     /*!
         @method realm
         @abstract Get the authentication realm for which the protection space that
         needs authentication
         @discussion This is generally only available for http
         authentication, and may be nil otherwise.
         @result The realm string
     */
     open var realm: String? {
         return _realm
     }

     /*!
         @method receivesCredentialSecurely
         @abstract Determine if the password for this protection space can be sent securely
         @result YES if a secure authentication method or protocol will be used, NO otherwise
     */
     open var receivesCredentialSecurely: Bool {
         switch self.protocol {
         // The documentation is ambiguous whether a protection space needs to use the NSURLProtectionSpace… constants, or URL schemes.
         // Allow both.
         case NSURLProtectionSpaceHTTPS: fallthrough
         case "https": fallthrough
         case "ftps":
             return true

         default:
             switch authenticationMethod {
             case NSURLAuthenticationMethodDefault: fallthrough
             case NSURLAuthenticationMethodHTTPBasic: fallthrough
             case NSURLAuthenticationMethodHTTPDigest: fallthrough
             case NSURLAuthenticationMethodHTMLForm:
                 return false

             case NSURLAuthenticationMethodNTLM: fallthrough
             case NSURLAuthenticationMethodNegotiate: fallthrough
             case NSURLAuthenticationMethodClientCertificate: fallthrough
             case NSURLAuthenticationMethodServerTrust:
                 return true

             default:
                 return false
             }
         }
     }

     /*!
         @method host
         @abstract Get the proxy host if this is a proxy authentication, or the host from the URL.
         @result The host for this protection space.
     */
     open var host: String {
         return _host
     }

     /*!
         @method port
         @abstract Get the proxy port if this is a proxy authentication, or the port from the URL.
         @result The port for this protection space, or 0 if not set.
     */
     open var port: Int {
         return _port
     }

     /*!
         @method proxyType
         @abstract Get the type of this protection space, if a proxy
         @result The type string, or nil if not a proxy.
      */
     open var proxyType: String? {
         return _proxyType
     }

     /*!
         @method protocol
         @abstract Get the protocol of this protection space, if not a proxy
         @result The type string, or nil if a proxy.
     */
     open var `protocol`: String? {
         return _protocol
     }

     /*!
         @method authenticationMethod
         @abstract Get the authentication method to be used for this protection space
         @result The authentication method
     */
     open var authenticationMethod: String {
         return _authenticationMethod
     }

     /*!
         @method isProxy
         @abstract Determine if this authenticating protection space is a proxy server
         @result YES if a proxy, NO otherwise
     */
     open override func isProxy() -> Bool {
         return _isProxy
     }

     /*!
        A string that represents the contents of the URLProtectionSpace Object.
        This property is intended to produce readable output.
     */
     open override var description: String {
         let authMethods: Set<String> = [
             NSURLAuthenticationMethodDefault,
             NSURLAuthenticationMethodHTTPBasic,
             NSURLAuthenticationMethodHTTPDigest,
             NSURLAuthenticationMethodHTMLForm,
             NSURLAuthenticationMethodNTLM,
             NSURLAuthenticationMethodNegotiate,
             NSURLAuthenticationMethodClientCertificate,
             NSURLAuthenticationMethodServerTrust
         ]
         var result = "<\(type(of: self)) \(Unmanaged.passUnretained(self).toOpaque())>: "
         result += "Host:\(host), "

         if let prot = self.protocol {
             result += "Server:\(prot), "
         } else {
             result += "Server:(null), "
         }

         if authMethods.contains(self.authenticationMethod) {
             result += "Auth-Scheme:\(self.authenticationMethod), "
         } else {
             result += "Auth-Scheme:NSURLAuthenticationMethodDefault, "
         }

         if let realm = self.realm {
             result += "Realm:\(realm), "
         } else {
             result += "Realm:(null), "
         }

         result += "Port:\(self.port), "

         if _isProxy {
             result += "Proxy:YES, "
         } else {
             result += "Proxy:NO, "
         }

         if let proxyType = self.proxyType {
             result += "Proxy-Type:\(proxyType), "
         } else {
             result += "Proxy-Type:(null)"
         }
         return result
     }
 }

 extension URLProtectionSpace {
     //an internal helper to create a URLProtectionSpace from a HTTPURLResponse
     static func create(using response: HTTPURLResponse) -> URLProtectionSpace {
         let host = response.url?.host ?? ""
         let port = response.url?.port ?? 80        //HTTP
         let _protocol = response.url?.scheme
         guard let wwwAuthHeader = response.allHeaderFields["Www-Authenticate"] as? String else {
             fatalError("Authentication failed but no Www-Authenticate header in response")
         }

         //The format of the authentication header is `<auth-scheme> realm="<realm value>"`
         //Example: `Basic realm="Fake Realm"`
         let authMethod = wwwAuthHeader.components(separatedBy: " ")[0]
         let realm = String(String(wwwAuthHeader.components(separatedBy: "realm=")[1].dropFirst()).dropLast())
         return URLProtectionSpace(host: host, port: port, protocol: _protocol, realm: realm, authenticationMethod: authMethod)
     }
 }

 extension URLProtectionSpace {

     /*!
         @method distinguishedNames
         @abstract Returns an array of acceptable certificate issuing authorities for client certification authentication. Issuers are identified by their distinguished name and returned as a DER encoded data.
         @result An array of NSData objects.  (Nil if the authenticationMethod is not NSURLAuthenticationMethodClientCertificate)
      */
     @available(*, deprecated, message: "swift-corelibs-foundation does not currently support certificate authentication.")
     public var distinguishedNames: [Data]? { return nil }

     /*!
         @method serverTrust
         @abstract Returns a SecTrustRef which represents the state of the servers SSL transaction state
         @result A SecTrustRef from Security.framework.  (Nil if the authenticationMethod is not NSURLAuthenticationMethodServerTrust)
      */
     @available(*, unavailable, message: "swift-corelibs-foundation does not support methods of authentication that rely on the Darwin Security framework.")
     public var serverTrust: Any? { NSUnsupported() }
 }
	// This source file is part of the Swift.org open source project
	//
	// Copyright (c) 2014 - 2016 Apple Inc. and the Swift project authors
	// Licensed under Apache License v2.0 with Runtime Library Exception
	//
	// See http://swift.org/LICENSE.txt for license information
	// See http://swift.org/CONTRIBUTORS.txt for the list of Swift project authors
	//

	#if os(macOS) \|\| os(iOS) \|\| os(watchOS) \|\| os(tvOS)
	import SwiftFoundation
	#else
	import Foundation
	#endif

	/*!
	@const NSURLProtectionSpaceHTTP
	@abstract The protocol for HTTP
	*/
	public let NSURLProtectionSpaceHTTP: String = "NSURLProtectionSpaceHTTP"

	/*!
	@const NSURLProtectionSpaceHTTPS
	@abstract The protocol for HTTPS
	*/
	public let NSURLProtectionSpaceHTTPS: String = "NSURLProtectionSpaceHTTPS"

	/*!
	@const NSURLProtectionSpaceFTP
	@abstract The protocol for FTP
	*/
	public let NSURLProtectionSpaceFTP: String = "NSURLProtectionSpaceFTP"

	/*!
	@const NSURLProtectionSpaceHTTPProxy
	@abstract The proxy type for http proxies
	*/
	public let NSURLProtectionSpaceHTTPProxy: String = "NSURLProtectionSpaceHTTPProxy"

	/*!
	@const NSURLProtectionSpaceHTTPSProxy
	@abstract The proxy type for https proxies
	*/
	public let NSURLProtectionSpaceHTTPSProxy: String = "NSURLProtectionSpaceHTTPSProxy"

	/*!
	@const NSURLProtectionSpaceFTPProxy
	@abstract The proxy type for ftp proxies
	*/
	public let NSURLProtectionSpaceFTPProxy: String = "NSURLProtectionSpaceFTPProxy"

	/*!
	@const NSURLProtectionSpaceSOCKSProxy
	@abstract The proxy type for SOCKS proxies
	*/
	public let NSURLProtectionSpaceSOCKSProxy: String = "NSURLProtectionSpaceSOCKSProxy"

	/*!
	@const NSURLAuthenticationMethodDefault
	@abstract The default authentication method for a protocol
	*/
	public let NSURLAuthenticationMethodDefault: String = "NSURLAuthenticationMethodDefault"

	/*!
	@const NSURLAuthenticationMethodHTTPBasic
	@abstract HTTP basic authentication. Equivalent to
	NSURLAuthenticationMethodDefault for http.
	*/
	public let NSURLAuthenticationMethodHTTPBasic: String = "NSURLAuthenticationMethodHTTPBasic"

	/*!
	@const NSURLAuthenticationMethodHTTPDigest
	@abstract HTTP digest authentication.
	*/
	public let NSURLAuthenticationMethodHTTPDigest: String = "NSURLAuthenticationMethodHTTPDigest"

	/*!
	@const NSURLAuthenticationMethodHTMLForm
	@abstract HTML form authentication. Applies to any protocol.
	*/
	public let NSURLAuthenticationMethodHTMLForm: String = "NSURLAuthenticationMethodHTMLForm"

	/*!
	@const NSURLAuthenticationMethodNTLM
	@abstract NTLM authentication.
	*/
	public let NSURLAuthenticationMethodNTLM: String = "NSURLAuthenticationMethodNTLM"

	/*!
	@const NSURLAuthenticationMethodNegotiate
	@abstract Negotiate authentication.
	*/
	public let NSURLAuthenticationMethodNegotiate: String = "NSURLAuthenticationMethodNegotiate"

	/*!
	@const NSURLAuthenticationMethodClientCertificate
	@abstract SSL Client certificate. Applies to any protocol.
	*/
	@available(*, deprecated, message: "swift-corelibs-foundation does not currently support certificate authentication.")
	public let NSURLAuthenticationMethodClientCertificate: String = "NSURLAuthenticationMethodClientCertificate"

	/*!
	@const NSURLAuthenticationMethodServerTrust
	@abstract SecTrustRef validation required. Applies to any protocol.
	*/
	@available(*, deprecated, message: "swift-corelibs-foundation does not support methods of authentication that rely on the Darwin Security framework.")
	public let NSURLAuthenticationMethodServerTrust: String = "NSURLAuthenticationMethodServerTrust"


	/*!
	@class URLProtectionSpace
	@discussion This class represents a protection space requiring authentication.
	*/
	open class URLProtectionSpace : NSObject, NSCopying {

	private let _host: String
	private let _isProxy: Bool
	private let _proxyType: String?
	private let _port: Int
	private let _protocol: String?
	private let _realm: String?
	private let _authenticationMethod: String

	open override func copy() -> Any {
	return copy(with: nil)
	}

	open func copy(with zone: NSZone? = nil) -> Any {
	return self // These instances are immutable.
	}

	/*!
	@method initWithHost:port:protocol:realm:authenticationMethod:
	@abstract Initialize a protection space representing an origin server, or a realm on one
	@param host The hostname of the server
	@param port The port for the server
	@param protocol The sprotocol for this server - e.g. "http", "ftp", "https"
	@param realm A string indicating a protocol-specific subdivision
	of a single host. For http and https, this maps to the realm
	string in http authentication challenges. For many other protocols
	it is unused.
	@param authenticationMethod The authentication method to use to access this protection space -
	valid values include nil (default method), @"digest" and @"form".
	@result The initialized object.
	*/
	public init(host: String, port: Int, protocol: String?, realm: String?, authenticationMethod: String?) {
	_host = host
	_port = port
	_protocol = `protocol`
	_realm = realm
	_authenticationMethod = authenticationMethod ?? NSURLAuthenticationMethodDefault
	_proxyType = nil
	_isProxy = false
	}

	/*!
	@method initWithProxyHost:port:type:realm:authenticationMethod:
	@abstract Initialize a protection space representing a proxy server, or a realm on one
	@param host The hostname of the proxy server
	@param port The port for the proxy server
	@param type The type of proxy - e.g. "http", "ftp", "SOCKS"
	@param realm A string indicating a protocol-specific subdivision
	of a single host. For http and https, this maps to the realm
	string in http authentication challenges. For many other protocols
	it is unused.
	@param authenticationMethod The authentication method to use to access this protection space -
	valid values include nil (default method) and @"digest"
	@result The initialized object.
	*/
	public init(proxyHost host: String, port: Int, type: String?, realm: String?, authenticationMethod: String?) {
	_host = host
	_port = port
	_proxyType = type
	_realm = realm
	_authenticationMethod = authenticationMethod ?? NSURLAuthenticationMethodDefault
	_isProxy = true
	_protocol = nil
	}

	/*!
	@method realm
	@abstract Get the authentication realm for which the protection space that
	needs authentication
	@discussion This is generally only available for http
	authentication, and may be nil otherwise.
	@result The realm string
	*/
	open var realm: String? {
	return _realm
	}

	/*!
	@method receivesCredentialSecurely
	@abstract Determine if the password for this protection space can be sent securely
	@result YES if a secure authentication method or protocol will be used, NO otherwise
	*/
	open var receivesCredentialSecurely: Bool {
	switch self.protocol {
	// The documentation is ambiguous whether a protection space needs to use the NSURLProtectionSpace… constants, or URL schemes.
	// Allow both.
	case NSURLProtectionSpaceHTTPS: fallthrough
	case "https": fallthrough
	case "ftps":
	return true

	default:
	switch authenticationMethod {
	case NSURLAuthenticationMethodDefault: fallthrough
	case NSURLAuthenticationMethodHTTPBasic: fallthrough
	case NSURLAuthenticationMethodHTTPDigest: fallthrough
	case NSURLAuthenticationMethodHTMLForm:
	return false

	case NSURLAuthenticationMethodNTLM: fallthrough
	case NSURLAuthenticationMethodNegotiate: fallthrough
	case NSURLAuthenticationMethodClientCertificate: fallthrough
	case NSURLAuthenticationMethodServerTrust:
	return true

	default:
	return false
	}
	}
	}

	/*!
	@method host
	@abstract Get the proxy host if this is a proxy authentication, or the host from the URL.
	@result The host for this protection space.
	*/
	open var host: String {
	return _host
	}

	/*!
	@method port
	@abstract Get the proxy port if this is a proxy authentication, or the port from the URL.
	@result The port for this protection space, or 0 if not set.
	*/
	open var port: Int {
	return _port
	}

	/*!
	@method proxyType
	@abstract Get the type of this protection space, if a proxy
	@result The type string, or nil if not a proxy.
	*/
	open var proxyType: String? {
	return _proxyType
	}

	/*!
	@method protocol
	@abstract Get the protocol of this protection space, if not a proxy
	@result The type string, or nil if a proxy.
	*/
	open var `protocol`: String? {
	return _protocol
	}

	/*!
	@method authenticationMethod
	@abstract Get the authentication method to be used for this protection space
	@result The authentication method
	*/
	open var authenticationMethod: String {
	return _authenticationMethod
	}

	/*!
	@method isProxy
	@abstract Determine if this authenticating protection space is a proxy server
	@result YES if a proxy, NO otherwise
	*/
	open override func isProxy() -> Bool {
	return _isProxy
	}

	/*!
	A string that represents the contents of the URLProtectionSpace Object.
	This property is intended to produce readable output.
	*/
	open override var description: String {
	let authMethods: Set<String> = [
	NSURLAuthenticationMethodDefault,
	NSURLAuthenticationMethodHTTPBasic,
	NSURLAuthenticationMethodHTTPDigest,
	NSURLAuthenticationMethodHTMLForm,
	NSURLAuthenticationMethodNTLM,
	NSURLAuthenticationMethodNegotiate,
	NSURLAuthenticationMethodClientCertificate,
	NSURLAuthenticationMethodServerTrust
	]
	var result = "<\(type(of: self)) \(Unmanaged.passUnretained(self).toOpaque())>: "
	result += "Host:\(host), "

	if let prot = self.protocol {
	result += "Server:\(prot), "
	} else {
	result += "Server:(null), "
	}

	if authMethods.contains(self.authenticationMethod) {
	result += "Auth-Scheme:\(self.authenticationMethod), "
	} else {
	result += "Auth-Scheme:NSURLAuthenticationMethodDefault, "
	}

	if let realm = self.realm {
	result += "Realm:\(realm), "
	} else {
	result += "Realm:(null), "
	}

	result += "Port:\(self.port), "

	if _isProxy {
	result += "Proxy:YES, "
	} else {
	result += "Proxy:NO, "
	}

	if let proxyType = self.proxyType {
	result += "Proxy-Type:\(proxyType), "
	} else {
	result += "Proxy-Type:(null)"
	}
	return result
	}
	}

	extension URLProtectionSpace {
	//an internal helper to create a URLProtectionSpace from a HTTPURLResponse
	static func create(using response: HTTPURLResponse) -> URLProtectionSpace {
	let host = response.url?.host ?? ""
	let port = response.url?.port ?? 80 //HTTP
	let _protocol = response.url?.scheme
	guard let wwwAuthHeader = response.allHeaderFields["Www-Authenticate"] as? String else {
	fatalError("Authentication failed but no Www-Authenticate header in response")
	}

	//The format of the authentication header is `<auth-scheme> realm="<realm value>"`
	//Example: `Basic realm="Fake Realm"`
	let authMethod = wwwAuthHeader.components(separatedBy: " ")[0]
	let realm = String(String(wwwAuthHeader.components(separatedBy: "realm=")[1].dropFirst()).dropLast())
	return URLProtectionSpace(host: host, port: port, protocol: _protocol, realm: realm, authenticationMethod: authMethod)
	}
	}

	extension URLProtectionSpace {

	/*!
	@method distinguishedNames
	@abstract Returns an array of acceptable certificate issuing authorities for client certification authentication. Issuers are identified by their distinguished name and returned as a DER encoded data.
	@result An array of NSData objects. (Nil if the authenticationMethod is not NSURLAuthenticationMethodClientCertificate)
	*/
	@available(*, deprecated, message: "swift-corelibs-foundation does not currently support certificate authentication.")
	public var distinguishedNames: [Data]? { return nil }

	/*!
	@method serverTrust
	@abstract Returns a SecTrustRef which represents the state of the servers SSL transaction state
	@result A SecTrustRef from Security.framework. (Nil if the authenticationMethod is not NSURLAuthenticationMethodServerTrust)
	*/
	@available(*, unavailable, message: "swift-corelibs-foundation does not support methods of authentication that rely on the Darwin Security framework.")
	public var serverTrust: Any? { NSUnsupported() }
	}