Конфигурация

Параметры конфигурации

Загрузка, сохранение и состояние конфигурации

Хотя восстановить все параметры конфигурации до значений по умолчанию можно с помощью restore_defaults, иногда полезно сбросить и отдельные параметры. Для этого достаточно присвоить соответствующему значению None, например:

pl.Config.set_tbl_rows(None)

Использование в качестве менеджера контекста

Обратите внимание, что Config поддерживает установку параметров, ограниченных контекстом. Эти параметры действуют только в течение области видимости и при выходе из нее сбрасываются до исходных значений (которые были до входа в новый контекст).

Для этого можно создать экземпляр Config, а затем явно вызвать для него один или несколько доступных методов «set_»…

with pl.Config() as cfg:
    cfg.set_verbose(True)
    do_various_things()

# on scope exit any modified settings are restored to their previous state

…или, что часто бывает удобнее, задать параметры непосредственно при инициализации Config (при желании для краткости опустив префикс «set_»):

with pl.Config(verbose=True):
    do_various_things()

Использование в качестве декоратора

Аналогичным образом экземпляр Config можно использовать как декоратор функции, чтобы временно задавать параметры на время ее вызова:

cfg_ascii_frames = pl.Config(ascii_tables=True, apply_on_context_enter=True)

@cfg_ascii_frames
def write_markdown_frame_to_stdout(df: pl.DataFrame) -> None:
    sys.stdout.write(str(df))

Несколько экземпляров Config

Возможно, вам понадобится создать связанные наборы параметров Config для использования в разных частях кода. Обычно параметры устанавливаются сразу при инициализации Config, поэтому экземпляр Config нельзя использовать повторно. Однако можно отложить это действие, чтобы параметры применялись только при входе в область контекста (в том числе при входе в функцию, если экземпляр используется как декоратор)._

Это позволяет создать в одном месте несколько повторно используемых экземпляров Config, централизованно обновлять и изменять их и применять по мере необходимости в кодовой базе.

cfg_verbose = pl.Config(verbose=True, apply_on_context_enter=True)
cfg_markdown = pl.Config(tbl_formatting="MARKDOWN", apply_on_context_enter=True)

@cfg_markdown
def write_markdown_frame_to_stdout(df: pl.DataFrame) -> None:
    sys.stdout.write(str(df))

@cfg_verbose
def do_various_things():
    ...