# 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/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 ""