--Uploaded to ContentMine's repo--

What's been achieved so far:
* Established the application framework (Express.js back-end, Angular.js front-end single-page application).
* Designed the page layout with the menus (responsive design, should even look good on mobile devices).
* Established a way of actually executing commands in the background.
* Set up the basic version of the getpapers user form (based on @tarrow's hand-drawn wireframe google doc).

Author: DrShushen

.gitignore

@@ -0,0 +1,48 @@
+# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio and Webstorm
+# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
+
+# User-specific stuff:
+.idea/workspace.xml
+.idea/tasks.xml
+.idea/dictionaries
+.idea/vcs.xml
+.idea/jsLibraryMappings.xml
+
+# Sensitive or high-churn files:
+.idea/dataSources.ids
+.idea/dataSources.xml
+.idea/dataSources.local.xml
+.idea/sqlDataSources.xml
+.idea/dynamic.xml
+.idea/uiDesigner.xml
+
+# Gradle:
+.idea/gradle.xml
+.idea/libraries
+
+# Mongo Explorer plugin:
+.idea/mongoSettings.xml
+
+## File-based project format:
+*.iws
+
+## Plugin-specific files:
+
+# IntelliJ
+/out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties
+fabric.properties
+
+# EVGENY SAVELIEV CONFIGURED:
+.idea
+/*.iml

api/api.js

@@ -0,0 +1,45 @@
+/*
+ * Command execution API.
+ */
+
+// The API object.
+var api = {};
+
+// Data
+var data = {
+
+};
+
+// GET
+
+// [...]
+
+// POST
+
+api.cmd = function (req, res) {
+
+
+    var execCmd = require('../working/exec-cmd');
+    var dspl = require('../working/display-output').display;
+
+    execCmd.exec(req.body.command, function(results) {
+        //res.json({commandOutput: results});
+        console.log(results);
+        res.send(dspl(results));
+        //next();
+    });
+
+    //console.log("b");
+    ///res = {};
+    //res.send('done!');
+};
+
+// PUT
+
+// [...]
+
+// DELETE
+
+// [...]
+
+module.exports = api;

app.js

@@ -0,0 +1,99 @@
+var express = require('express');
+var path = require('path');
+var favicon = require('serve-favicon');
+var logger = require('morgan');
+var cookieParser = require('cookie-parser');
+var bodyParser = require('body-parser');
+
+var routes = require('./routes/index');
+var partials = require('./routes/partials');
+var test = require('./routes/test');
+var api = require('./routes/api');
+
+// Custom js files.
+var cmdHandler = require('./working/cmd-handler');
+
+var app = express();
+
+// view engine setup
+app.set('views', path.join(__dirname, 'views'));
+app.set('view engine', 'jade');
+
+// uncomment after placing your favicon in /public
+app.use(favicon(path.join(__dirname, 'public/images/favicon/favicon.ico')));
+app.use(logger('dev'));
+app.use(bodyParser.json());
+app.use(bodyParser.urlencoded({ extended: false }));
+app.use(cookieParser());
+app.use(require('node-sass-middleware')({
+  src: path.join(__dirname, 'public'),
+  dest: path.join(__dirname, 'public'),
+  indentedSyntax: false,
+  debug: true,
+  outputStyle: 'compressed',
+  sourceMap: true
+}));
+app.use(express.static(path.join(__dirname, 'public')));
+
+// Custom locals.
+app.locals.displayOutput = require('./working/display-output');
+app.locals.vars =
+{
+  // Global.
+  title:            'ContentMine',
+  // Paths.
+  jsPath:           '/javascripts/',
+  librariesPath:    '/javascripts/libraries/',
+  customJsPath:     '/javascripts/custom/',
+  stylesheetsPath:  '/stylesheets/',
+  imagesPath:       '/images/',
+  faviconPath:      '/images/favicon/',
+  iconsPath:        '/images/icons/',
+  // Content.
+  outputValue:      'Command output...'
+};
+
+// Custom middleware.
+//app.use('/', cmdHandler);
+
+// Routes registration.
+app.use('/', routes);
+app.use('/partials', partials);
+app.use('/test', test);
+
+// JSON API.
+app.use('/', api);
+
+// catch 404 and forward to error handler
+app.use(function(req, res, next) {
+  var err = new Error('Not Found');
+  err.status = 404;
+  next(err);
+});
+
+// error handlers
+
+// development error handler
+// will print stacktrace
+if (app.get('env') === 'development') {
+  app.use(function(err, req, res, next) {
+    res.status(err.status || 500);
+    res.render('error', {
+      message: err.message,
+      error: err
+    });
+  });
+}
+
+// production error handler
+// no stacktraces leaked to user
+app.use(function(err, req, res, next) {
+  res.status(err.status || 500);
+  res.render('error', {
+    message: err.message,
+    error: {}
+  });
+});
+
+
+module.exports = app;

bin/client-side-launcher.js

@@ -0,0 +1,21 @@
+/**
+ * EVGENY SAVELIEV: CLIENT-SIDE LAUNCHER.
+ * Requires first argument as the browser launching command (with {port} as the port placeholder), e.g:
+ * node client-side-launcher "start http://localhost:{port}"
+ */
+
+var port = require('../bin/www');
+var execCmd = require('../working/exec-cmd.js');
+
+// process.argv[2] is the command passed to the launcher.
+// port is the app port as set by /bin/www.
+var argProvided = process.argv[2];
+if (argProvided !== undefined) {
+    if (argProvided.indexOf('{port}') !== -1) {
+        execCmd.exec(argProvided.replace('{port}', port), function(results) { }); // No action.
+    } else {
+        console.log('Error: the browser launching command provided as the first argument to the client-side-launcher must contain {port} as the port placeholder.');
+    }
+} else {
+    console.log('Error: must provide the browser launching command as the first argument to client-side-launcher (with {port} as the port placeholder).');
+}

bin/www

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+
+/**
+ * Module dependencies.
+ */
+
+var app = require('../app');
+var debug = require('debug')('contentmine-gui:server');
+var http = require('http');
+
+/**
+ * Get port from environment and store in Express.
+ */
+
+var port = normalizePort(process.env.PORT || '3000');
+app.set('port', port);
+
+/**
+ * Create HTTP server.
+ */
+
+var server = http.createServer(app);
+
+/**
+ * Listen on provided port, on all network interfaces.
+ */
+
+server.listen(port);
+server.on('error', onError);
+server.on('listening', onListening);
+
+/**
+ * Normalize a port into a number, string, or false.
+ */
+
+function normalizePort(val) {
+  var port = parseInt(val, 10);
+
+  if (isNaN(port)) {
+    // named pipe
+    return val;
+  }
+
+  if (port >= 0) {
+    // port number
+    return port;
+  }
+
+  return false;
+}
+
+/**
+ * Event listener for HTTP server "error" event.
+ */
+
+function onError(error) {
+  if (error.syscall !== 'listen') {
+    throw error;
+  }
+
+  var bind = typeof port === 'string'
+    ? 'Pipe ' + port
+    : 'Port ' + port;
+
+  // handle specific listen errors with friendly messages
+  switch (error.code) {
+    case 'EACCES':
+      console.error(bind + ' requires elevated privileges');
+      process.exit(1);
+      break;
+    case 'EADDRINUSE':
+      console.error(bind + ' is already in use');
+      process.exit(1);
+      break;
+    default:
+      throw error;
+  }
+}
+
+/**
+ * Event listener for HTTP server "listening" event.
+ */
+
+function onListening() {
+  var addr = server.address();
+  var bind = typeof addr === 'string'
+    ? 'pipe ' + addr
+    : 'port ' + addr.port;
+  debug('Listening on ' + bind);
+}
+
+/**
+ * EVGENY SAVELIEV - EXPORT PORT.
+ */
+
+module.exports = port;

launchers/linux/ContentMine.sh

@@ -0,0 +1,3 @@
+#! /bin/bash
+# Launcher NOT TESTED. Evgeny Saveliev.
+node ../../bin/client-side-launcher "xdg-open http://localhost:{port}" && node ../../bin/www

launchers/mac/ContentMine.sh

@@ -0,0 +1,3 @@
+#! /bin/bash
+# Launcher NOT TESTED. Evgeny Saveliev.
+node ../../bin/client-side-launcher "open http://localhost:{port}" & node ../../bin/www

launchers/windows/ContentMine.bat

@@ -0,0 +1,3 @@
+@echo off
+REM Launcher tested successfully. Evgeny Saveliev.
+node ../../bin/client-side-launcher "start http://localhost:{port}" & node ../../bin/www