# SOME DESCRIPTIVE TITLE. # Copyright (C) 2001-2016, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.6\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2017-04-02 22:11+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #: ../Doc/library/readline.rst:2 msgid ":mod:`readline` --- GNU readline interface" msgstr "" #: ../Doc/library/readline.rst:12 msgid "" "The :mod:`readline` module defines a number of functions to facilitate " "completion and reading/writing of history files from the Python interpreter. " "This module can be used directly, or via the :mod:`rlcompleter` module, " "which supports completion of Python identifiers at the interactive prompt. " "Settings made using this module affect the behaviour of both the " "interpreter's interactive prompt and the prompts offered by the built-in :" "func:`input` function." msgstr "" #: ../Doc/library/readline.rst:22 msgid "" "The underlying Readline library API may be implemented by the ``libedit`` " "library instead of GNU readline. On MacOS X the :mod:`readline` module " "detects which library is being used at run time." msgstr "" #: ../Doc/library/readline.rst:27 msgid "" "The configuration file for ``libedit`` is different from that of GNU " "readline. If you programmatically load configuration strings you can check " "for the text \"libedit\" in :const:`readline.__doc__` to differentiate " "between GNU readline and libedit." msgstr "" #: ../Doc/library/readline.rst:32 msgid "" "Readline keybindings may be configured via an initialization file, typically " "``.inputrc`` in your home directory. See `Readline Init File `_ in the GNU " "Readline manual for information about the format and allowable constructs of " "that file, and the capabilities of the Readline library in general." msgstr "" #: ../Doc/library/readline.rst:41 msgid "Init file" msgstr "" #: ../Doc/library/readline.rst:43 msgid "The following functions relate to the init file and user configuration:" msgstr "" #: ../Doc/library/readline.rst:48 msgid "" "Execute the init line provided in the *string* argument. This calls :c:func:" "`rl_parse_and_bind` in the underlying library." msgstr "" #: ../Doc/library/readline.rst:54 msgid "" "Execute a readline initialization file. The default filename is the last " "filename used. This calls :c:func:`rl_read_init_file` in the underlying " "library." msgstr "" #: ../Doc/library/readline.rst:59 msgid "Line buffer" msgstr "" #: ../Doc/library/readline.rst:61 msgid "The following functions operate on the line buffer:" msgstr "" #: ../Doc/library/readline.rst:66 msgid "" "Return the current contents of the line buffer (:c:data:`rl_line_buffer` in " "the underlying library)." msgstr "" #: ../Doc/library/readline.rst:72 msgid "" "Insert text into the line buffer at the cursor position. This calls :c:func:" "`rl_insert_text` in the underlying library, but ignores the return value." msgstr "" #: ../Doc/library/readline.rst:79 msgid "" "Change what's displayed on the screen to reflect the current contents of the " "line buffer. This calls :c:func:`rl_redisplay` in the underlying library." msgstr "" #: ../Doc/library/readline.rst:84 msgid "History file" msgstr "" #: ../Doc/library/readline.rst:86 msgid "The following functions operate on a history file:" msgstr "" #: ../Doc/library/readline.rst:91 msgid "" "Load a readline history file, and append it to the history list. The default " "filename is :file:`~/.history`. This calls :c:func:`read_history` in the " "underlying library." msgstr "" #: ../Doc/library/readline.rst:98 msgid "" "Save the history list to a readline history file, overwriting any existing " "file. The default filename is :file:`~/.history`. This calls :c:func:" "`write_history` in the underlying library." msgstr "" #: ../Doc/library/readline.rst:105 msgid "" "Append the last *nelements* items of history to a file. The default " "filename is :file:`~/.history`. The file must already exist. This calls :c:" "func:`append_history` in the underlying library. This function only exists " "if Python was compiled for a version of the library that supports it." msgstr "" #: ../Doc/library/readline.rst:117 msgid "" "Set or return the desired number of lines to save in the history file. The :" "func:`write_history_file` function uses this value to truncate the history " "file, by calling :c:func:`history_truncate_file` in the underlying library. " "Negative values imply unlimited history file size." msgstr "" #: ../Doc/library/readline.rst:125 msgid "History list" msgstr "" #: ../Doc/library/readline.rst:127 msgid "The following functions operate on a global history list:" msgstr "" #: ../Doc/library/readline.rst:132 msgid "" "Clear the current history. This calls :c:func:`clear_history` in the " "underlying library. The Python function only exists if Python was compiled " "for a version of the library that supports it." msgstr "" #: ../Doc/library/readline.rst:139 msgid "" "Return the number of items currently in the history. (This is different " "from :func:`get_history_length`, which returns the maximum number of lines " "that will be written to a history file.)" msgstr "" #: ../Doc/library/readline.rst:146 msgid "" "Return the current contents of history item at *index*. The item index is " "one-based. This calls :c:func:`history_get` in the underlying library." msgstr "" #: ../Doc/library/readline.rst:152 msgid "" "Remove history item specified by its position from the history. The position " "is zero-based. This calls :c:func:`remove_history` in the underlying " "library." msgstr "" #: ../Doc/library/readline.rst:159 msgid "" "Replace history item specified by its position with *line*. The position is " "zero-based. This calls :c:func:`replace_history_entry` in the underlying " "library." msgstr "" #: ../Doc/library/readline.rst:166 msgid "" "Append *line* to the history buffer, as if it was the last line typed. This " "calls :c:func:`add_history` in the underlying library." msgstr "" #: ../Doc/library/readline.rst:172 msgid "" "Enable or disable automatic calls to :c:func:`add_history` when reading " "input via readline. The *enabled* argument should be a Boolean value that " "when true, enables auto history, and that when false, disables auto history." msgstr "" #: ../Doc/library/readline.rst:185 msgid "Startup hooks" msgstr "" #: ../Doc/library/readline.rst:190 msgid "" "Set or remove the function invoked by the :c:data:`rl_startup_hook` callback " "of the underlying library. If *function* is specified, it will be used as " "the new hook function; if omitted or ``None``, any function already " "installed is removed. The hook is called with no arguments just before " "readline prints the first prompt." msgstr "" #: ../Doc/library/readline.rst:199 msgid "" "Set or remove the function invoked by the :c:data:`rl_pre_input_hook` " "callback of the underlying library. If *function* is specified, it will be " "used as the new hook function; if omitted or ``None``, any function already " "installed is removed. The hook is called with no arguments after the first " "prompt has been printed and just before readline starts reading input " "characters. This function only exists if Python was compiled for a version " "of the library that supports it." msgstr "" #: ../Doc/library/readline.rst:209 msgid "Completion" msgstr "" #: ../Doc/library/readline.rst:211 msgid "" "The following functions relate to implementing a custom word completion " "function. This is typically operated by the Tab key, and can suggest and " "automatically complete a word being typed. By default, Readline is set up " "to be used by :mod:`rlcompleter` to complete Python identifiers for the " "interactive interpreter. If the :mod:`readline` module is to be used with a " "custom completer, a different set of word delimiters should be set." msgstr "" #: ../Doc/library/readline.rst:221 msgid "" "Set or remove the completer function. If *function* is specified, it will " "be used as the new completer function; if omitted or ``None``, any completer " "function already installed is removed. The completer function is called as " "``function(text, state)``, for *state* in ``0``, ``1``, ``2``, ..., until it " "returns a non-string value. It should return the next possible completion " "starting with *text*." msgstr "" #: ../Doc/library/readline.rst:228 msgid "" "The installed completer function is invoked by the *entry_func* callback " "passed to :c:func:`rl_completion_matches` in the underlying library. The " "*text* string comes from the first parameter to the :c:data:" "`rl_attempted_completion_function` callback of the underlying library." msgstr "" #: ../Doc/library/readline.rst:237 msgid "" "Get the completer function, or ``None`` if no completer function has been " "set." msgstr "" #: ../Doc/library/readline.rst:242 msgid "" "Get the type of completion being attempted. This returns the :c:data:" "`rl_completion_type` variable in the underlying library as an integer." msgstr "" #: ../Doc/library/readline.rst:250 msgid "" "Get the beginning or ending index of the completion scope. These indexes are " "the *start* and *end* arguments passed to the :c:data:" "`rl_attempted_completion_function` callback of the underlying library." msgstr "" #: ../Doc/library/readline.rst:259 msgid "" "Set or get the word delimiters for completion. These determine the start of " "the word to be considered for completion (the completion scope). These " "functions access the :c:data:`rl_completer_word_break_characters` variable " "in the underlying library." msgstr "" #: ../Doc/library/readline.rst:267 msgid "" "Set or remove the completion display function. If *function* is specified, " "it will be used as the new completion display function; if omitted or " "``None``, any completion display function already installed is removed. " "This sets or clears the :c:data:`rl_completion_display_matches_hook` " "callback in the underlying library. The completion display function is " "called as ``function(substitution, [matches], longest_match_length)`` once " "each time matches need to be displayed." msgstr "" #: ../Doc/library/readline.rst:280 msgid "Example" msgstr "Exemple" #: ../Doc/library/readline.rst:282 msgid "" "The following example demonstrates how to use the :mod:`readline` module's " "history reading and writing functions to automatically load and save a " "history file named :file:`.python_history` from the user's home directory. " "The code below would normally be executed automatically during interactive " "sessions from the user's :envvar:`PYTHONSTARTUP` file. ::" msgstr "" #: ../Doc/library/readline.rst:302 msgid "" "This code is actually automatically run when Python is run in :ref:" "`interactive mode ` (see :ref:`rlcompleter-config`)." msgstr "" #: ../Doc/library/readline.rst:305 msgid "" "The following example achieves the same goal but supports concurrent " "interactive sessions, by only appending the new history. ::" msgstr "" #: ../Doc/library/readline.rst:326 msgid "" "The following example extends the :class:`code.InteractiveConsole` class to " "support history save/restore. ::" msgstr ""