Source code for spacr.qt.safespacr

"""Start spaCR in safe mode, with every preference read as its default.

When a saved preference is what makes spaCR die on launch there is otherwise
no way in -- the ordinary start reads that preference before it has drawn
anything. ``safespacr`` reads every preference as its default instead, turns
off the backdrop, setting animations, verbose logging and preloading, and
opens far enough for the user to change a value and save it.

Writes go to the real preference store. A safe mode that saved to a scratch
file would leave the broken value in place, and the next ordinary start
would fail on it again.
"""
from __future__ import annotations

import os
import sys




def main(argv: list[str] | None = None) -> int:
    """Launch spaCR with preferences read as defaults and extras off.

    :param argv: Optional spaCR command-line arguments. ``None`` reads
        ``sys.argv[1:]``.
    :returns: Application exit code from :func:`spacr.qt.run`.
    """
    from .preferences import enable_safe_mode
    enable_safe_mode()

    os.environ.pop("SPACR_TIMING", None)
    os.environ["SPACR_NO_GL"] = "1"
    os.environ["SPACR_NO_BACKDROP"] = "1"

    print("spaCR safe mode: preferences are being READ as defaults; the "
          "backdrop, setting animations, verbose logging and preloading "
          "are off. Anything you save is written normally.",
          file=sys.stderr)

    argv = list(sys.argv[1:] if argv is None else argv)
    if "--no-setup" not in argv:
        argv = ["--no-setup", *argv]

    from . import run
    return run(argv)



if __name__ == "__main__":
    sys.exit(main())