// This is the SIP interface definition for QProcess.
//
// Copyright (c) 2007
// 	Riverbank Computing Limited <info@riverbankcomputing.co.uk>
// 
// This file is part of PyQt.
// 
// This copy of PyQt is free software; you can redistribute it and/or modify it
// under the terms of the GNU General Public License as published by the Free
// Software Foundation; either version 2, or (at your option) any later
// version.
// 
// PyQt is supplied 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 General Public License for more
// details.
// 
// You should have received a copy of the GNU General Public License along with
// PyQt; see the file LICENSE.  If not, write to the Free Software Foundation,
// Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.


%ExportedDoc
<Sect2><Title>QProcess (Qt v3+)</Title>
<Para>
<Literal>QProcess</Literal> is fully implemented.
</Para>
</Sect2>
%End


%If (Qt_3_0_0 -)

class QProcess : QObject
{
%TypeHeaderCode
#include <qprocess.h>
%End

public:
	QProcess(QObject * /TransferThis/ = 0,const char * = 0);
	QProcess(const QString &,QObject * /TransferThis/ = 0,
		 const char * = 0);
	QProcess(const QStringList &,QObject * /TransferThis/ = 0,
		 const char * = 0);

	QStringList arguments() const;
	void clearArguments();
	virtual void setArguments(const QStringList &);
	virtual void addArgument(const QString &);
	QDir workingDirectory() const;
	virtual void setWorkingDirectory(const QDir &);

	enum Communication {
		Stdin,
		Stdout,
		Stderr,
		DupStderr
	};

	void setCommunication(int);
	int communication() const;

	virtual bool start(QStringList * = 0);
	virtual bool launch(const QString &, QStringList * = 0 );
	virtual bool launch(const QByteArray &,QStringList * = 0 );

	bool isRunning() const;
	bool normalExit() const;
	int exitStatus() const;

	virtual QByteArray readStdout() /ReleaseGIL/;
	virtual QByteArray readStderr() /ReleaseGIL/;
	bool canReadLineStdout() const;
	bool canReadLineStderr() const;
	virtual QString readLineStdout() /ReleaseGIL/;
	virtual QString readLineStderr() /ReleaseGIL/;

%If (WS_X11 || WS_MACX || WS_QWS)
	typedef long PID;
%End

	PID processIdentifier();

	void flushStdin();

signals:
	void readyReadStdout();
	void readyReadStderr();
	void processExited();
	void wroteToStdin();
	void launchFinished();

public slots:
	void tryTerminate() const;
	void kill() const;

	virtual void writeToStdin(const QByteArray &);
	virtual void writeToStdin(const QString &);
	virtual void closeStdin();

protected:
	void connectNotify(const char *);
	void disconnectNotify(const char *);

private:
%If (Qt_3_1_0 -)
	QProcess(const QProcess &);
%End
};

%End
