CommandOptions (#2856)

* WIP CommandOptions

* Fix some output issues.

* Simplify word wrapping.

* Add file extensions.

* Change how lookup takes place.
Add appendSplit functions to StringUtil.
Make Categories hold the index range of their options.

* Small improvement.

* Lookup with partial option names.

* Associate user values.

* Encoding flags in the name.

* Refactor setting up of command options.

* Use CommandOptions in slang-options.

* Remove old help text.

* Cache the CommandOptions on the Session.

* Range checking.
Fix bug in the Options handling.

* Extra checks for validity.

* Get categories directly.

* Slight improvements over output.

* Added NameValue types.

* Fix typo.
Remove some now unused diagnostics.
Fix diagnostic in testing, as output has changed.

* Add minimal usage message.

* Remove platform executable extension from diagnostics output.

* Some improvements around getting names from NameValue types.

* Improve some option descriptions.

* Small fixes.

4 files changed, 32 insertions, 0 deletions

diff --git a/build/visual-studio/core/core.vcxproj b/build/visual-studio/core/core.vcxproj
index 7799dd8f4..90fcfe8ef 100644
--- a/build/visual-studio/core/core.vcxproj
+++ b/build/visual-studio/core/core.vcxproj
@@ -278,6 +278,7 @@
     <ClInclude Include="..\..\..\source\core\slang-chunked-list.h" />

     <ClInclude Include="..\..\..\source\core\slang-com-object.h" />

     <ClInclude Include="..\..\..\source\core\slang-command-line.h" />

+    <ClInclude Include="..\..\..\source\core\slang-command-options.h" />

     <ClInclude Include="..\..\..\source\core\slang-common.h" />

     <ClInclude Include="..\..\..\source\core\slang-compression-system.h" />

     <ClInclude Include="..\..\..\source\core\slang-crypto.h" />

@@ -298,6 +299,7 @@
     <ClInclude Include="..\..\..\source\core\slang-math.h" />

     <ClInclude Include="..\..\..\source\core\slang-memory-arena.h" />

     <ClInclude Include="..\..\..\source\core\slang-memory-file-system.h" />

+    <ClInclude Include="..\..\..\source\core\slang-name-value.h" />

     <ClInclude Include="..\..\..\source\core\slang-offset-container.h" />

     <ClInclude Include="..\..\..\source\core\slang-persistent-cache.h" />

     <ClInclude Include="..\..\..\source\core\slang-platform.h" />

@@ -342,6 +344,7 @@
     <ClCompile Include="..\..\..\source\core\slang-char-encode.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-char-util.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-command-line.cpp" />

+    <ClCompile Include="..\..\..\source\core\slang-command-options.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-crypto.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-deflate-compression-system.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-file-system.cpp" />

@@ -353,6 +356,7 @@
     <ClCompile Include="..\..\..\source\core\slang-lz4-compression-system.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-memory-arena.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-memory-file-system.cpp" />

+    <ClCompile Include="..\..\..\source\core\slang-name-value.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-offset-container.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-persistent-cache.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-platform.cpp" />

diff --git a/build/visual-studio/core/core.vcxproj.filters b/build/visual-studio/core/core.vcxproj.filters
index 8ad3e42d5..41d0fafe1 100644
--- a/build/visual-studio/core/core.vcxproj.filters
+++ b/build/visual-studio/core/core.vcxproj.filters
@@ -48,6 +48,9 @@
     <ClInclude Include="..\..\..\source\core\slang-command-line.h">

       <Filter>Header Files</Filter>

     </ClInclude>

+    <ClInclude Include="..\..\..\source\core\slang-command-options.h">

+      <Filter>Header Files</Filter>

+    </ClInclude>

     <ClInclude Include="..\..\..\source\core\slang-common.h">

       <Filter>Header Files</Filter>

     </ClInclude>

@@ -108,6 +111,9 @@
     <ClInclude Include="..\..\..\source\core\slang-memory-file-system.h">

       <Filter>Header Files</Filter>

     </ClInclude>

+    <ClInclude Include="..\..\..\source\core\slang-name-value.h">

+      <Filter>Header Files</Filter>

+    </ClInclude>

     <ClInclude Include="..\..\..\source\core\slang-offset-container.h">

       <Filter>Header Files</Filter>

     </ClInclude>

@@ -236,6 +242,9 @@
     <ClCompile Include="..\..\..\source\core\slang-command-line.cpp">

       <Filter>Source Files</Filter>

     </ClCompile>

+    <ClCompile Include="..\..\..\source\core\slang-command-options.cpp">

+      <Filter>Source Files</Filter>

+    </ClCompile>

     <ClCompile Include="..\..\..\source\core\slang-crypto.cpp">

       <Filter>Source Files</Filter>

     </ClCompile>

@@ -269,6 +278,9 @@
     <ClCompile Include="..\..\..\source\core\slang-memory-file-system.cpp">

       <Filter>Source Files</Filter>

     </ClCompile>

+    <ClCompile Include="..\..\..\source\core\slang-name-value.cpp">

+      <Filter>Source Files</Filter>

+    </ClCompile>

     <ClCompile Include="..\..\..\source\core\slang-offset-container.cpp">

       <Filter>Source Files</Filter>

     </ClCompile>

diff --git a/build/visual-studio/slang-rt/slang-rt.vcxproj b/build/visual-studio/slang-rt/slang-rt.vcxproj
index 31627101c..41c44a051 100644
--- a/build/visual-studio/slang-rt/slang-rt.vcxproj
+++ b/build/visual-studio/slang-rt/slang-rt.vcxproj
@@ -290,6 +290,7 @@
     <ClInclude Include="..\..\..\source\core\slang-chunked-list.h" />

     <ClInclude Include="..\..\..\source\core\slang-com-object.h" />

     <ClInclude Include="..\..\..\source\core\slang-command-line.h" />

+    <ClInclude Include="..\..\..\source\core\slang-command-options.h" />

     <ClInclude Include="..\..\..\source\core\slang-common.h" />

     <ClInclude Include="..\..\..\source\core\slang-compression-system.h" />

     <ClInclude Include="..\..\..\source\core\slang-crypto.h" />

@@ -310,6 +311,7 @@
     <ClInclude Include="..\..\..\source\core\slang-math.h" />

     <ClInclude Include="..\..\..\source\core\slang-memory-arena.h" />

     <ClInclude Include="..\..\..\source\core\slang-memory-file-system.h" />

+    <ClInclude Include="..\..\..\source\core\slang-name-value.h" />

     <ClInclude Include="..\..\..\source\core\slang-offset-container.h" />

     <ClInclude Include="..\..\..\source\core\slang-persistent-cache.h" />

     <ClInclude Include="..\..\..\source\core\slang-platform.h" />

@@ -355,6 +357,7 @@
     <ClCompile Include="..\..\..\source\core\slang-char-encode.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-char-util.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-command-line.cpp" />

+    <ClCompile Include="..\..\..\source\core\slang-command-options.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-crypto.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-deflate-compression-system.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-file-system.cpp" />

@@ -366,6 +369,7 @@
     <ClCompile Include="..\..\..\source\core\slang-lz4-compression-system.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-memory-arena.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-memory-file-system.cpp" />

+    <ClCompile Include="..\..\..\source\core\slang-name-value.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-offset-container.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-persistent-cache.cpp" />

     <ClCompile Include="..\..\..\source\core\slang-platform.cpp" />

diff --git a/build/visual-studio/slang-rt/slang-rt.vcxproj.filters b/build/visual-studio/slang-rt/slang-rt.vcxproj.filters
index 9ae64d433..4fa4373ff 100644
--- a/build/visual-studio/slang-rt/slang-rt.vcxproj.filters
+++ b/build/visual-studio/slang-rt/slang-rt.vcxproj.filters
@@ -48,6 +48,9 @@
     <ClInclude Include="..\..\..\source\core\slang-command-line.h">

       <Filter>Header Files</Filter>

     </ClInclude>

+    <ClInclude Include="..\..\..\source\core\slang-command-options.h">

+      <Filter>Header Files</Filter>

+    </ClInclude>

     <ClInclude Include="..\..\..\source\core\slang-common.h">

       <Filter>Header Files</Filter>

     </ClInclude>

@@ -108,6 +111,9 @@
     <ClInclude Include="..\..\..\source\core\slang-memory-file-system.h">

       <Filter>Header Files</Filter>

     </ClInclude>

+    <ClInclude Include="..\..\..\source\core\slang-name-value.h">

+      <Filter>Header Files</Filter>

+    </ClInclude>

     <ClInclude Include="..\..\..\source\core\slang-offset-container.h">

       <Filter>Header Files</Filter>

     </ClInclude>

@@ -239,6 +245,9 @@
     <ClCompile Include="..\..\..\source\core\slang-command-line.cpp">

       <Filter>Source Files</Filter>

     </ClCompile>

+    <ClCompile Include="..\..\..\source\core\slang-command-options.cpp">

+      <Filter>Source Files</Filter>

+    </ClCompile>

     <ClCompile Include="..\..\..\source\core\slang-crypto.cpp">

       <Filter>Source Files</Filter>

     </ClCompile>

@@ -272,6 +281,9 @@
     <ClCompile Include="..\..\..\source\core\slang-memory-file-system.cpp">

       <Filter>Source Files</Filter>

     </ClCompile>

+    <ClCompile Include="..\..\..\source\core\slang-name-value.cpp">

+      <Filter>Source Files</Filter>

+    </ClCompile>

     <ClCompile Include="..\..\..\source\core\slang-offset-container.cpp">

       <Filter>Source Files</Filter>

     </ClCompile>