/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to breezy/ui/__init__.py

  • Committer: Jelmer Vernooij
  • Date: 2018-07-08 10:56:06 UTC
  • mto: This revision was merged to the branch mainline in revision 7030.
  • Revision ID: jelmer@jelmer.uk-20180708105606-d53hkks89qq88twu
Use separate .as_bytes method rather than __bytes__.

Show diffs side-by-side

added added

removed removed

Lines of Context:
breezy/ui/__init__.py
1
 
# Copyright (C) 2005-2010 Canonical Ltd
 
1
# Copyright (C) 2005-2011 Canonical Ltd
2
2
#
3
3
# This program is free software; you can redistribute it and/or modify
4
4
# it under the terms of the GNU General Public License as published by
22
22
Several levels are supported, and you can also register new factories such as
23
23
for a GUI.
24
24
 
25
 
bzrlib.ui.UIFactory
 
25
breezy.ui.UIFactory
26
26
    Semi-abstract base class
27
27
 
28
 
bzrlib.ui.SilentUIFactory
 
28
breezy.ui.SilentUIFactory
29
29
    Produces no output and cannot take any input; useful for programs using
30
 
    bzrlib in batch mode or for programs such as loggerhead.
 
30
    breezy in batch mode or for programs such as loggerhead.
31
31
 
32
 
bzrlib.ui.CannedInputUIFactory
33
 
    For use in testing; the input values to be returned are provided 
 
32
breezy.ui.CannedInputUIFactory
 
33
    For use in testing; the input values to be returned are provided
34
34
    at construction.
35
35
 
36
 
bzrlib.ui.text.TextUIFactory
 
36
breezy.ui.text.TextUIFactory
37
37
    Standard text command-line interface, with stdin, stdout, stderr.
38
38
    May make more or less advanced use of them, eg in drawing progress bars,
39
39
    depending on the detected capabilities of the terminal.
41
41
    back to working through the terminal.
42
42
"""
43
43
 
 
44
from __future__ import absolute_import
44
45
 
45
 
import os
46
 
import sys
47
46
import warnings
48
47
 
49
 
from bzrlib.lazy_import import lazy_import
 
48
from ..lazy_import import lazy_import
50
49
lazy_import(globals(), """
51
 
import getpass
52
 
 
53
 
from bzrlib import (
54
 
    errors,
 
50
from breezy import (
 
51
    config,
55
52
    osutils,
56
53
    progress,
57
 
    trace,
58
54
    )
59
55
""")
60
 
from bzrlib.symbol_versioning import (
61
 
    deprecated_function,
62
 
    deprecated_in,
63
 
    deprecated_method,
 
56
 
 
57
from ..sixish import (
 
58
    PY3,
 
59
    string_types,
 
60
    text_type,
64
61
    )
65
62
 
66
63
 
92
89
    if accepted_values is None:
93
90
        accepted_values = _valid_boolean_strings
94
91
    val = None
95
 
    if type(s) in (str, unicode):
 
92
    if isinstance(s, string_types):
96
93
        try:
97
94
            val = accepted_values[s.lower()]
98
95
        except KeyError:
100
97
    return val
101
98
 
102
99
 
 
100
class ConfirmationUserInterfacePolicy(object):
 
101
    """Wrapper for a UIFactory that allows or denies all confirmed actions."""
 
102
 
 
103
    def __init__(self, wrapped_ui, default_answer, specific_answers):
 
104
        """Generate a proxy UI that does no confirmations.
 
105
 
 
106
        :param wrapped_ui: Underlying UIFactory.
 
107
        :param default_answer: Bool for whether requests for
 
108
            confirmation from the user should be noninteractively accepted or
 
109
            denied.
 
110
        :param specific_answers: Map from confirmation_id to bool answer.
 
111
        """
 
112
        self.wrapped_ui = wrapped_ui
 
113
        self.default_answer = default_answer
 
114
        self.specific_answers = specific_answers
 
115
 
 
116
    def __getattr__(self, name):
 
117
        return getattr(self.wrapped_ui, name)
 
118
 
 
119
    def __repr__(self):
 
120
        return '%s(%r, %r, %r)' % (
 
121
            self.__class__.__name__,
 
122
            self.wrapped_ui,
 
123
            self.default_answer,
 
124
            self.specific_answers)
 
125
 
 
126
    def confirm_action(self, prompt, confirmation_id, prompt_kwargs):
 
127
        if confirmation_id in self.specific_answers:
 
128
            return self.specific_answers[confirmation_id]
 
129
        elif self.default_answer is not None:
 
130
            return self.default_answer
 
131
        else:
 
132
            return self.wrapped_ui.confirm_action(
 
133
                prompt, confirmation_id, prompt_kwargs)
 
134
 
 
135
 
103
136
class UIFactory(object):
104
137
    """UI abstraction.
105
138
 
106
139
    This tells the library how to display things to the user.  Through this
107
140
    layer different applications can choose the style of UI.
108
141
 
109
 
    :ivar suppressed_warnings: Identifiers for user warnings that should 
 
142
    UI Factories are also context managers, for some syntactic sugar some users
 
143
    need.
 
144
 
 
145
    :ivar suppressed_warnings: Identifiers for user warnings that should
110
146
        no be emitted.
111
147
    """
112
148
 
115
151
            "%(from_format)s to %(to_format)s.\n"
116
152
            "This may take some time. Upgrade the repositories to the "
117
153
            "same format for better performance."
118
 
            )
 
154
            ),
 
155
        experimental_format_fetch=("Fetching into experimental format "
 
156
            "%(to_format)s.\n"
 
157
            "This format may be unreliable or change in the future "
 
158
            "without an upgrade path.\n"),
 
159
        deprecated_command=(
 
160
            "The command 'brz %(deprecated_name)s' "
 
161
            "has been deprecated in brz %(deprecated_in_version)s. "
 
162
            "Please use 'brz %(recommended_name)s' instead."),
 
163
        deprecated_command_option=(
 
164
            "The option '%(deprecated_name)s' to 'brz %(command)s' "
 
165
            "has been deprecated in brz %(deprecated_in_version)s. "
 
166
            "Please use '%(recommended_name)s' instead."),
 
167
        recommend_upgrade=("%(current_format_name)s is deprecated "
 
168
            "and a better format is available.\n"
 
169
            "It is recommended that you upgrade by "
 
170
            "running the command\n"
 
171
            "  brz upgrade %(basedir)s"),
 
172
        locks_steal_dead=(
 
173
            u"Stole dead lock %(lock_url)s %(other_holder_info)s."),
 
174
        not_checking_ssl_cert=(
 
175
            u"Not checking SSL certificate for %(host)s."),
119
176
        )
120
177
 
121
178
    def __init__(self):
123
180
        self.suppressed_warnings = set()
124
181
        self._quiet = False
125
182
 
 
183
    def __enter__(self):
 
184
        """Context manager entry support.
 
185
 
 
186
        Override in a concrete factory class if initialisation before use is
 
187
        needed.
 
188
        """
 
189
        return self # This is bound to the 'as' clause in a with statement.
 
190
 
 
191
    def __exit__(self, exc_type, exc_val, exc_tb):
 
192
        """Context manager exit support.
 
193
 
 
194
        Override in a concrete factory class if more cleanup than a simple
 
195
        self.clear_term() is needed when the UIFactory is finished with.
 
196
        """
 
197
        self.clear_term()
 
198
        return False # propogate exceptions.
 
199
 
126
200
    def be_quiet(self, state):
127
201
        """Tell the UI to be more quiet, or not.
128
202
 
131
205
        """
132
206
        self._quiet = state
133
207
 
134
 
    def get_password(self, prompt='', **kwargs):
 
208
    def confirm_action(self, prompt, confirmation_id, prompt_kwargs):
 
209
        """Seek user confirmation for an action.
 
210
 
 
211
        If the UI is noninteractive, or the user does not want to be asked
 
212
        about this action, True is returned, indicating brz should just
 
213
        proceed.
 
214
 
 
215
        The confirmation id allows the user to configure certain actions to
 
216
        always be confirmed or always denied, and for UIs to specialize the
 
217
        display of particular confirmations.
 
218
 
 
219
        :param prompt: Suggested text to display to the user.
 
220
        :param prompt_kwargs: A dictionary of arguments that can be
 
221
            string-interpolated into the prompt.
 
222
        :param confirmation_id: Unique string identifier for the confirmation.
 
223
        """
 
224
        return self.get_boolean(prompt % prompt_kwargs)
 
225
 
 
226
    def get_password(self, prompt=u'', **kwargs):
135
227
        """Prompt the user for a password.
136
228
 
137
 
        :param prompt: The prompt to present the user
 
229
        :param prompt: The prompt to present the user (must be unicode)
138
230
        :param kwargs: Arguments which will be expanded into the prompt.
139
231
                       This lets front ends display different things if
140
232
                       they so choose.
149
241
    def is_quiet(self):
150
242
        return self._quiet
151
243
 
152
 
    def make_output_stream(self, encoding=None, encoding_type=None):
 
244
    def make_output_stream(self, encoding=None, encoding_type='replace'):
153
245
        """Get a stream for sending out bulk text data.
154
246
 
155
247
        This is used for commands that produce bulk text, such as log or diff
156
248
        output, as opposed to user interaction.  This should work even for
157
249
        non-interactive user interfaces.  Typically this goes to a decorated
158
 
        version of stdout, but in a GUI it might be appropriate to send it to a 
 
250
        version of stdout, but in a GUI it might be appropriate to send it to a
159
251
        window displaying the text.
160
 
     
161
 
        :param encoding: Unicode encoding for output; default is the 
162
 
            terminal encoding, which may be different from the user encoding.
 
252
 
 
253
        The caller may flush but should not close the returned stream.
 
254
 
 
255
        :param encoding: Unicode encoding for output; if not specified
 
256
            uses the configured 'output_encoding' if any; otherwise the
 
257
            terminal encoding.
163
258
            (See get_terminal_encoding.)
164
259
 
165
260
        :param encoding_type: How to handle encoding errors:
166
261
            replace/strict/escape/exact.  Default is replace.
167
262
        """
168
 
        # XXX: is the caller supposed to close the resulting object?
169
 
        if encoding is None:
170
 
            encoding = osutils.get_terminal_encoding()
171
 
        if encoding_type is None:
172
 
            encoding_type = 'replace'
173
263
        out_stream = self._make_output_stream_explicit(encoding, encoding_type)
174
264
        return out_stream
175
265
 
226
316
        try:
227
317
            template = self._user_warning_templates[warning_id]
228
318
        except KeyError:
229
 
            fail = "failed to format warning %r, %r" % (warning_id, message_args)
230
 
            warnings.warn(fail)   # so tests will fail etc
231
 
            return fail
 
319
            fail = "brz warning: %r, %r" % (warning_id, message_args)
 
320
            warnings.warn("no template for warning: " + fail)   # so tests will fail etc
 
321
            return text_type(fail)
232
322
        try:
233
 
            return template % message_args
234
 
        except ValueError, e:
235
 
            fail = "failed to format warning %r, %r: %s" % (
 
323
            return text_type(template) % message_args
 
324
        except ValueError as e:
 
325
            fail = "brz unprintable warning: %r, %r, %s" % (
236
326
                warning_id, message_args, e)
237
327
            warnings.warn(fail)   # so tests will fail etc
238
 
            return fail
 
328
            return text_type(fail)
 
329
 
 
330
    def choose(self, msg, choices, default=None):
 
331
        """Prompt the user for a list of alternatives.
 
332
 
 
333
        :param msg: message to be shown as part of the prompt.
 
334
 
 
335
        :param choices: list of choices, with the individual choices separated
 
336
            by '\n', e.g.: choose("Save changes?", "&Yes\n&No\n&Cancel"). The
 
337
            letter after the '&' is the shortcut key for that choice. Thus you
 
338
            can type 'c' to select "Cancel".  Shorcuts are case insensitive.
 
339
            The shortcut does not need to be the first letter. If a shorcut key
 
340
            is not provided, the first letter for the choice will be used.
 
341
 
 
342
        :param default: default choice (index), returned for example when enter
 
343
            is pressed for the console version.
 
344
 
 
345
        :return: the index fo the user choice (so '0', '1' or '2' for
 
346
            respectively yes/no/cancel in the previous example).
 
347
        """
 
348
        raise NotImplementedError(self.choose)
239
349
 
240
350
    def get_boolean(self, prompt):
241
351
        """Get a boolean question answered from the user.
242
352
 
243
353
        :param prompt: a message to prompt the user with. Should be a single
244
 
        line without terminating \n.
 
354
            line without terminating \\n.
245
355
        :return: True or False for y/yes or n/no.
246
356
        """
247
 
        raise NotImplementedError(self.get_boolean)
 
357
        choice = self.choose(prompt + '?', '&yes\n&no', default=None)
 
358
        return 0 == choice
248
359
 
249
360
    def get_integer(self, prompt):
250
361
        """Get an integer from the user.
251
362
 
252
363
        :param prompt: a message to prompt the user with. Could be a multi-line
253
 
            prompt but without a terminating \n.
 
364
            prompt but without a terminating \\n.
254
365
 
255
366
        :return: A signed integer.
256
367
        """
264
375
        """
265
376
        return NullProgressView()
266
377
 
267
 
    def recommend_upgrade(self,
268
 
        current_format_name,
269
 
        basedir):
270
 
        # XXX: this should perhaps be in the TextUIFactory and the default can do
271
 
        # nothing
272
 
        #
273
 
        # XXX: Change to show_user_warning - that will accomplish the previous
274
 
        # xxx. -- mbp 2010-02-25
275
 
        trace.warning("%s is deprecated "
276
 
            "and a better format is available.\n"
277
 
            "It is recommended that you upgrade by "
278
 
            "running the command\n"
279
 
            "  bzr upgrade %s",
280
 
            current_format_name,
281
 
            basedir)
 
378
    def recommend_upgrade(self, current_format_name, basedir):
 
379
        """Recommend the user upgrade a control directory.
 
380
 
 
381
        :param current_format_name: Description of the current format
 
382
        :param basedir: Location of the control dir
 
383
        """
 
384
        self.show_user_warning('recommend_upgrade',
 
385
            current_format_name=current_format_name, basedir=basedir)
282
386
 
283
387
    def report_transport_activity(self, transport, byte_count, direction):
284
388
        """Called by transports as they do IO.
308
412
        outdated formats), not for internal program warnings like deprecated
309
413
        APIs.
310
414
 
311
 
        This can be overridden by UIFactory subclasses to show it in some 
 
415
        This can be overridden by UIFactory subclasses to show it in some
312
416
        appropriate way; the default UIFactory is noninteractive and does
313
417
        nothing.  format_user_warning maps it to a string, though other
314
418
        presentations can be used for particular UIs.
315
419
 
316
 
        :param warning_id: An identifier like 'cross_format_fetch' used to 
 
420
        :param warning_id: An identifier like 'cross_format_fetch' used to
317
421
            check if the message is suppressed and to look up the string.
318
422
        :param message_args: Arguments to be interpolated into the message.
319
423
        """
321
425
 
322
426
    def show_error(self, msg):
323
427
        """Show an error message (not an exception) to the user.
324
 
        
 
428
 
325
429
        The message should not have an error prefix or trailing newline.  That
326
430
        will be added by the factory if appropriate.
327
431
        """
335
439
        """Show a warning to the user."""
336
440
        raise NotImplementedError(self.show_warning)
337
441
 
338
 
    def warn_cross_format_fetch(self, from_format, to_format):
339
 
        """Warn about a potentially slow cross-format transfer.
340
 
        
341
 
        This is deprecated in favor of show_user_warning, but retained for api
342
 
        compatibility in 2.0 and 2.1.
343
 
        """
344
 
        self.show_user_warning('cross_format_fetch', from_format=from_format,
345
 
            to_format=to_format)
346
 
 
347
 
    def warn_experimental_format_fetch(self, inter):
348
 
        """Warn about fetching into experimental repository formats."""
349
 
        if inter.target._format.experimental:
350
 
            trace.warning("Fetching into experimental format %s.\n"
351
 
                "This format may be unreliable or change in the future "
352
 
                "without an upgrade path.\n" % (inter.target._format,))
353
 
 
354
 
 
355
 
 
356
 
class SilentUIFactory(UIFactory):
 
442
 
 
443
class NoninteractiveUIFactory(UIFactory):
 
444
    """Base class for UIs with no user."""
 
445
 
 
446
    def confirm_action(self, prompt, confirmation_id, prompt_kwargs):
 
447
        return True
 
448
 
 
449
    def __repr__(self):
 
450
        return '%s()' % (self.__class__.__name__, )
 
451
 
 
452
 
 
453
class SilentUIFactory(NoninteractiveUIFactory):
357
454
    """A UI Factory which never prints anything.
358
455
 
359
456
    This is the default UI, if another one is never registered by a program
360
 
    using bzrlib, and it's also active for example inside 'bzr serve'.
 
457
    using breezy, and it's also active for example inside 'brz serve'.
361
458
 
362
459
    Methods that try to read from the user raise an error; methods that do
363
460
    output do nothing.
394
491
    def __repr__(self):
395
492
        return "%s(%r)" % (self.__class__.__name__, self.responses)
396
493
 
 
494
    def confirm_action(self, prompt, confirmation_id, args):
 
495
        return self.get_boolean(prompt % args)
 
496
 
397
497
    def get_boolean(self, prompt):
398
498
        return self.responses.pop(0)
399
499
 
400
500
    def get_integer(self, prompt):
401
501
        return self.responses.pop(0)
402
502
 
403
 
    def get_password(self, prompt='', **kwargs):
 
503
    def get_password(self, prompt=u'', **kwargs):
404
504
        return self.responses.pop(0)
405
505
 
406
506
    def get_username(self, prompt, **kwargs):
422
522
    """
423
523
    # this is now always TextUIFactory, which in turn decides whether it
424
524
    # should display progress bars etc
425
 
    from bzrlib.ui.text import TextUIFactory
 
525
    from .text import TextUIFactory
426
526
    return TextUIFactory(stdin, stdout, stderr)
427
527
 
428
528