bittensor.utils.btlogging

btlogging sub-package standardized logging for Bittensor.

This module provides logging functionality for the Bittensor package. It includes custom loggers, handlers, and formatters to ensure consistent logging throughout the project.

Submodules

• bittensor.utils.btlogging.defines
• bittensor.utils.btlogging.format
• bittensor.utils.btlogging.helpers
• bittensor.utils.btlogging.loggingmachine

Attributes

logging

Classes

LoggingMachine

Handles logger states for bittensor and 3rd party libraries.

Package Contents

class bittensor.utils.btlogging.LoggingMachine(config, name=BITTENSOR_LOGGER_NAME)

Bases: statemachine.StateMachine, logging.Logger

Handles logger states for bittensor and 3rd party libraries.

Initialize the logger with a name and an optional level.

Parameters:

• config (bittensor.core.config.Config)

• name (str)

Default

Debug

Trace

Disabled

Warning

enable_default

enable_info

enable_trace

enable_debug

enable_warning

disable_trace

disable_debug

disable_warning

disable_logging

_queue

_primary_loggers

_config

_stream_formatter

_file_formatter

_handlers

_listener

_logger

_enable_initial_state(config)

Set correct state action on initializing

_extract_logging_config(config)

Extract btlogging’s config from bittensor config

Parameters:

config (bittensor.core.config.Config) – Bittensor config instance.

Returns:

btlogging’s config from Bittensor config or Bittensor config.

Return type:

(dict)

_configure_handlers(config)

Return type:

list[logging.Handler]

get_config()

set_config(config)

Set config after initialization, if desired.

Parameters:

config (bittensor.core.config.Config) – Bittensor config instance.

_create_and_start_listener(handlers)

A listener to receive and publish log records.

This listener receives records from a queue populated by the main bittensor logger, as well as 3rd party loggers

get_queue()

Get the queue the QueueListener is publishing from.

To set up logging in a separate process, a QueueHandler must be added to all the desired loggers.

_initialize_bt_logger(name)

Initialize logging for bittensor.

Since the initial state is Default, logging level for the module logger is INFO, and all third-party loggers are silenced. Subsequent state transitions will handle all logger outputs.

Parameters:

name (str)

_deinitialize_bt_logger(name)

Find the logger by name and remove the queue handler associated with it.

Parameters:

name (str)

_create_file_handler(logfile)

Parameters:

logfile (str)

register_primary_logger(name)

Register a logger as primary logger

This adds a logger to the _primary_loggers set to ensure it doesn’t get disabled when disabling third-party loggers. A queue handler is also associated with it.

Parameters:

name (str) – the name for primary logger.

deregister_primary_logger(name)

De-registers a primary logger

This function removes the logger from the _primary_loggers set and deinitializes its queue handler

Parameters:

name (str) – the name of primary logger.

enable_third_party_loggers()

Enables logging for third-party loggers by adding a queue handler to each.

disable_third_party_loggers()

Disables logging for third-party loggers by removing all their handlers.

_enable_file_logging(logfile)

Parameters:

logfile (str)

before_transition(event, state)

Stops listener after transition.

after_transition(event, state)

Starts listener after transition.

before_enable_default()

Logs status before enable Default.

before_enable_info()

Logs status before enable Default.

after_enable_default()

before_enable_warning()

Logs status before enable Warning.

after_enable_warning()

Logs status after enable Warning.

before_enable_trace()

Logs status before enable Trace.

after_enable_trace()

Logs status after enable Trace.

before_disable_trace()

Logs status before disable Trace.

after_disable_trace()

Logs status after disable Trace.

before_enable_debug()

Logs status before enable Debug.

after_enable_debug()

Logs status after enable Debug.

before_disable_debug()

Logs status before disable Debug.

after_disable_debug()

Logs status after disable Debug.

before_disable_logging()

Prepares the logging system for disabling.

This method performs the following actions: 1. Logs an informational message indicating that logging is being disabled. 2. Disables trace mode in the stream formatter. 3. Sets the logging level to CRITICAL for all loggers.

This ensures that only critical messages will be logged after this method is called.

property __trace_on__: bool

Checks if the current state is in “Trace” mode.

Returns:

True if the current state is “Trace”, otherwise False.

Return type:

bool

trace(msg='', prefix='', suffix='', *args, **kwargs)

Wraps trace message with prefix and suffix.

debug(msg='', prefix='', suffix='', *args, **kwargs)

Wraps debug message with prefix and suffix.

info(msg='', prefix='', suffix='', *args, **kwargs)

Wraps info message with prefix and suffix.

success(msg='', prefix='', suffix='', *args, **kwargs)

Wraps success message with prefix and suffix.

warning(msg='', prefix='', suffix='', *args, **kwargs)

Wraps warning message with prefix and suffix.

error(msg='', prefix='', suffix='', *args, **kwargs)

Wraps error message with prefix and suffix.

critical(msg='', prefix='', suffix='', *args, **kwargs)

Wraps critical message with prefix and suffix.

exception(msg='', prefix='', suffix='', *args, **kwargs)

Wraps exception message with prefix and suffix.

on()

Enable default state.

off()

Disables all states.

set_debug(on=True)

Sets Debug state.

Parameters:

on (bool)

set_trace(on=True)

Sets Trace state.

Parameters:

on (bool)

set_warning(on=True)

Sets Warning state.

Parameters:

on (bool)

set_default()

Sets Default state.

set_info()

Sets Default state.

get_level()

Returns Logging level.

Return type:

int

check_config(config)

Parameters:

config (bittensor.core.config.Config)

help()

classmethod add_args(parser, prefix=None)

Accept specific arguments fro parser

Parameters:

• parser (argparse.ArgumentParser)

• prefix (str)

classmethod config()

Get config from the argument parser.

Returns:

config object

Return type:

config (bittensor.core.config.Config)

__call__(config=None, debug=None, trace=None, record_log=None, logging_dir=None)

Parameters:

• config (bittensor.core.config.Config)

• debug (bool)

• trace (bool)

• record_log (bool)

• logging_dir (str)

bittensor.utils.btlogging.logging