firebase-ios-sdk/Example/Storage/Tests/Unit/FIRStorageTestHelpers.h

/*
 * Copyright 2017 Google
 *
 * 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>
#import <OCMock/OCMock.h>
#import <XCTest/XCTest.h>

#import <FirebaseCore/FIRApp.h>
#import <FirebaseCore/FIROptions.h>

#import "FIRStorageConstants.h"
#import "FIRStorageConstants_Private.h"
#import "FIRStorageErrors.h"
#import "FIRStorageMetadata.h"
#import "FIRStorageReference.h"
#import "FIRStorageReference_Private.h"
#import "FIRStorageTask.h"
#import "FIRStorageTask_Private.h"
#import "FIRStorageTokenAuthorizer.h"
#import "FIRStorageUtils.h"

#import <GTMSessionFetcher/GTMSessionFetcher.h>

NS_ASSUME_NONNULL_BEGIN

FOUNDATION_EXPORT NSString *const kGoogleHTTPErrorDomain;
FOUNDATION_EXPORT NSString *const kHTTPVersion;
FOUNDATION_EXPORT NSString *const kUnauthenticatedResponseString;
FOUNDATION_EXPORT NSString *const kUnauthorizedResponseString;
FOUNDATION_EXPORT NSString *const kNotFoundResponseString;
FOUNDATION_EXPORT NSString *const kInvalidJSONResponseString;
FOUNDATION_EXPORT NSString *const kFIRStorageValidURL;
FOUNDATION_EXPORT NSString *const kFIRStorageNotFoundURL;
FOUNDATION_EXPORT NSString *const kFIRStorageTestAuthToken;
FOUNDATION_EXPORT NSString *const kFIRStorageAppName;

/**
 * Standard timeout for all async tests.
 */
static NSTimeInterval kExpectationTimeoutSeconds = 10;

@interface FIRStorageTestHelpers : NSObject

/**
 * Returns a mocked FIRApp with an injected container for interop and instance creation. No other
 * properties are set.
 */
+ (FIRApp *)mockedApp;

/**
 * Returns a valid URL for an object stored.
 */
+ (NSURL *)objectURL;

/**
 * Returns a valid URL for a bucket.
 */
+ (NSURL *)bucketURL;

/**
 * Returns a valid URL for an object not found in the current storage bucket.
 */
+ (NSURL *)notFoundURL;

/**
 * Returns a valid FIRStoragePath for an object stored.
 */
+ (FIRStoragePath *)objectPath;

/**
 * Returns a valid FIRStoragePath for a bucket (no object).
 */
+ (FIRStoragePath *)bucketPath;

/**
 * Returns a valid FIRStoragePath for an object not found in the current storage bucket.
 */
+ (FIRStoragePath *)notFoundPath;

/**
 * Returns a successful response block.
 */
+ (GTMSessionFetcherTestBlock)successBlock;

/**
 * Returns a successful response block containing object metadata.
 * @param metadata Metadata returned in the request.
 */
+ (GTMSessionFetcherTestBlock)successBlockWithMetadata:(nullable FIRStorageMetadata *)metadata;

/**
 * Returns a unsuccessful response block due to improper authentication.
 */
+ (GTMSessionFetcherTestBlock)unauthenticatedBlock;

/**
 * Returns a unsuccessful response block due to improper authorization.
 */
+ (GTMSessionFetcherTestBlock)unauthorizedBlock;

/**
 * Returns a unsuccessful response block due the object not being found.
 */
+ (GTMSessionFetcherTestBlock)notFoundBlock;

/**
 * Returns a unsuccessful response block due invalid JSON returned by the server.
 */
+ (GTMSessionFetcherTestBlock)invalidJSONBlock;

/**
 * Waits for the given test case to time out by wrapping -waitForExpectation.
 */
+ (void)waitForExpectation:(id)test;

@end

NS_ASSUME_NONNULL_END