gui.utils.verse_output_handler

File:

EuljiroBible/gui/utils/verse_output_handler.py

Author:

Benjamin Jaedon Choi - https://github.com/saintbenjamin

Affiliated Church:

The Eulji-ro Presbyterian Church [대한예수교장로회(통합) 을지로교회]

Address:

The Eulji-ro Presbyterian Church, 24-10, Eulji-ro 20-gil, Jung-gu, Seoul 04549, South Korea

Telephone:

+82-2-2266-3070

E-mail:

euljirochurch [at] G.M.A.I.L. (replace [at] with @ and G.M.A.I.L as you understood.)

License:

MIT License with Attribution Requirement (see LICENSE file for details); Copyright (c) 2025 The Eulji-ro Presbyterian Church.

Handles text display and file saving for formatted Bible verses in the GUI.

class gui.utils.verse_output_handler.VerseOutputHandler(display_box, settings)[source]

Bases: object

Manages displaying and saving Bible verse text in the GUI.

This class is responsible for:

  • Rendering formatted Bible verse text into a QTextEdit widget.

  • Applying consistent paragraph formatting (e.g. line spacing).

  • Delegating persistence of verse output to file-based utilities.

Parameters:
  • display_box (PySide6.QtWidgets.QTextEdit)

  • settings (dict)

display_box

Text edit widget used to display verse output to the user.

Type:

QTextEdit

settings

Application settings dictionary. This typically includes output paths and related configuration used when saving verse text.

Type:

dict

__init__(display_box, settings)[source]

Initialize the handler with the display widget and configuration.

Parameters:
  • display_box (QTextEdit) – QTextEdit area for displaying verse output.

  • settings (dict) – Dictionary containing application settings (e.g. output paths, polling options).

apply_output_text(text)[source]

Display the given verse text in the output box with formatting applied.

The text is rendered into the QTextEdit and a block format is applied to enforce approximately 150% line spacing across the entire document.

Parameters:

text (str) – Verse text to render in the output box.

save_verse(formatted_text)[source]

Save the formatted verse text to output file(s).

If the provided text is empty or None, it is treated as an empty string. Actual file writing is delegated to the output utility layer.

Parameters:

formatted_text (str) – Formatted verse text to be saved.