docs: help sort choices (#336)

Signed-off-by: Jan Kowalleck <[email protected]>

Author: jkowalleck

README.md

@@ -67,13 +67,13 @@ Arguments:
 
 Options:
       --output-format=OUTPUT-FORMAT                   Which output format to use.
-                                                      {choices: "XML", "JSON"} [default: "XML"]
+                                                      {choices: "JSON", "XML"} [default: "XML"]
       --output-file=OUTPUT-FILE                       Path to the output file.
                                                       Set to "-" to write to STDOUT [default: "-"]
       --omit=OMIT                                     Omit dependency types.
                                                       {choices: "dev", "plugin"} (multiple values allowed)
       --spec-version=SPEC-VERSION                     Which version of CycloneDX spec to use.
-                                                      {choices: "1.4", "1.3", "1.2", "1.1"} [default: "1.4"]
+                                                      {choices: "1.1", "1.2", "1.3", "1.4"} [default: "1.4"]
       --output-reproducible|--no-output-reproducible  Whether to go the extra mile and make the output reproducible.
                                                       This might result in loss of time- and random-based-values.
       --validate|--no-validate                        Validate the resulting output.

src/MakeBom/Options.php

@@ -102,8 +102,10 @@ class Options
     /**
      * @param scalar[] $values
      */
-    private static function formatChoice(array $values): string
+    private static function formatChoice(array $values, int $sortFlag = \SORT_STRING): string
     {
+        sort($values, $sortFlag);
+
         return '{choices: "'.
             implode('", "', $values).
             '"}';
@@ -147,7 +149,7 @@ public function getDefinition(): InputDefinition
                 null,
                 InputOption::VALUE_REQUIRED,
                 'Which version of CycloneDX spec to use.'.\PHP_EOL.
-                self::formatChoice(array_keys(self::VALUE_SPEC_VERSION_MAP)),
+                self::formatChoice(array_keys(self::VALUE_SPEC_VERSION_MAP), \SORT_NUMERIC),
                 array_search($this->specVersion, self::VALUE_SPEC_VERSION_MAP, true),
                 array_keys(self::VALUE_SPEC_VERSION_MAP)
             ),