# SOME DESCRIPTIVE TITLE.

# Copyright (C) 2001-2017, Python Software Foundation

# This file is distributed under the same license as the Python package.

# FIRST AUTHOR <EMAIL@ADDRESS>, 2017.

#

#, fuzzy

msgid ""

msgstr ""

"Project-Id-Version: Python 3.6\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2017-11-26 18:49+0900\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"

"MIME-Version: 1.0\n"

"Content-Type: text/plain; charset=utf-8\n"

"Content-Transfer-Encoding: 8bit\n"

"Generated-By: Babel 2.5.1\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 ""

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