forked from AFPy/python-docs-fr
307 lines
11 KiB
Plaintext
307 lines
11 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 2001-2016, Python Software Foundation
|
|
# This file is distributed under the same license as the Python package.
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, 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 <EMAIL@ADDRESS>\n"
|
|
"Language-Team: LANGUAGE <LL@li.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/cmd.rst:2
|
|
msgid ":mod:`cmd` --- Support for line-oriented command interpreters"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:9
|
|
msgid "**Source code:** :source:`Lib/cmd.py`"
|
|
msgstr "**Code source:** :source:`Lib/cmd.py`"
|
|
|
|
#: ../Doc/library/cmd.rst:13
|
|
msgid ""
|
|
"The :class:`Cmd` class provides a simple framework for writing line-oriented "
|
|
"command interpreters. These are often useful for test harnesses, "
|
|
"administrative tools, and prototypes that will later be wrapped in a more "
|
|
"sophisticated interface."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:20
|
|
msgid ""
|
|
"A :class:`Cmd` instance or subclass instance is a line-oriented interpreter "
|
|
"framework. There is no good reason to instantiate :class:`Cmd` itself; "
|
|
"rather, it's useful as a superclass of an interpreter class you define "
|
|
"yourself in order to inherit :class:`Cmd`'s methods and encapsulate action "
|
|
"methods."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:25
|
|
msgid ""
|
|
"The optional argument *completekey* is the :mod:`readline` name of a "
|
|
"completion key; it defaults to :kbd:`Tab`. If *completekey* is not :const:"
|
|
"`None` and :mod:`readline` is available, command completion is done "
|
|
"automatically."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:29
|
|
msgid ""
|
|
"The optional arguments *stdin* and *stdout* specify the input and output "
|
|
"file objects that the Cmd instance or subclass instance will use for input "
|
|
"and output. If not specified, they will default to :data:`sys.stdin` and :"
|
|
"data:`sys.stdout`."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:34
|
|
msgid ""
|
|
"If you want a given *stdin* to be used, make sure to set the instance's :"
|
|
"attr:`use_rawinput` attribute to ``False``, otherwise *stdin* will be "
|
|
"ignored."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:42
|
|
msgid "Cmd Objects"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:44
|
|
msgid "A :class:`Cmd` instance has the following methods:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:49
|
|
msgid ""
|
|
"Repeatedly issue a prompt, accept input, parse an initial prefix off the "
|
|
"received input, and dispatch to action methods, passing them the remainder "
|
|
"of the line as argument."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:53
|
|
msgid ""
|
|
"The optional argument is a banner or intro string to be issued before the "
|
|
"first prompt (this overrides the :attr:`intro` class attribute)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:56
|
|
msgid ""
|
|
"If the :mod:`readline` module is loaded, input will automatically inherit :"
|
|
"program:`bash`\\ -like history-list editing (e.g. :kbd:`Control-P` scrolls "
|
|
"back to the last command, :kbd:`Control-N` forward to the next one, :kbd:"
|
|
"`Control-F` moves the cursor to the right non-destructively, :kbd:`Control-"
|
|
"B` moves the cursor to the left non-destructively, etc.)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:62
|
|
msgid "An end-of-file on input is passed back as the string ``'EOF'``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:64
|
|
msgid ""
|
|
"An interpreter instance will recognize a command name ``foo`` if and only if "
|
|
"it has a method :meth:`do_foo`. As a special case, a line beginning with "
|
|
"the character ``'?'`` is dispatched to the method :meth:`do_help`. As "
|
|
"another special case, a line beginning with the character ``'!'`` is "
|
|
"dispatched to the method :meth:`do_shell` (if such a method is defined)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:70
|
|
msgid ""
|
|
"This method will return when the :meth:`postcmd` method returns a true "
|
|
"value. The *stop* argument to :meth:`postcmd` is the return value from the "
|
|
"command's corresponding :meth:`do_\\*` method."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:74
|
|
msgid ""
|
|
"If completion is enabled, completing commands will be done automatically, "
|
|
"and completing of commands args is done by calling :meth:`complete_foo` with "
|
|
"arguments *text*, *line*, *begidx*, and *endidx*. *text* is the string "
|
|
"prefix we are attempting to match: all returned matches must begin with it. "
|
|
"*line* is the current input line with leading whitespace removed, *begidx* "
|
|
"and *endidx* are the beginning and ending indexes of the prefix text, which "
|
|
"could be used to provide different completion depending upon which position "
|
|
"the argument is in."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:82
|
|
msgid ""
|
|
"All subclasses of :class:`Cmd` inherit a predefined :meth:`do_help`. This "
|
|
"method, called with an argument ``'bar'``, invokes the corresponding method :"
|
|
"meth:`help_bar`, and if that is not present, prints the docstring of :meth:"
|
|
"`do_bar`, if available. With no argument, :meth:`do_help` lists all "
|
|
"available help topics (that is, all commands with corresponding :meth:`help_"
|
|
"\\*` methods or commands that have docstrings), and also lists any "
|
|
"undocumented commands."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:93
|
|
msgid ""
|
|
"Interpret the argument as though it had been typed in response to the "
|
|
"prompt. This may be overridden, but should not normally need to be; see the :"
|
|
"meth:`precmd` and :meth:`postcmd` methods for useful execution hooks. The "
|
|
"return value is a flag indicating whether interpretation of commands by the "
|
|
"interpreter should stop. If there is a :meth:`do_\\*` method for the "
|
|
"command *str*, the return value of that method is returned, otherwise the "
|
|
"return value from the :meth:`default` method is returned."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:104
|
|
msgid ""
|
|
"Method called when an empty line is entered in response to the prompt. If "
|
|
"this method is not overridden, it repeats the last nonempty command entered."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:110
|
|
msgid ""
|
|
"Method called on an input line when the command prefix is not recognized. If "
|
|
"this method is not overridden, it prints an error message and returns."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:116
|
|
msgid ""
|
|
"Method called to complete an input line when no command-specific :meth:"
|
|
"`complete_\\*` method is available. By default, it returns an empty list."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:122
|
|
msgid ""
|
|
"Hook method executed just before the command line *line* is interpreted, but "
|
|
"after the input prompt is generated and issued. This method is a stub in :"
|
|
"class:`Cmd`; it exists to be overridden by subclasses. The return value is "
|
|
"used as the command which will be executed by the :meth:`onecmd` method; "
|
|
"the :meth:`precmd` implementation may re-write the command or simply return "
|
|
"*line* unchanged."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:132
|
|
msgid ""
|
|
"Hook method executed just after a command dispatch is finished. This method "
|
|
"is a stub in :class:`Cmd`; it exists to be overridden by subclasses. *line* "
|
|
"is the command line which was executed, and *stop* is a flag which indicates "
|
|
"whether execution will be terminated after the call to :meth:`postcmd`; this "
|
|
"will be the return value of the :meth:`onecmd` method. The return value of "
|
|
"this method will be used as the new value for the internal flag which "
|
|
"corresponds to *stop*; returning false will cause interpretation to continue."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:143
|
|
msgid ""
|
|
"Hook method executed once when :meth:`cmdloop` is called. This method is a "
|
|
"stub in :class:`Cmd`; it exists to be overridden by subclasses."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:149
|
|
msgid ""
|
|
"Hook method executed once when :meth:`cmdloop` is about to return. This "
|
|
"method is a stub in :class:`Cmd`; it exists to be overridden by subclasses."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:153
|
|
msgid ""
|
|
"Instances of :class:`Cmd` subclasses have some public instance variables:"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:157
|
|
msgid "The prompt issued to solicit input."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:162
|
|
msgid "The string of characters accepted for the command prefix."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:167
|
|
msgid "The last nonempty command prefix seen."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:172
|
|
msgid ""
|
|
"A list of queued input lines. The cmdqueue list is checked in :meth:"
|
|
"`cmdloop` when new input is needed; if it is nonempty, its elements will be "
|
|
"processed in order, as if entered at the prompt."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:179
|
|
msgid ""
|
|
"A string to issue as an intro or banner. May be overridden by giving the :"
|
|
"meth:`cmdloop` method an argument."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:185
|
|
msgid ""
|
|
"The header to issue if the help output has a section for documented commands."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:190
|
|
msgid ""
|
|
"The header to issue if the help output has a section for miscellaneous help "
|
|
"topics (that is, there are :meth:`help_\\*` methods without corresponding :"
|
|
"meth:`do_\\*` methods)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:197
|
|
msgid ""
|
|
"The header to issue if the help output has a section for undocumented "
|
|
"commands (that is, there are :meth:`do_\\*` methods without corresponding :"
|
|
"meth:`help_\\*` methods)."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:204
|
|
msgid ""
|
|
"The character used to draw separator lines under the help-message headers. "
|
|
"If empty, no ruler line is drawn. It defaults to ``'='``."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:210
|
|
msgid ""
|
|
"A flag, defaulting to true. If true, :meth:`cmdloop` uses :func:`input` to "
|
|
"display a prompt and read the next command; if false, :meth:`sys.stdout."
|
|
"write` and :meth:`sys.stdin.readline` are used. (This means that by "
|
|
"importing :mod:`readline`, on systems that support it, the interpreter will "
|
|
"automatically support :program:`Emacs`\\ -like line editing and command-"
|
|
"history keystrokes.)"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:220
|
|
msgid "Cmd Example"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:224
|
|
msgid ""
|
|
"The :mod:`cmd` module is mainly useful for building custom shells that let a "
|
|
"user work with a program interactively."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:227
|
|
msgid ""
|
|
"This section presents a simple example of how to build a shell around a few "
|
|
"of the commands in the :mod:`turtle` module."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:230
|
|
msgid ""
|
|
"Basic turtle commands such as :meth:`~turtle.forward` are added to a :class:"
|
|
"`Cmd` subclass with method named :meth:`do_forward`. The argument is "
|
|
"converted to a number and dispatched to the turtle module. The docstring is "
|
|
"used in the help utility provided by the shell."
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:235
|
|
msgid ""
|
|
"The example also includes a basic record and playback facility implemented "
|
|
"with the :meth:`~Cmd.precmd` method which is responsible for converting the "
|
|
"input to lowercase and writing the commands to a file. The :meth:"
|
|
"`do_playback` method reads the file and adds the recorded commands to the :"
|
|
"attr:`cmdqueue` for immediate playback::"
|
|
msgstr ""
|
|
|
|
#: ../Doc/library/cmd.rst:316
|
|
msgid ""
|
|
"Here is a sample session with the turtle shell showing the help functions, "
|
|
"using blank lines to repeat commands, and the simple record and playback "
|
|
"facility:"
|
|
msgstr ""
|