NightOwl888 opened a new issue #307:
URL: https://github.com/apache/lucenenet/issues/307


   We completed the "System Properties" feature in #254/#287, but we are 
lacking documentation on how end users can utilize it, in particular for the 
test framework. Here are a list of the properties that exist and their 
defaults, however, not all of them apply to the .NET port.
   
   ```
   {
       "smartcn:data:dir": "",
       "egothor:stemmer:charset": "UTF-8",
       "kuromoji:data:dir": "",
       "solr:test:leavetmpdir": null, // Doesn't apply to Lucene.NET
       "assert": false, // Turn on assertions (for testing/logging) in release 
build (.NET-only)
       "tests": {
           "asserts:gracious": "false", // Doesn't apply to Lucene.NET
           "cleanthreads:sysprop": "perMethod", // Doesn't apply to Lucene.NET
           "codec": "random",  // Specifies a specific Codec subclass to use 
for the tests
           "directory": "random", // Specifies a specific Directory subclass to 
use for the tests
           "docvaluesformat": "random",  // Specifies a specific 
DocValuesFormat subclass to use for the tests
           "infostream": "${verbose}", // Boolean that specifies whether to log 
output to console
           "jvms": "auto", // Doesn't apply to Lucene.NET
           "jvms:override": "${jvms}", // Doesn't apply to Lucene.NET
           "leaveTemporary": null, // Skips deletion of files that were created 
during tests
           "leavetemporary": null, // Alias of above
           "leavetmpdir": null, // Alias of above
           "linedocsfile": "", // Specifies a specific LineDocsFile to use when 
running tests (may not be functional with external files)
           "locale": "random", // Specifies a specific culture to use when 
running tests (TODO: rename or alias "culture")
           "multiplier": "1", // Multiplier to scale random tests for more 
thorough (but longer) testing - used during nightly/weakly builds
           "nightly": "false", // TODO: Need to set up nightly build 
infrastructure
           "postingsformat": "random",  // Specifies a specific PostingsFormat 
subclass to use for the tests
           "seed": "", // Specifies a random seed to use during tests in 
hexadecimal format (not yet implemented - see #288)
           "slow": "true", // Specifies to run slow tests (not implemented, but 
we made a LongRunningTestAttribute that could be adapted)
           "timezone": "random",  // Specifies a specific time zone to use for 
the tests (not xplat because of different naming conventions)
           "verbose": "false", // Use verbose logging
           "weekly": "false" // TODO: Need to set up weekly build infrastructure
       },
       "user:timezone": "random" // Doesn't apply to Lucene.NET
   }
   ```
   
   The most crucial thing here is to allow end users to specify a random seed 
and to print out the random seed that caused a failure (#288), but we should 
also look into setting up nightly and weekly builds to do more thorough testing 
(provided we get some credits to go over 1 hour for a job on Azure DevOps) and 
also look at putting in a switch to turn on/off long running tests.
   
   


----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
[email protected]


Reply via email to