tweak some command line stuff, still a lot to do

src/CommandLineInterface.hx

@@ -1,14 +1,33 @@
+/**
+  The Neko command line interface to Harmonious Code. This is *far* from complete, but
+  can, at the moment, function as a very simple way to integrate a version check into
+  a build or test script.
+**/
 class CommandLineInterface {
   #if neko
     static public function main() {
       var arguments = neko.Sys.args();
 
+      var usage_string = "Usage: ./command_line.sh [ --php-version <version> ] [ --file ] <filename>\n";
+
       if (arguments.length > 0) {
-        if (neko.FileSystem.exists(arguments[0])) {
-          var code = neko.io.File.getContent(arguments[0]);
+        var mapped_arguments = parse_arguments(arguments);
+
+        if (!mapped_arguments.exists("file")) {
+          neko.Lib.print(usage_string);
+          neko.Sys.exit(1);
+        }
+
+        var filepath = mapped_arguments.get("file");
+        if (!neko.FileSystem.exists(filepath)) {
+          neko.Lib.print("The specified file does not exist: " + filepath + "\n");
+          neko.Sys.exit(1);
+        }
+
+        var code = neko.io.File.getContent(filepath);
 
         var parser = new CodeParser();
-          parser.loadProcessorsFromDisk();
+        parser.load_all_processors_from_disk();
 
         var results = parser.parse(code);
 
@@ -34,10 +53,59 @@ class CommandLineInterface {
 
           if (!version_info.is_valid()) {
             neko.Lib.print("This code may not run!\n");
+            neko.Sys.exit(1);
           }
         }
+
+        if (mapped_arguments.exists("php-version")) {
+          var minimum_specified_php_version = mapped_arguments.get("php-version");
+          if (CodeVersionInformation.version_compare(minimum_specified_php_version, minimum.get("PHP")) == -1) {
+            neko.Lib.print("Your code requires a version higher than the minimum version you specified, " + minimum_specified_php_version + "!\n");
+            neko.Sys.exit(1);
           }
         }
+
+        neko.Sys.exit(0);
+      }
+      neko.Lib.print(usage_string);
+      neko.Sys.exit(1);
     }
   #end
+
+  /**
+    Parse a series of arguments fed via the command line.
+  **/
+  public static function parse_arguments(arguments : Array<String>) : Hash<String> {
+    var mapped_arguments = new Hash<String>();
+
+    var capturable_options = [ "file", "php-version" ];
+    var valid_options_hash = new Hash<Bool>();
+
+    for (option in capturable_options) {
+      valid_options_hash.set(option, true);
+    }
+
+    var current_option : String = null;
+    for (argument in arguments) {
+      if (argument.indexOf("--") == 0) {
+        var option = argument.substr(2);
+        if (valid_options_hash.exists(option)) {
+          if (valid_options_hash.get(option)) {
+            current_option = option;
+          } else {
+            mapped_arguments.set(option, "true");
+          }
+        }
+      } else {
+        if (current_option != null) {
+          mapped_arguments.set(current_option, argument);
+          current_option = null;
+        } else {
+          mapped_arguments.set("file", argument);
+        }
+      }
+    }
+
+    return mapped_arguments;
+  }
 }

src/FunctionTokenProcessor.hx

@@ -1,3 +1,6 @@
+/**
+  Process the PHP documentation's function definition file.
+**/
 class FunctionTokenProcessor extends TokenProcessor {
   public static var source_path : String = "../data/phpdoc_function_versions.xml";
   override public function get_default_token_type() { return FunctionToken; }

src/MyTests.hx

@@ -11,6 +11,7 @@ class MyTests {
     r.add(new TestCodeVersionInformation());
     r.add(new TestResult());
     r.add(new TestJavaScriptTarget());
+    r.add(new TestCommandLineInterface());
     r.run();
   }
 }