Move the unfinished utilities in Lumina over to an "experimental" directory.

1 files changed, 87 insertions, 0 deletions

diff --git a/src-qt5/experimental/lumina-terminal/TtyProcess.h b/src-qt5/experimental/lumina-terminal/TtyProcess.h
new file mode 100644
index 00000000..42684112
--- /dev/null
+++ b/src-qt5/experimental/lumina-terminal/TtyProcess.h
@@ -0,0 +1,87 @@
+//===========================================
+//  Lumina-DE source code
+//  Copyright (c) 2015, Ken Moore
+//  Available under the 3-clause BSD license
+//  See the LICENSE file for full details
+//===========================================
+//  This is basically a replacement for QProcess, where all process/terminal outputs
+//   are redirected and not just the standard input/output channels. This allows it
+//   to be used for terminal-like apps (shells) which directly modify the terminal output
+//   rather than stick to input/output channels for communication.
+//===========================================
+//  IMPLEMENTATION NOTE
+//======================
+// The process requires/uses ANSI control codes (\x1B[<something>) for special operations
+//    such as moving the cursor, erasing characters, etc..
+//  It is recommended that you pair this class with the graphical "TerminalWidget.h" class
+//    or some other ANSI-compatible display widget.
+//===========================================
+#ifndef _LUMINA_DESKTOP_UTILITIES_TERMINAL_TTY_PROCESS_WIDGET_H
+#define _LUMINA_DESKTOP_UTILITIES_TERMINAL_TTY_PROCESS_WIDGET_H
+
+#include <QDebug>
+#include <QSocketNotifier>
+#include <QKeyEvent>
+
+//Standard C library functions for PTY access/setup
+#include <stdlib.h>
+#include <fcntl.h>
+#include <termios.h>
+#include <unistd.h>
+#include <sys/ioctl.h>
+#include <sys/types.h>
+#include <sys/wait.h>
+#include <signal.h>
+#include <libutil.h>
+
+class TTYProcess : public QObject{
+	Q_OBJECT
+public:
+	TTYProcess(QObject *parent = 0);
+	~TTYProcess();
+
+	bool startTTY(QString prog, QStringList args = QStringList(), QString workdir = "~");
+	void closeTTY();
+
+	//Primary read/write functions
+	void writeTTY(QByteArray output);
+	QByteArray readTTY();
+
+	//Setup the terminal size (characters and pixels)
+	void setTerminalSize(QSize chars, QSize pixels);
+
+	//Status update checks
+	bool isOpen();
+	
+	//Functions for handling ANSI escape codes (typically not used by hand)
+	QByteArray CleanANSI(QByteArray, bool &incomplete);
+
+private:
+	pid_t childProc;
+	int ttyfd;
+	QSocketNotifier *sn;
+	QByteArray fragBA; //fragment ByteArray
+	bool starting;
+	int fixReply; //flag for detecting particular inputs and "fixing" the reply to it as needed
+	
+	//====================================
+	// C Library function for setting up the PTY
+	// Inputs:
+	//    int &fd:	(output) file descriptor for the master PTY (positive integer if valid)
+	//    char *prog:	program to run
+	//    char **args:	program arguments
+	// Returns:
+	//    -1 for errors, child process PID (positive integer) if successful
+	//====================================
+	pid_t LaunchProcess(int& fd, char *prog, char **child_args); 
+	void setupTtyFd(pid_t fd);
+
+private slots:
+	void checkStatus(int);
+
+signals:
+	void readyRead();
+	void processClosed();
+};
+
+#endif