adding pods method of package managing

2021-12-13 12:34:20 -08:00
parent dad674aca7
commit 705203d7bd
5871 changed files with 1259393 additions and 3 deletions
@@ -0,0 +1,93 @@
+/*! @file OIDURLQueryComponent.h
+    @brief AppAuth iOS SDK
+    @copyright
+        Copyright 2015 Google Inc. All Rights Reserved.
+    @copydetails
+        Licensed under the Apache License, Version 2.0 (the "License");
+        you may not use this file except in compliance with the License.
+        You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+        Unless required by applicable law or agreed to in writing, software
+        distributed under the License is distributed on an "AS IS" BASIS,
+        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+        See the License for the specific language governing permissions and
+        limitations under the License.
+ */
+
+#import <Foundation/Foundation.h>
+
+@class OIDAuthorizationRequest;
+
+NS_ASSUME_NONNULL_BEGIN
+
+/*! @brief If set to YES, will force the iOS 7-only code for @c OIDURLQueryComponent to be used,
+        even on non-iOS 7 devices and simulators. Useful for testing the iOS 7 code paths on the
+        simulator. Defaults to NO.
+ */
+extern BOOL gOIDURLQueryComponentForceIOS7Handling;
+
+/*! @brief A utility class for creating and parsing URL query components encoded with the
+        application/x-www-form-urlencoded format.
+    @description Supports application/x-www-form-urlencoded encoding and decoding, specifically
+        '+' is replaced with space before percent decoding. For encoding, simply percent encodes
+        space, as this is valid application/x-www-form-urlencoded.
+    @see https://tools.ietf.org/html/rfc6749#section-4.1.2
+    @see https://tools.ietf.org/html/rfc6749#section-4.1.3
+    @see https://tools.ietf.org/html/rfc6749#appendix-B
+    @see https://url.spec.whatwg.org/#urlencoded-parsing
+ */
+@interface OIDURLQueryComponent : NSObject
+
+/*! @brief The parameter names in the query.
+ */
+@property(nonatomic, readonly) NSArray<NSString *> *parameters;
+
+/*! @brief The parameters represented as a dictionary.
+    @remarks All values are @c NSString except for parameters which contain multiple values, in
+        which case the value is an @c NSArray<NSString *> *.
+ */
+@property(nonatomic, readonly) NSDictionary<NSString *, NSObject<NSCopying> *> *dictionaryValue;
+
+/*! @brief Creates an @c OIDURLQueryComponent by parsing the query string in a URL.
+    @param URL The URL from which to extract a query component.
+ */
+- (nullable instancetype)initWithURL:(NSURL *)URL;
+
+/*! @brief The value (or values) for a named parameter in the query.
+    @param parameter The parameter name. Case sensitive.
+    @return The value (or values) for a named parameter in the query.
+ */
+- (NSArray<NSString *> *)valuesForParameter:(NSString *)parameter;
+
+/*! @brief Adds a parameter value to the query.
+    @param parameter The name of the parameter. Case sensitive.
+    @param value The value to add.
+ */
+- (void)addParameter:(NSString *)parameter value:(NSString *)value;
+
+/*! @brief Adds multiple parameters with associated values to the query.
+    @param parameters The parameter name value pairs to add to the query.
+ */
+- (void)addParameters:(NSDictionary<NSString *, NSString *> *)parameters;
+
+/*! @param URL The URL to add the query component to.
+    @return The original URL with the query component replaced by the parameters from this query.
+ */
+- (NSURL *)URLByReplacingQueryInURL:(NSURL *)URL;
+
+/*! @brief Builds an x-www-form-urlencoded string representing the parameters.
+    @return The x-www-form-urlencoded string representing the parameters.
+ */
+- (NSString *)URLEncodedParameters;
+
+/*! @brief A NSMutableCharacterSet containing allowed characters in URL parameter values (that is
+        the "value" part of "?key=value"). This has less allowed characters than
+        @c URLQueryAllowedCharacterSet, as the query component includes both the key & value.
+ */
+ (NSMutableCharacterSet *)URLParamValueAllowedCharacters;
+
+@end
+
+NS_ASSUME_NONNULL_END