forked from AFPy/python-docs-fr
329 lines
12 KiB
Plaintext
329 lines
12 KiB
Plaintext
# Copyright (C) 2001-2018, Python Software Foundation
|
|
# For licence information, see README file.
|
|
#
|
|
#, fuzzy
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: Python 3.6\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2018-06-28 15:29+0200\n"
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|
"Language-Team: FRENCH <traductions@lists.afpy.org>\n"
|
|
"Language: fr\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:20
|
|
msgid ""
|
|
"Readline keybindings may be configured via an initialization file, typically "
|
|
"``.inputrc`` in your home directory. See `Readline Init File <https://"
|
|
"cnswww.cns.cwru.edu/php/chet/readline/rluserman.html#SEC9>`_ 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:29
|
|
msgid ""
|
|
"The underlying Readline library API may be implemented by the ``libedit`` "
|
|
"library instead of GNU readline. On macOS the :mod:`readline` module detects "
|
|
"which library is being used at run time."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:34
|
|
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:39
|
|
msgid ""
|
|
"If you use *editline*/``libedit`` readline emulation on macOS, the "
|
|
"initialization file located in your home directory is named ``.editrc``. For "
|
|
"example, the following content in ``~/.editrc`` will turn ON *vi* "
|
|
"keybindings and TAB completion::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:49
|
|
msgid "Init file"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:51
|
|
msgid "The following functions relate to the init file and user configuration:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:56
|
|
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:62
|
|
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:67
|
|
msgid "Line buffer"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:69
|
|
msgid "The following functions operate on the line buffer:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:74
|
|
msgid ""
|
|
"Return the current contents of the line buffer (:c:data:`rl_line_buffer` in "
|
|
"the underlying library)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:80
|
|
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:87
|
|
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:92
|
|
msgid "History file"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:94
|
|
msgid "The following functions operate on a history file:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:99
|
|
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:106
|
|
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:113
|
|
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:125
|
|
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:133
|
|
msgid "History list"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:135
|
|
msgid "The following functions operate on a global history list:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:140
|
|
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:147
|
|
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:154
|
|
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:160
|
|
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:167
|
|
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:174
|
|
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:180
|
|
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:193
|
|
msgid "Startup hooks"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:198
|
|
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:207
|
|
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:217
|
|
msgid "Completion"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:219
|
|
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:229
|
|
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:236
|
|
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:245
|
|
msgid ""
|
|
"Get the completer function, or ``None`` if no completer function has been "
|
|
"set."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:250
|
|
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:258
|
|
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:267
|
|
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:275
|
|
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:288
|
|
msgid "Example"
|
|
msgstr "Exemple"
|
|
|
|
#: ../Doc/library/readline.rst:290
|
|
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:310
|
|
msgid ""
|
|
"This code is actually automatically run when Python is run in :ref:"
|
|
"`interactive mode <tut-interactive>` (see :ref:`rlcompleter-config`)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:313
|
|
msgid ""
|
|
"The following example achieves the same goal but supports concurrent "
|
|
"interactive sessions, by only appending the new history. ::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/readline.rst:334
|
|
msgid ""
|
|
"The following example extends the :class:`code.InteractiveConsole` class to "
|
|
"support history save/restore. ::"
|
|
msgstr ""
|