abjad.contextmanagers

abjad.contextmanagers.temporary_directory_change(...)	Temporary directory change context manager.
abjad.contextmanagers.FilesystemState(*[, ...])	Filesystem state context manager.
abjad.contextmanagers.ForbidUpdate(component, *)	Forbid update context manager.
abjad.contextmanagers.NullContextManager()	Null context manager.
abjad.contextmanagers.RedirectedStreams(*[, ...])	Redirected streams context manager.
abjad.contextmanagers.Timer(*[, ...])	Timer context manager.

abjad.contextmanagers.temporary_directory_change(directory: str | PathLike) → Iterator[None]

Temporary directory change context manager.

class abjad.contextmanagers.FilesystemState(*, keep: list[Path] | None = None, remove: list[Path] | None = None)

Filesystem state context manager.

keep()	Gets paths to restore on exit.
remove()	Gets paths to remove on exit.

keep() → tuple[str, ...]

Gets paths to restore on exit.

remove() → tuple[str, ...]

Gets paths to remove on exit.

class abjad.contextmanagers.ForbidUpdate(component: Component, *, update_on_exit: bool = False)

Forbid update context manager.

component()	Gets component.
update_on_exit()	Is true when context manager updates offsets on exit.

component() → Component

Gets component.

update_on_exit() → bool

Is true when context manager updates offsets on exit.

class abjad.contextmanagers.NullContextManager

Null context manager.

class abjad.contextmanagers.RedirectedStreams(*, stdout: TextIO | None = None, stderr: TextIO | None = None)

Redirected streams context manager.

Captures stdout and stderr output:

>>> import io
>>> string_io = io.StringIO()
>>> with abjad.contextmanagers.RedirectedStreams(stdout=string_io):
...     print("hello, world!")
... 
>>> result = string_io.getvalue()
>>> string_io.close()
>>> print(result)
hello, world!

stderr()	Gets stderr of context manager.
stdout()	Gets stdout of context manager.

stderr() → TextIO

Gets stderr of context manager.

stdout() → TextIO

Gets stdout of context manager.

class abjad.contextmanagers.Timer(*, enter_message: str = '', exit_message: str = '', print_continuously_from_background: bool = False, verbose: bool = True)

Timer context manager.

Prints elapsed time after timer finishes:

>>> timer = abjad.contextmanagers.Timer()
>>> with timer:
...     for _ in range(1000000):
...         x = 1 + 1
... 
>>> timer.elapsed_time()  
0.023431062698364258

Prints elapsed time while timer is running; timers can be reused between with-blocks:

>>> with abjad.contextmanagers.Timer() as timer:  
...     for _ in range(5):
...         for _ in range(1000000):
...             x = 1 + 1
...         print(timer.elapsed_time())
... 
0.02382516860961914
0.047647953033447266
0.07144689559936523
0.09526300430297852
0.11903500556945801

elapsed_time()	Gets elapsed time of timer.
enter_message()	Gets timer enter message.
exit_message()	Gets timer exit message.
print_continuously_from_background()	Is true when timer prints continuously from background.
start_time()	Gets start time of timer.
stop_time()	Gets stop time of timer.
total_time_message()	Gets total time message, truncated to nearest second.
verbose()	Is true when timer prints messages.

elapsed_time() → float

Gets elapsed time of timer.

enter_message() → str

Gets timer enter message.

exit_message() → str

Gets timer exit message.

print_continuously_from_background() → bool

Is true when timer prints continuously from background.

start_time() → float | None

Gets start time of timer.

stop_time() → float | None

Gets stop time of timer.

total_time_message() → str

Gets total time message, truncated to nearest second.

verbose() → bool

Is true when timer prints messages.