OFProcess.h

/*
 * Copyright (c) 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017
 *   Jonathan Schleifer <js@heap.zone>
 *
 * All rights reserved.
 *
 * This file is part of ObjFW. It may be distributed under the terms of the
 * Q Public License 1.0, which can be found in the file LICENSE.QPL included in
 * the packaging of this file.
 *
 * Alternatively, it may be distributed under the terms of the GNU General
 * Public License, either version 2 or 3, which can be found in the file
 * LICENSE.GPLv2 or LICENSE.GPLv3 respectively included in the packaging of this
 * file.
 */

#ifndef __STDC_LIMIT_MACROS
# define __STDC_LIMIT_MACROS
#endif
#ifndef __STDC_CONSTANT_MACROS
# define __STDC_CONSTANT_MACROS
#endif

#include "objfw-defs.h"

#ifdef OF_HAVE_SYS_TYPES_H
# include <sys/types.h>
#endif

#import "OFStream.h"
#import "OFString.h"

#ifdef OF_WINDOWS
# include <windows.h>
#endif

OF_ASSUME_NONNULL_BEGIN

@class OFArray OF_GENERIC(ObjectType);
@class OFDictionary OF_GENERIC(KeyType, ObjectType);

@interface OFProcess: OFStream
{
#ifndef OF_WINDOWS
    pid_t _pid;
    int _readPipe[2], _writePipe[2];
#else
    HANDLE _process, _readPipe[2], _writePipe[2];
#endif
    int _status;
    bool _atEndOfStream;
}

+ (instancetype)processWithProgram: (OFString *)program;

+ (instancetype)
    processWithProgram: (OFString *)program
         arguments: (nullable OFArray OF_GENERIC(OFString *) *)arguments;

+ (instancetype)
    processWithProgram: (OFString *)program
       programName: (OFString *)programName
         arguments: (nullable OFArray OF_GENERIC(OFString *) *)arguments;

+ (instancetype)
    processWithProgram: (OFString *)program
       programName: (OFString *)programName
         arguments: (nullable OFArray OF_GENERIC(OFString *) *)arguments
       environment: (nullable OFDictionary
                OF_GENERIC(OFString *, OFString *) *)environment;

- init OF_UNAVAILABLE;

- initWithProgram: (OFString *)program;

- initWithProgram: (OFString *)program
    arguments: (nullable OFArray OF_GENERIC(OFString *) *)arguments;

- initWithProgram: (OFString *)program
      programName: (OFString *)programName
    arguments: (nullable OFArray OF_GENERIC(OFString *) *)arguments;

- initWithProgram: (OFString *)program
      programName: (OFString *)programName
    arguments: (nullable OFArray OF_GENERIC(OFString *) *)arguments
      environment: (nullable OFDictionary
               OF_GENERIC(OFString *, OFString *) *)environment
    OF_DESIGNATED_INITIALIZER;

- (void)closeForWriting;
@end

OF_ASSUME_NONNULL_END