tests.lcf

# Log4J configuration file for running JMRI JUnit tests

# #############################################################
#  Log4J configuration
# #############################################################

# For the general syntax of property based configuration files see the
# documentation of org.apache.log4j.PropertyConfigurator
# or jmri.org/help/en/html/doc/Technical/Logging.shtml

# This configures three appenders:  J, R and A1.  J and R 
# are used routinely; A is for debugging use.

# The R appender writes all logging output to the tests.log
# file. This includes messages that the tests have intentionally
# suppressed, so it's quite verbose.

# The J appender is a JMRI-specific one, configured so that JMRI tests
# can examine their output. Changing the levels or 
# format of J can result in obscure test failures. 

# The A appender, if used, is configured to send output
# to stderr. This is typically used when debugging to make
# it easier to see the output during running.  The level
# can be set in the 'log4j.appender.A.Threshold' line below.

# Add A in the next line to turn it on
log4j.rootCategory= WARN, R, J

# The default level for test logging is WARN:  All the specific
# class loggers are initially set to ignore everything below that.
# You can set a specific class to e.g. debug so that it does
# log its information instead of ignoring it, see examples
# at the bottom.  Then the logging level on each appender (see
# below) is used to decide if the data is actually logged.

log4j.category.jmri=WARN

# J is a jmri.util.JUnitAppender which provides hooks used to test 
# whether a given log message is expected or not, and whether ERROR messages 
# have been logged.
log4j.appender.J=jmri.util.JUnitAppender
# J writes to system.err to synchronize with e.g. exception traces
log4j.appender.J.target=System.err
# always limit output to INFO; various tests require that
log4j.appender.J.Threshold=INFO
 
# R is set to output all enabled logging to the tests.log file in the CWD
log4j.appender.R=org.apache.log4j.FileAppender
log4j.appender.R.File=tests.log
log4j.appender.R.Append=false
log4j.appender.R.Threshold=TRACE

# A is set to be a ConsoleAppender which outputs to System.err.
log4j.appender.A=org.apache.log4j.ConsoleAppender
log4j.appender.A.target=System.err
log4j.appender.A.Threshold=TRACE

# All three appenders use PatternLayout to control their output format.
# Note that the default output formats are not the same across the three appenders.
# The conversion patterns use the following format specifiers. For details, 
# see the org.apache.log4j.PatternLayout Javadocs. To summarize:
#
# c category, e.g. %c{2} for right-most two tokens
# C classname of call (slow)
# d date, e.g. %d{ISO8601}, %d{ABSOLUTE}, %d{DATE}, %d{HH:mm:ss,SSS} 
#              or %d{dd MMM yyyy HH:mm:ss,SSS}
# F filename of call (slow)
# l location, JVM-dependent (extremely slow)
# m message
# M method name (slow)
# n line separator
# p priority
# r milliseconds elapsed
# t thread
# x nested diagnostic context
# % the sequence %% emits a single %
#
# Justification, padding and truncation can be controlled e.g. %-5.10p 
# is left justified, at least 5 and no more than 10 characters wide

log4j.appender.J.layout=org.apache.log4j.PatternLayout
log4j.appender.J.layout.ConversionPattern=%-5p - %m [%t] %c{4}.%M()%n

log4j.appender.R.layout=org.apache.log4j.PatternLayout
log4j.appender.R.layout.ConversionPattern=%d{ss,SSS} [%t] %-5p %c{2}.%M() - %m%n

log4j.appender.A.layout=org.apache.log4j.PatternLayout
log4j.appender.A.layout.ConversionPattern=%d{ss,SSS} [%t] %-5p %c{2}.%M() - %m%n


# ###################################################################
#   Configure some components that are overly verbose 
# ###################################################################

# Default Jetty server to only logging WARN since INFO can be verbose at points
log4j.category.org.eclipse.jetty=WARN
log4j.category.org.eclipse.jetty.server.handler=WARN

# Turning off logging for Java Xerces; emits WARNING messages during routine use
log4j.category.org.jdom2.transform=SEVERE

# Turning off logging for Java JMDNS; logs SEVERE and WARNING to j.u.l too routinely
log4j.category.com.strangeberry=OFF
log4j.category.javax.jmdns=OFF

# Turning off logging for the WebDriver Manager
log4j.category.io.github.bonigarcia.wdm=OFF

# Turn off logging for the JUnit 5 discovery process.
log4j.category.org.junit.vintage.engine.discovery=OFF

# ###################################################################
#    Examples of how you can ask for more detailed logging
# ###################################################################

# Valid priority names are FATAL, ERROR, WARN, INFO, DEBUG, and TRACE. 

# Examples of changing priority of specific categories (classes, packages):
#
# log4j.category.apps=DEBUG
# log4j.category.jmri.profile=DEBUG
# log4j.category.jmri.implementation.SignalSpeedMap=DEBUG
# log4j.category.jmri.jmrit.symbolicprog.DecVariableValue=DEBUG
# log4j.category.jmri.jmrit.symbolicprog=DEBUG
# log4j.category.jmri.jmrix.nce=DEBUG
# log4j.category.jmri.jmrix.nce.NceTrafficController=DEBUG
# log4j.category.jmri.jmrit.display.layoutEditor.configurexml=TRACE

# ###################################################################
#    Settings needed for specific tests (last so not accidentally overridden)
# ###################################################################

# Needed for Jenkins I18N testing
log4j.category.jmri.util.I18NTest=DEBUG

# Needed for jmri.util.Log4JUtilTest
log4j.category.jmri.util.Log4JUtilTest = WARN

# Force version info into early log
log4j.category.jmri.VersionTest = INFO

# Needed for jmri.util.JUnitAppenderTest
log4j.category.jmri.util.JUnitAppenderTest = INFO

# INFO is part of application tests
log4j.category.apps.Apps = INFO
log4j.category.apps.AppsBase = INFO
log4j.category.apps.PanelPro.PanelPro = INFO
log4j.category.apps.gui3.Apps3 = INFO
log4j.category.apps.gui3.dp3.DecoderPro3 = INFO