src/klfbackend/klffilterprocess.h

/***************************************************************************
 *   file klffilterprocess.h
 *   This file is part of the KLatexFormula Project.
 *   Copyright (C) 2011 by Philippe Faist
 *   philippe.faist at bluewin.ch
 *                                                                         *
 *   This program 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 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 *   This program 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 General Public License for more details.                          *
 *                                                                         *
 *   You should have received a copy of the GNU General Public License     *
 *   along with this program; if not, write to the                         *
 *   Free Software Foundation, Inc.,                                       *
 *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
 ***************************************************************************/
/* $Id$ */


#ifndef KLFFILTERPROCESS_H
#define KLFFILTERPROCESS_H


#include <klfdefs.h>
#include <klfblockprocess.h>
#include <klfbackend.h>


#define KLFFP_NOERR 0
#define KLFFP_NOSTART 1
#define KLFFP_NOEXIT 2
#define KLFFP_NOSUCCESSEXIT 3
#define KLFFP_NODATA 4
#define KLFFP_DATAREADFAIL 5
#define KLFFP_PAST_LAST_VALUE 6



struct KLFFilterProcessPrivate;
class KLFFilterProcessBlockProcess;

class KLF_EXPORT KLFFilterProcess
{
public:
  KLFFilterProcess(const QString& pTitle = QString(), const KLFBackend::klfSettings *settings = NULL,
                   const QString& rundir = QString());
  KLFFilterProcess(const QString& pTitle, const KLFBackend::klfSettings *settings,
                   const QString& rundir, bool inheritProcessEnvironment);
  virtual ~KLFFilterProcess();


  QString progTitle() const;
  void setProgTitle(const QString& title);

  QString programCwd() const;
  void setProgramCwd(const QString& cwd);

  QStringList execEnviron() const;
  void setExecEnviron(const QStringList& env);
  void addExecEnviron(const QStringList& env);

  QStringList argv() const;
  void setArgv(const QStringList& argv);
  void addArgv(const QStringList& argv);
  void addArgv(const QString& argv);

  bool outputStdout() const;
  void setOutputStdout(bool on);

  bool outputStderr() const;
  void setOutputStderr(bool on);

  void collectStdoutTo(QByteArray * stdoutstore);
  void collectStderrTo(QByteArray * stderrstore);

  bool processAppEvents();
  void setProcessAppEvents(bool processEvents);


  virtual int exitStatus() const;
  virtual int exitCode() const;

  virtual int resultStatus() const;
  virtual QString resultErrorString() const;


  bool run(const QString& outFileName, QByteArray *outdata)
  {
    return run(QByteArray(), outFileName, outdata);
  }

  bool run(const QByteArray& indata, const QString& outFileName, QByteArray *outdata)
  {
    QMap<QString,QByteArray*> fout; fout[outFileName] = outdata;
    return do_run(indata, fout);
  }

  bool run(const QMap<QString, QByteArray*> outdata)
  {
    return do_run(QByteArray(), outdata);
  }

  bool run(const QByteArray& indata = QByteArray())
  {
    return do_run(indata, QMap<QString, QByteArray*>());
  }

  bool run(const QByteArray& indata, const QMap<QString, QByteArray*> outdatalist)
  {
    return do_run(indata, outdatalist);
  }

protected:

  friend class KLFFilterProcessBlockProcess;
  virtual QMap<QString,QString> interpreters() const;

  virtual bool do_run(const QByteArray& indata, const QMap<QString, QByteArray*> outdatalist);

  QByteArray collectedStdout() const;
  QByteArray collectedStderr() const;

private:
  KLF_DECLARE_PRIVATE(KLFFilterProcess) ;
};








#endif