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,219 @@
+/*! @file OIDURLQueryComponent.m
+    @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 "OIDURLQueryComponent.h"
+
+BOOL gOIDURLQueryComponentForceIOS7Handling = NO;
+
+/*! @brief String representing the set of characters that are valid for the URL query
+        (per @ NSCharacterSet.URLQueryAllowedCharacterSet), but are disallowed in URL query
+        parameters and values.
+ */
+static NSString *const kQueryStringParamAdditionalDisallowedCharacters = @"=&+";
+
+@implementation OIDURLQueryComponent {
+  /*! @brief A dictionary of parameter names and values representing the contents of the query.
+   */
+  NSMutableDictionary<NSString *, NSMutableArray<NSString *> *> *_parameters;
+}
+
+- (nullable instancetype)init {
+  self = [super init];
+  if (self) {
+    _parameters = [NSMutableDictionary dictionary];
+  }
+  return self;
+}
+
+- (nullable instancetype)initWithURL:(NSURL *)URL {
+  self = [self init];
+  if (self) {
+    if (@available(iOS 8.0, macOS 10.10, *)) {
+      // If NSURLQueryItem is available, use it for deconstructing the new URL. (iOS 8+)
+      if (!gOIDURLQueryComponentForceIOS7Handling) {
+        NSURLComponents *components =
+            [NSURLComponents componentsWithURL:URL resolvingAgainstBaseURL:NO];
+        // As OAuth uses application/x-www-form-urlencoded encoding, interprets '+' as a space
+        // in addition to regular percent decoding. https://url.spec.whatwg.org/#urlencoded-parsing
+        components.percentEncodedQuery =
+            [components.percentEncodedQuery stringByReplacingOccurrencesOfString:@"+"
+                                                                      withString:@"%20"];
+        // NB. @c queryItems are already percent decoded
+        NSArray<NSURLQueryItem *> *queryItems = components.queryItems;
+        for (NSURLQueryItem *queryItem in queryItems) {
+          [self addParameter:queryItem.name value:queryItem.value];
+        }
+        return self;
+      }
+    }
+    
+    // Fallback for iOS 7
+    NSString *query = URL.query;
+    // As OAuth uses application/x-www-form-urlencoded encoding, interprets '+' as a space
+    // in addition to regular percent decoding. https://url.spec.whatwg.org/#urlencoded-parsing
+    query = [query stringByReplacingOccurrencesOfString:@"+" withString:@"%20"];
+
+    NSArray<NSString *> *queryParts = [query componentsSeparatedByString:@"&"];
+    for (NSString *queryPart in queryParts) {
+      NSRange equalsRange = [queryPart rangeOfString:@"="];
+      if (equalsRange.location == NSNotFound) {
+        continue;
+      }
+      NSString *name = [queryPart substringToIndex:equalsRange.location];
+      name = name.stringByRemovingPercentEncoding;
+      NSString *value = [queryPart substringFromIndex:equalsRange.location + equalsRange.length];
+      value = value.stringByRemovingPercentEncoding;
+      [self addParameter:name value:value];
+    }
+    return self;
+  }
+  return self;
+}
+
+- (NSArray<NSString *> *)parameters {
+  return _parameters.allKeys;
+}
+
+- (NSDictionary<NSString *, NSObject<NSCopying> *> *)dictionaryValue {
+  // This method will flatten arrays in our @c _parameters' values if only one value exists.
+  NSMutableDictionary<NSString *, NSObject<NSCopying> *> *values = [NSMutableDictionary dictionary];
+  for (NSString *parameter in _parameters.allKeys) {
+    NSArray<NSString *> *value = _parameters[parameter];
+    if (value.count == 1) {
+      values[parameter] = [value.firstObject copy];
+    } else {
+      values[parameter] = [value copy];
+    }
+  }
+  return values;
+}
+
+- (NSArray<NSString *> *)valuesForParameter:(NSString *)parameter {
+  return _parameters[parameter];
+}
+
+- (void)addParameter:(NSString *)parameter value:(NSString *)value {
+  NSMutableArray<NSString *> *parameterValues = _parameters[parameter];
+  if (!parameterValues) {
+    parameterValues = [NSMutableArray array];
+    _parameters[parameter] = parameterValues;
+  }
+  [parameterValues addObject:value];
+}
+
+- (void)addParameters:(NSDictionary<NSString *, NSString *> *)parameters {
+  for (NSString *parameterName in parameters.allKeys) {
+    [self addParameter:parameterName value:parameters[parameterName]];
+  }
+}
+
+/*! @brief Builds a query items array that can be set to @c NSURLComponents.queryItems
+    @discussion The parameter names and values are NOT URL encoded.
+    @return An array of unencoded @c NSURLQueryItem objects.
+ */
+- (NSMutableArray<NSURLQueryItem *> *)queryItems NS_AVAILABLE(10.10, 8.0) {
+  NSMutableArray<NSURLQueryItem *> *queryParameters = [NSMutableArray array];
+  for (NSString *parameterName in _parameters.allKeys) {
+    NSArray<NSString *> *values = _parameters[parameterName];
+    for (NSString *value in values) {
+      NSURLQueryItem *item = [NSURLQueryItem queryItemWithName:parameterName value:value];
+      [queryParameters addObject:item];
+    }
+  }
+  return queryParameters;
+}
+
+ (NSMutableCharacterSet *)URLParamValueAllowedCharacters {
+  // Starts with the standard URL-allowed character set.
+  NSMutableCharacterSet *allowedParamCharacters =
+      [[NSCharacterSet URLQueryAllowedCharacterSet] mutableCopy];
+  // Removes additional characters we don't want to see in the query component.
+  [allowedParamCharacters removeCharactersInString:kQueryStringParamAdditionalDisallowedCharacters];
+  return allowedParamCharacters;
+}
+
+/*! @brief Builds a query string that can be set to @c NSURLComponents.percentEncodedQuery
+    @discussion This string is percent encoded, and shouldn't be used with
+        @c NSURLComponents.query.
+    @return An percentage encoded query string.
+ */
+- (NSString *)percentEncodedQueryString {
+  NSMutableArray<NSString *> *parameterizedValues = [NSMutableArray array];
+
+  // Starts with the standard URL-allowed character set.
+  NSMutableCharacterSet *allowedParamCharacters = [[self class] URLParamValueAllowedCharacters];
+
+  for (NSString *parameterName in _parameters.allKeys) {
+    NSString *encodedParameterName =
+        [parameterName stringByAddingPercentEncodingWithAllowedCharacters:allowedParamCharacters];
+
+    NSArray<NSString *> *values = _parameters[parameterName];
+    for (NSString *value in values) {
+      NSString *encodedValue =
+          [value stringByAddingPercentEncodingWithAllowedCharacters:allowedParamCharacters];
+      NSString *parameterizedValue =
+          [NSString stringWithFormat:@"%@=%@", encodedParameterName, encodedValue];
+      [parameterizedValues addObject:parameterizedValue];
+    }
+  }
+
+  NSString *queryString = [parameterizedValues componentsJoinedByString:@"&"];
+  return queryString;
+}
+
+- (NSString *)URLEncodedParameters {
+  // If NSURLQueryItem is available, uses it for constructing the encoded parameters. (iOS 8+)
+  if (@available(iOS 8.0, macOS 10.10, *)) {
+    if (!gOIDURLQueryComponentForceIOS7Handling) {
+      NSURLComponents *components = [[NSURLComponents alloc] init];
+      components.queryItems = [self queryItems];
+      NSString *encodedQuery = components.percentEncodedQuery;
+      // NSURLComponents.percentEncodedQuery creates a validly escaped URL query component, but
+      // doesn't encode the '+' leading to potential ambiguity with application/x-www-form-urlencoded
+      // encoding. Percent encodes '+' to avoid this ambiguity.
+      encodedQuery = [encodedQuery stringByReplacingOccurrencesOfString:@"+" withString:@"%2B"];
+      return encodedQuery;
+    }
+  }
+
+  // else, falls back to building query string manually (iOS 7)
+  return [self percentEncodedQueryString];
+}
+
+- (NSURL *)URLByReplacingQueryInURL:(NSURL *)URL {
+  NSURLComponents *components =
+      [NSURLComponents componentsWithURL:URL resolvingAgainstBaseURL:NO];
+
+  // Replaces encodedQuery component
+  NSString *queryString = [self URLEncodedParameters];
+  components.percentEncodedQuery = queryString;
+
+  NSURL *URLWithParameters = components.URL;
+  return URLWithParameters;
+}
+
+#pragma mark - NSObject overrides
+
+- (NSString *)description {
+  return [NSString stringWithFormat:@"<%@: %p, parameters: %@>",
+                                    NSStringFromClass([self class]),
+                                    (void *)self,
+                                    _parameters];
+}
+
+@end