@sap/cds-compiler 2.13.8 → 2.15.2

package/lib/optionProcessor.js

@@ -11,7 +11,9 @@ const optionProcessor = createOptionProcessor();
 optionProcessor
   .option('-h, --help')
   .option('-v, --version')
+  .option('    --options <file>')
   .option('-w, --warning <level>', ['0', '1', '2', '3'])
+  .option('    --quiet')
   .option('    --show-message-id')
   .option('    --no-message-context')
   .option('    --color <mode>', ['auto', 'always', 'never'])
@@ -22,16 +24,15 @@ optionProcessor
   .option('    --trace-parser')
   .option('    --trace-parser-amb')
   .option('    --trace-fs')
+  .option('    --error <id-list>')
+  .option('    --warn <id-list>')
+  .option('    --info <id-list>')
+  .option('    --debug <id-list>')
   .option('-E, --enrich-csn')
   .option('-R, --raw-output <name>')
   .option('    --internal-msg')
   .option('    --beta-mode')
   .option('    --beta <list>')
-  .option('    --integrity-not-validated')
-  .option('    --integrity-not-enforced')
-  .option('    --assert-integrity <mode>', [ 'true', 'false', 'individual' ])
-  .option('    --assert-integrity-type <type>', [ 'RT', 'DB' ], { ignoreCase: true })
-  .option('    --constraints-in-create-table')
   .option('    --deprecated <list>')
   .option('    --hana-flavor')
   .option('    --direct-backend')
@@ -59,17 +60,21 @@ optionProcessor
   General options
    -h, --help               Show this help text
    -v, --version            Display version number and exit
+       --quiet              Don't emit anything, neither results nor messages.
    -w, --warning <level>    Show messages up to <level>
                               0: Error
                               1: Warnings
                               2: (default) Info
                               3: Debug
+       --options <file>     Use the given JSON file as input options.
+                            The key 'cdsc' of 'cds' is used. If not present 'cdsc' is used.
+                            Otherwise, the JSON as-is is used as options.
        --show-message-id    Show message ID in error, warning and info messages
        --no-message-context Print messages as single lines without code context (useful for
-                            redirecting output to other processes). Default is to print human
+                            redirecting output to other processes). Default is to print human-
                             readable text similar to Rust's compiler with a code excerpt.
        --color <mode>       Use colors for warnings. Modes are:
-                              auto: (default) Detect color support of the tty.
+                              auto: (default) Detect color support of the TTY.
                               always:
                               never:
    -o, --out <dir>          Place generated files in directory <dir>, default is "-" for <stdout>
@@ -87,6 +92,13 @@ optionProcessor
        --trace-parser-amb   Trace parser ambiguities
        --trace-fs           Trace file system access caused by "using from"
 
+  Severity options
+    Use these options to reclassify messages.  Option argument is a comma separated list of message IDs.
+       --error <id-list>    IDs that should be reclassified to errors.
+       --warn  <id-list>    IDs that should be reclassified to warnings.
+       --info  <id-list>    IDs that should be reclassified to info messages.
+       --debug <id-list>    IDs that should be reclassified to debug messages.
+
   Internal options (for testing only, may be changed/removed at any time)
    -E, --enrich-csn         Show non-enumerable CSN properties and locations of references
    -R, --raw-output <name>  Write XSN for definition "name" and error output to <stdout>,
@@ -99,22 +111,6 @@ optionProcessor
                               hanaAssocRealCardinality
                               mapAssocToJoinCardinality
                               ignoreAssocPublishingInUnion
-       --integrity-not-enforced          If this option is supplied, referential constraints are NOT ENFORCED.
-                                         This option is also applied to result of "cdsc manageConstraints"
-       --integrity-not-validated         If this option is supplied, referential constraints are NOT VALIDATED.
-                                         This option is also applied to result of "cdsc manageConstraints"
-       --assert-integrity      <mode>    Turn DB constraints on/off:
-                                           true        : (default) Constraints will be generated for all associations if
-                                                         the assert-integrity-type is set to DB
-                                           false       : No constraints will be generated
-                                           individual  : Constraints will be generated for selected associations
-       --assert-integrity-type <type>  Specifies how the referential integrity checks should be performed:
-                                           RT : (default) No database constraint for an association
-                                               if not explicitly demanded via annotation
-                                           DB : Create database constraints for associations
-       --constraints-in-create-table   If set, the foreign key constraints will be rendered as
-                                       part of the "CREATE TABLE" statements rather than as separate
-                                       "ALTER TABLE ADD CONSTRAINT" statements
        --deprecated <list>  Comma separated list of deprecated options.
                             Valid values are:
                               noElementsExpansion
@@ -169,6 +165,10 @@ optionProcessor.command('H, toHana')
   .option('-u, --user <user>')
   .option('-s, --src')
   .option('-c, --csn')
+  .option('    --integrity-not-validated')
+  .option('    --integrity-not-enforced')
+  .option('    --assert-integrity <mode>', ['true', 'false', 'individual'])
+  .option('    --assert-integrity-type <type>', ['RT', 'DB'], { ignoreCase: true })
   .help(`
   Usage: cdsc toHana [options] <files...>
 
@@ -192,6 +192,17 @@ optionProcessor.command('H, toHana')
    -u, --user <user>          Value for the "$user" variable
    -s, --src                  (default) Generate HANA CDS source files "<artifact>.hdbcds"
    -c, --csn                  Generate "hana_csn.json" with HANA-preprocessed model
+   --integrity-not-enforced   If this option is supplied, referential constraints are NOT ENFORCED.
+   --integrity-not-validated  If this option is supplied, referential constraints are NOT VALIDATED.
+   --assert-integrity <mode>  Turn DB constraints on/off:
+                                true        : (default) Constraints will be generated for all associations if
+                                              the assert-integrity-type is set to DB
+                                false       : No constraints will be generated
+                                individual  : Constraints will be generated for selected associations
+   --assert-integrity-type <type>   Specifies how the referential integrity checks should be performed:
+                                           RT : (default) No database constraint for an association
+                                               if not explicitly demanded via annotation
+                                           DB : Create database constraints for associations
 `);
 
 optionProcessor.command('O, toOdata')
@@ -207,6 +218,7 @@ optionProcessor.command('O, toOdata')
   .option('-c, --csn')
   .option('-f, --odata-format <format>', ['flat', 'structured'])
   .option('-n, --names <style>', ['plain', 'quoted', 'hdbcds'])
+  .option('-s, --service-names <list>')
   .help(`
   Usage: cdsc toOdata [options] <files...>
 
@@ -237,6 +249,8 @@ optionProcessor.command('O, toOdata')
                                         but element names flattened with underscores
                               hdbcds  : Names as HANA CDS would generate them from the same CDS
                                         source (like "quoted", but using element names with dots)
+    -s, --service-names <list>    List of comma-separated service names to be rendered
+                                  (default) empty, all services are rendered 
 `);
 
 optionProcessor.command('C, toCdl')
@@ -260,6 +274,11 @@ optionProcessor.command('Q, toSql')
   .option('-l, --locale <locale>')
   .option('-s, --src <style>', ['sql', 'hdi'])
   .option('-c, --csn')
+  .option('    --integrity-not-validated')
+  .option('    --integrity-not-enforced')
+  .option('    --assert-integrity <mode>', ['true', 'false', 'individual'])
+  .option('    --assert-integrity-type <type>', ['RT', 'DB'], { ignoreCase: true })
+  .option('    --constraints-in-create-table')
   .help(`
   Usage: cdsc toSql [options] <files...>
 
@@ -292,6 +311,20 @@ optionProcessor.command('Q, toSql')
                                          the HDI plugin name. Can only be used in combination with
                                          "hana" dialect.
    -c, --csn                  Generate "sql_csn.json" with SQL-preprocessed model
+   --integrity-not-enforced   If this option is supplied, referential constraints are NOT ENFORCED.
+   --integrity-not-validated  If this option is supplied, referential constraints are NOT VALIDATED.
+   --assert-integrity <mode>  Turn DB constraints on/off:
+                                true        : (default) Constraints will be generated for all associations if
+                                              the assert-integrity-type is set to DB
+                                false       : No constraints will be generated
+                                individual  : Constraints will be generated for selected associations
+   --assert-integrity-type <type>   Specifies how the referential integrity checks should be performed:
+                                      RT : (default) No database constraint for an association
+                                           if not explicitly demanded via annotation
+                                      DB : Create database constraints for associations
+   --constraints-in-create-table    If set, the foreign key constraints will be rendered as
+                                    part of the "CREATE TABLE" statements rather than as separate
+                                    "ALTER TABLE ADD CONSTRAINT" statements
 `);
 
 optionProcessor.command('toRename')
@@ -322,13 +355,14 @@ optionProcessor.command('manageConstraints')
   .option('    --drop')
   .option('    --alter')
   .option('    --violations')
+  .option('    --integrity-not-validated')
+  .option('    --integrity-not-enforced')
   .help(`
   Usage: cdsc manageConstraints [options] <files...>
 
   (internal, subject to change): Generate SQL DDL ALTER TABLE statements to add / modify
-  referential constraints on an existing model.
-  Combine with options "--integrity-not-enforced" and "--integrity-not-validated"
-  to switch off foreign key constraint enforcement / validation.
+  referential constraints on an existing model. This can also be used to
+  generate SELECT statements which list all referential integrity violations.
 
   Options
    -h, --help             Display this help text
@@ -348,6 +382,8 @@ optionProcessor.command('manageConstraints')
       --alter             Generate "ALTER TABLE <table> ALTER CONSTRAINT <constraint>" statements
       --violations        Generates SELECT statements which can be used to list
                           referential integrity violations on the existing data
+      --integrity-not-enforced   If this option is supplied, referential constraints are NOT ENFORCED.
+      --integrity-not-validated  If this option is supplied, referential constraints are NOT VALIDATED.
 `);
 
 optionProcessor.command('toCsn')