/*
 * Copyright (c) 2020-2021 Taner Sener
 *
 * This file is part of FFmpegKit.
 *
 * FFmpegKit is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * FFmpegKit is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with FFmpegKit.  If not, see <http://www.gnu.org/licenses/>.
 */

#ifndef FFPROBE_KIT_H
#define FFPROBE_KIT_H

#import <string.h>
#import <stdlib.h>
#import <Foundation/Foundation.h>
#import "FFprobeSession.h"
#import "MediaInformationJsonParser.h"

/**
 * <p>Main class to run <code>FFprobe</code> commands. Supports executing commands both
 * synchronously and asynchronously.
 * <pre>
 * FFprobeSession *session = [FFprobeKit execute:@"-hide_banner -v error -show_entries format=size -of default=noprint_wrappers=1 file1.mp4"];
 *
 * FFprobeSession *asyncSession = [FFprobeKit executeAsync:@"-hide_banner -v error -show_entries format=size -of default=noprint_wrappers=1 file1.mp4" withExecuteCallback:executeCallback];
 * </pre>
 * <p>Provides overloaded <code>execute</code> methods to define session specific callbacks.
 * <pre>
 * FFprobeSession *session = [FFprobeKit executeAsync:@"-hide_banner -v error -show_entries format=size -of default=noprint_wrappers=1 file1.mp4" withExecuteCallback:executeCallback withLogCallback:logCallback];
 * </pre>
 * <p>It can extract media information for a file or a url, using getMediaInformation method.
 * <pre>
 *      MediaInformationSession *session = [FFprobeKit getMediaInformation:@"file1.mp4"];
 * </pre>
 */
@interface FFprobeKit : NSObject

/**
 * <p>Synchronously executes FFprobe with arguments provided.
 *
 * @param arguments FFprobe command options/arguments as string array
 * @return FFprobe session created for this execution
 */
+ (FFprobeSession*)executeWithArguments:(NSArray*)arguments;

/**
 * <p>Asynchronously executes FFprobe with arguments provided.
 *
 * @param arguments       FFprobe command options/arguments as string array
 * @param executeCallback callback that will be called when the execution is completed
 * @return FFprobe session created for this execution
 */
+ (FFprobeSession*)executeWithArgumentsAsync:(NSArray*)arguments withExecuteCallback:(ExecuteCallback)executeCallback;

/**
 * <p>Asynchronously executes FFprobe with arguments provided.
 *
 * @param arguments       FFprobe command options/arguments as string array
 * @param executeCallback callback that will be notified when execution is completed
 * @param logCallback     callback that will receive logs
 * @return FFprobe session created for this execution
 */
+ (FFprobeSession*)executeWithArgumentsAsync:(NSArray*)arguments withExecuteCallback:(ExecuteCallback)executeCallback withLogCallback:(LogCallback)logCallback;

/**
 * <p>Asynchronously executes FFprobe with arguments provided.
 *
 * @param arguments       FFprobe command options/arguments as string array
 * @param executeCallback callback that will be called when the execution is completed
 * @param queue           dispatch queue that will be used to run this asynchronous operation
 * @return FFprobe session created for this execution
 */
+ (FFprobeSession*)executeWithArgumentsAsync:(NSArray*)arguments withExecuteCallback:(ExecuteCallback)executeCallback onDispatchQueue:(dispatch_queue_t)queue;

/**
 * <p>Asynchronously executes FFprobe with arguments provided.
 *
 * @param arguments       FFprobe command options/arguments as string array
 * @param executeCallback callback that will be notified when execution is completed
 * @param logCallback     callback that will receive logs
 * @param queue           dispatch queue that will be used to run this asynchronous operation
 * @return FFprobe session created for this execution
 */
+ (FFprobeSession*)executeWithArgumentsAsync:(NSArray*)arguments withExecuteCallback:(ExecuteCallback)executeCallback withLogCallback:(LogCallback)logCallback onDispatchQueue:(dispatch_queue_t)queue;

/**
 * <p>Synchronously executes FFprobe command provided. Space character is used to split command
 * into arguments. You can use single or double quote characters to specify arguments inside
 * your command.
 *
 * @param command FFprobe command
 * @return FFprobe session created for this execution
 */
+ (FFprobeSession*)execute:(NSString*)command;

/**
 * <p>Asynchronously executes FFprobe command provided. Space character is used to split command
 * into arguments. You can use single or double quote characters to specify arguments inside
 * your command.
 *
 * @param command         FFprobe command
 * @param executeCallback callback that will be called when the execution is completed
 * @return FFprobe session created for this execution
 */
+ (FFprobeSession*)executeAsync:(NSString*)command withExecuteCallback:(ExecuteCallback)executeCallback;

/**
 * <p>Asynchronously executes FFprobe command provided. Space character is used to split command
 * into arguments. You can use single or double quote characters to specify arguments inside
 * your command.
 *
 * @param command         FFprobe command
 * @param executeCallback callback that will be notified when execution is completed
 * @param logCallback     callback that will receive logs
 * @return FFprobe session created for this execution
 */
+ (FFprobeSession*)executeAsync:(NSString*)command withExecuteCallback:(ExecuteCallback)executeCallback withLogCallback:(LogCallback)logCallback;

/**
 * <p>Asynchronously executes FFprobe command provided. Space character is used to split command
 * into arguments. You can use single or double quote characters to specify arguments inside
 * your command.
 *
 * @param command         FFprobe command
 * @param executeCallback callback that will be called when the execution is completed
 * @param queue           dispatch queue that will be used to run this asynchronous operation
 * @return FFprobe session created for this execution
 */
+ (FFprobeSession*)executeAsync:(NSString*)command withExecuteCallback:(ExecuteCallback)executeCallback onDispatchQueue:(dispatch_queue_t)queue;

/**
 * <p>Asynchronously executes FFprobe command provided. Space character is used to split command
 * into arguments. You can use single or double quote characters to specify arguments inside
 * your command.
 *
 * @param command         FFprobe command
 * @param executeCallback callback that will be called when the execution is completed
 * @param logCallback     callback that will receive logs
 * @param queue           dispatch queue that will be used to run this asynchronous operation
 * @return FFprobe session created for this execution
 */
+ (FFprobeSession*)executeAsync:(NSString*)command withExecuteCallback:(ExecuteCallback)executeCallback withLogCallback:(LogCallback)logCallback onDispatchQueue:(dispatch_queue_t)queue;

/**
 * <p>Extracts media information for the file specified with path.
 *
 * @param path path or uri of a media file
 * @return media information session created for this execution
 */
+ (MediaInformationSession*)getMediaInformation:(NSString*)path;

/**
 * <p>Extracts media information for the file specified with path.
 *
 * @param path        path or uri of a media file
 * @param waitTimeout max time to wait until media information is transmitted
 * @return media information session created for this execution
 */
+ (MediaInformationSession*)getMediaInformation:(NSString*)path withTimeout:(int)waitTimeout;

/**
 * <p>Extracts media information for the file specified with path asynchronously.
 *
 * @param path            path or uri of a media file
 * @param executeCallback callback that will be called when the execution is completed
 * @return media information session created for this execution
 */
+ (MediaInformationSession*)getMediaInformationAsync:(NSString*)path withExecuteCallback:(ExecuteCallback)executeCallback;

/**
 * <p>Extracts media information for the file specified with path asynchronously.
 *
 * @param path            path or uri of a media file
 * @param executeCallback callback that will be notified when execution is completed
 * @param logCallback     callback that will receive logs
 * @param waitTimeout     max time to wait until media information is transmitted
 * @return media information session created for this execution
 */
+ (MediaInformationSession*)getMediaInformationAsync:(NSString*)path withExecuteCallback:(ExecuteCallback)executeCallback withLogCallback:(LogCallback)logCallback withTimeout:(int)waitTimeout;

/**
 * <p>Extracts media information for the file specified with path asynchronously.
 *
 * @param path            path or uri of a media file
 * @param executeCallback callback that will be called when the execution is completed
 * @param queue           dispatch queue that will be used to run this asynchronous operation
 * @return media information session created for this execution
 */
+ (MediaInformationSession*)getMediaInformationAsync:(NSString*)path withExecuteCallback:(ExecuteCallback)executeCallback onDispatchQueue:(dispatch_queue_t)queue;

/**
 * <p>Extracts media information for the file specified with path asynchronously.
 *
 * @param path            path or uri of a media file
 * @param executeCallback callback that will be notified when execution is completed
 * @param logCallback     callback that will receive logs
 * @param queue           dispatch queue that will be used to run this asynchronous operation
 * @param waitTimeout     max time to wait until media information is transmitted
 * @return media information session created for this execution
 */
+ (MediaInformationSession*)getMediaInformationAsync:(NSString*)path withExecuteCallback:(ExecuteCallback)executeCallback withLogCallback:(LogCallback)logCallback onDispatchQueue:(dispatch_queue_t)queue withTimeout:(int)waitTimeout;

/**
 * <p>Extracts media information using the command provided asynchronously.
 *
 * @param command FFprobe command that prints media information for a file in JSON format
 * @return media information session created for this execution
 */
+ (MediaInformationSession*)getMediaInformationFromCommand:(NSString*)command;

/**
 * <p>Extracts media information using the command provided asynchronously.
 *
 * @param command         FFprobe command that prints media information for a file in JSON format
 * @param executeCallback callback that will be notified when execution is completed
 * @param logCallback     callback that will receive logs
 * @param queue           dispatch queue that will be used to run this asynchronous operation
 * @param waitTimeout     max time to wait until media information is transmitted
 * @return media information session created for this execution
 */
+ (MediaInformationSession*)getMediaInformationFromCommandAsync:(NSString*)command withExecuteCallback:(ExecuteCallback)executeCallback withLogCallback:(LogCallback)logCallback onDispatchQueue:(dispatch_queue_t)queue withTimeout:(int)waitTimeout;

/**
 * <p>Lists all FFprobe sessions in the session history.
 *
 * @return all FFprobe sessions in the session history
 */
+ (NSArray*)listSessions;

@end

#endif // FFPROBE_KIT_H
