/* OctaveGUI - A graphical user interface for Octave
 * Copyright (C) 2011 John P. Swensen, Jacob Dawid (jacob.dawid@googlemail.com)
 *
 * 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 3 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, see <http://www.gnu.org/licenses/>.
 */

#ifndef OCTAVELINK_H
#define OCTAVELINK_H

// Octave includes
#undef PACKAGE_BUGREPORT
#undef PACKAGE_NAME
#undef PACKAGE_STRING
#undef PACKAGE_TARNAME
#undef PACKAGE_VERSION
#undef PACKAGE_URL
#include "octave/config.h"
#include "octave/cmd-edit.h"
#include "octave/error.h"
#include "octave/file-io.h"
#include "octave/input.h"
#include "octave/lex.h"
#include "octave/load-path.h"
#include "octave/octave.h"
#include "octave/oct-hist.h"
#include "octave/oct-map.h"
#include "octave/oct-obj.h"
#include "octave/ops.h"
#include "octave/ov.h"
#include "octave/ov-usr-fcn.h"
#include "octave/symtab.h"
#include "octave/pt.h"
#include "octave/pt-eval.h"
#include "octave/config.h"
#include "octave/Range.h"
#include "octave/toplev.h"
#include "octave/procstream.h"
#include "octave/sighandlers.h"
#include "octave/debug.h"
#include "octave/sysdep.h"
#include "octave/ov.h"
#include "octave/unwind-prot.h"
#include "octave/utils.h"
#include "octave/variables.h"
#include "oct-mutex.h"

// Standard includes
#include <iostream>
#include <string>
#include <vector>
#include <readline/readline.h>
#include <queue>

#include "workspace-model.h"
#include "octave-main-thread.h"
#include "octave-event.h"
#include "octave-event-observer.h"
#include "octave-event-listener.h"
#include "symbol-information.h"

/**
  * \class OctaveLink
  * \brief Provides threadsafe access to octave.
  * \author Jacob Dawid
  * This class is a wrapper around octave and provides threadsafety by
  * buffering access operations to octave and executing them in the readline
  * event hook, which lives in the octave thread.
  */
class octave_link : public octave_event_observer
{
public:
  /** Provides a way to access the unique octave_link object. */
  static octave_link * instance () { return &_singleton; }

  /** Starts octave. */
  void launch_octave ();
  void register_event_listener (octave_event_listener *oel);

  void generate_events ();
  void process_events ();
  void post_event (octave_event *e);
  void event_accepted (octave_event *e);
  void event_reject (octave_event *e);

  void about_to_exit ();
private:
  /** Singleton. */
  octave_link ();
  ~octave_link ();

  octave_event_listener *_octave_event_listener;

  /** Thread running octave_main. */
  octave_main_thread *_octave_main_thread;

  /** Semaphore to lock access to the event queue. */
  octave_mutex *_event_queue_mutex;

  /** Buffer for queueing events until they will be processed. */
  std::queue <octave_event *> _event_queue;

  /** Stores the last known current working directory of octave. */
  std::string _last_working_directory;

  /** Unique instance. Singelton! */
  static octave_link _singleton;
};
#endif // OCTAVELINK_H