summaryrefslogtreecommitdiffstats
path: root/editor.py
blob: 359cff938bf63bc4156173f8b8ff5d3968ddeba1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
# Copyright (C) 2008 The Android Open Source Project
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#      http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

import os
import re
import subprocess
import sys
import tempfile

from error import EditorError
import platform_utils


class Editor:
    """Manages the user's preferred text editor."""

    _editor = None
    globalConfig = None

    @classmethod
    def _GetEditor(cls):
        if cls._editor is None:
            cls._editor = cls._SelectEditor()
        return cls._editor

    @classmethod
    def _SelectEditor(cls):
        e = os.getenv("GIT_EDITOR")
        if e:
            return e

        if cls.globalConfig:
            e = cls.globalConfig.GetString("core.editor")
            if e:
                return e

        e = os.getenv("VISUAL")
        if e:
            return e

        e = os.getenv("EDITOR")
        if e:
            return e

        if os.getenv("TERM") == "dumb":
            print(
                """No editor specified in GIT_EDITOR, core.editor, VISUAL or EDITOR.
Tried to fall back to vi but terminal is dumb.  Please configure at
least one of these before using this command.""",  # noqa: E501
                file=sys.stderr,
            )
            sys.exit(1)

        return "vi"

    @classmethod
    def EditString(cls, data):
        """Opens an editor to edit the given content.

        Args:
            data: The text to edit.

        Returns:
            New value of edited text.

        Raises:
            EditorError: The editor failed to run.
        """
        editor = cls._GetEditor()
        if editor == ":":
            return data

        fd, path = tempfile.mkstemp()
        try:
            os.write(fd, data.encode("utf-8"))
            os.close(fd)
            fd = None

            if platform_utils.isWindows():
                # Split on spaces, respecting quoted strings
                import shlex

                args = shlex.split(editor)
                shell = False
            elif re.compile("^.*[$ \t'].*$").match(editor):
                args = [editor + ' "$@"', "sh"]
                shell = True
            else:
                args = [editor]
                shell = False
            args.append(path)

            try:
                rc = subprocess.Popen(args, shell=shell).wait()
            except OSError as e:
                raise EditorError(f"editor failed, {str(e)}: {editor} {path}")
            if rc != 0:
                raise EditorError(
                    "editor failed with exit status %d: %s %s"
                    % (rc, editor, path)
                )

            with open(path, mode="rb") as fd2:
                return fd2.read().decode("utf-8")
        finally:
            if fd:
                os.close(fd)
            platform_utils.remove(path)