Build the API documentation via pdoc and reference it from the main documentation. This has the advantage that new code will be automatically included into the pdoc generated result. Another advantage is that the search field on the main page is not primarily hitting search results from the big API documentation and that the search field on the API page only searches within the API documentation.
17 lines
506 B
Python
17 lines
506 B
Python
"""
|
|
API Documentation
|
|
"""
|
|
import logging
|
|
|
|
from kiwi.logger import Logger
|
|
|
|
# Initialize custom logger class for kiwi
|
|
logging.setLoggerClass(Logger)
|
|
|
|
# Set the highest log level possible as the default log level
|
|
# in the main Logger class. This is needed to allow any logfile
|
|
# handler to log all messages by default and to allow custom log
|
|
# levels per handler. Our own implementation in Logger::setLogLevel
|
|
# will then set the log level on a handler basis
|
|
logging.getLogger('kiwi').setLevel(logging.DEBUG)
|