forked from AFPy/python-docs-fr
485 lines
14 KiB
Plaintext
485 lines
14 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: 2016-10-30 10:40+0100\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"
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:3
|
||
|
msgid "Argparse Tutorial"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:5
|
||
|
msgid "Tshepang Lekhonkhobe"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:9
|
||
|
msgid ""
|
||
|
"This tutorial is intended to be a gentle introduction to :mod:`argparse`, "
|
||
|
"the recommended command-line parsing module in the Python standard library."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:14
|
||
|
msgid ""
|
||
|
"There are two other modules that fulfill the same task, namely :mod:`getopt` "
|
||
|
"(an equivalent for :c:func:`getopt` from the C language) and the deprecated :"
|
||
|
"mod:`optparse`. Note also that :mod:`argparse` is based on :mod:`optparse`, "
|
||
|
"and therefore very similar in terms of usage."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:22
|
||
|
msgid "Concepts"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:24
|
||
|
msgid ""
|
||
|
"Let's show the sort of functionality that we are going to explore in this "
|
||
|
"introductory tutorial by making use of the :command:`ls` command:"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:46
|
||
|
msgid "A few concepts we can learn from the four commands:"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:48
|
||
|
msgid ""
|
||
|
"The :command:`ls` command is useful when run without any options at all. It "
|
||
|
"defaults to displaying the contents of the current directory."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:51
|
||
|
msgid ""
|
||
|
"If we want beyond what it provides by default, we tell it a bit more. In "
|
||
|
"this case, we want it to display a different directory, ``pypy``. What we "
|
||
|
"did is specify what is known as a positional argument. It's named so because "
|
||
|
"the program should know what to do with the value, solely based on where it "
|
||
|
"appears on the command line. This concept is more relevant to a command "
|
||
|
"like :command:`cp`, whose most basic usage is ``cp SRC DEST``. The first "
|
||
|
"position is *what you want copied,* and the second position is *where you "
|
||
|
"want it copied to*."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:60
|
||
|
msgid ""
|
||
|
"Now, say we want to change behaviour of the program. In our example, we "
|
||
|
"display more info for each file instead of just showing the file names. The "
|
||
|
"``-l`` in that case is known as an optional argument."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:64
|
||
|
msgid ""
|
||
|
"That's a snippet of the help text. It's very useful in that you can come "
|
||
|
"across a program you have never used before, and can figure out how it works "
|
||
|
"simply by reading its help text."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:70
|
||
|
msgid "The basics"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:72
|
||
|
msgid "Let us start with a very simple example which does (almost) nothing::"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:78 ../Doc/howto/argparse.rst:186
|
||
|
#: ../Doc/howto/argparse.rst:207
|
||
|
msgid "Following is a result of running the code:"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:95 ../Doc/howto/argparse.rst:252
|
||
|
#: ../Doc/howto/argparse.rst:296
|
||
|
msgid "Here is what is happening:"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:97
|
||
|
msgid ""
|
||
|
"Running the script without any options results in nothing displayed to "
|
||
|
"stdout. Not so useful."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:100
|
||
|
msgid ""
|
||
|
"The second one starts to display the usefulness of the :mod:`argparse` "
|
||
|
"module. We have done almost nothing, but already we get a nice help message."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:103
|
||
|
msgid ""
|
||
|
"The ``--help`` option, which can also be shortened to ``-h``, is the only "
|
||
|
"option we get for free (i.e. no need to specify it). Specifying anything "
|
||
|
"else results in an error. But even then, we do get a useful usage message, "
|
||
|
"also for free."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:110
|
||
|
msgid "Introducing Positional arguments"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:112
|
||
|
msgid "An example::"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:120
|
||
|
msgid "And running the code:"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:138
|
||
|
msgid "Here is what's happening:"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:140
|
||
|
msgid ""
|
||
|
"We've added the :meth:`add_argument` method, which is what we use to specify "
|
||
|
"which command-line options the program is willing to accept. In this case, "
|
||
|
"I've named it ``echo`` so that it's in line with its function."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:144
|
||
|
msgid "Calling our program now requires us to specify an option."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:146
|
||
|
msgid ""
|
||
|
"The :meth:`parse_args` method actually returns some data from the options "
|
||
|
"specified, in this case, ``echo``."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:149
|
||
|
msgid ""
|
||
|
"The variable is some form of 'magic' that :mod:`argparse` performs for free "
|
||
|
"(i.e. no need to specify which variable that value is stored in). You will "
|
||
|
"also notice that its name matches the string argument given to the method, "
|
||
|
"``echo``."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:154
|
||
|
msgid ""
|
||
|
"Note however that, although the help display looks nice and all, it "
|
||
|
"currently is not as helpful as it can be. For example we see that we got "
|
||
|
"``echo`` as a positional argument, but we don't know what it does, other "
|
||
|
"than by guessing or by reading the source code. So, let's make it a bit more "
|
||
|
"useful::"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:165
|
||
|
msgid "And we get:"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:178
|
||
|
msgid "Now, how about doing something even more useful::"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:196
|
||
|
msgid ""
|
||
|
"That didn't go so well. That's because :mod:`argparse` treats the options we "
|
||
|
"give it as strings, unless we tell it otherwise. So, let's tell :mod:"
|
||
|
"`argparse` to treat that input as an integer::"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:217
|
||
|
msgid ""
|
||
|
"That went well. The program now even helpfully quits on bad illegal input "
|
||
|
"before proceeding."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:222
|
||
|
msgid "Introducing Optional arguments"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:224
|
||
|
msgid ""
|
||
|
"So far we, have been playing with positional arguments. Let us have a look "
|
||
|
"on how to add optional ones::"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:234 ../Doc/howto/argparse.rst:280
|
||
|
#: ../Doc/howto/argparse.rst:396 ../Doc/howto/argparse.rst:430
|
||
|
msgid "And the output:"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:254
|
||
|
msgid ""
|
||
|
"The program is written so as to display something when ``--verbosity`` is "
|
||
|
"specified and display nothing when not."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:257
|
||
|
msgid ""
|
||
|
"To show that the option is actually optional, there is no error when running "
|
||
|
"the program without it. Note that by default, if an optional argument isn't "
|
||
|
"used, the relevant variable, in this case :attr:`args.verbosity`, is given "
|
||
|
"``None`` as a value, which is the reason it fails the truth test of the :"
|
||
|
"keyword:`if` statement."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:263
|
||
|
msgid "The help message is a bit different."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:265
|
||
|
msgid ""
|
||
|
"When using the ``--verbosity`` option, one must also specify some value, any "
|
||
|
"value."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:268
|
||
|
msgid ""
|
||
|
"The above example accepts arbitrary integer values for ``--verbosity``, but "
|
||
|
"for our simple program, only two values are actually useful, ``True`` or "
|
||
|
"``False``. Let's modify the code accordingly::"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:298
|
||
|
msgid ""
|
||
|
"The option is now more of a flag than something that requires a value. We "
|
||
|
"even changed the name of the option to match that idea. Note that we now "
|
||
|
"specify a new keyword, ``action``, and give it the value ``\"store_true\"``. "
|
||
|
"This means that, if the option is specified, assign the value ``True`` to :"
|
||
|
"data:`args.verbose`. Not specifying it implies ``False``."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:305
|
||
|
msgid ""
|
||
|
"It complains when you specify a value, in true spirit of what flags actually "
|
||
|
"are."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:308
|
||
|
msgid "Notice the different help text."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:312
|
||
|
msgid "Short options"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:314
|
||
|
msgid ""
|
||
|
"If you are familiar with command line usage, you will notice that I haven't "
|
||
|
"yet touched on the topic of short versions of the options. It's quite "
|
||
|
"simple::"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:326
|
||
|
msgid "And here goes:"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:339
|
||
|
msgid "Note that the new ability is also reflected in the help text."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:343
|
||
|
msgid "Combining Positional and Optional arguments"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:345
|
||
|
msgid "Our program keeps growing in complexity::"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:360
|
||
|
msgid "And now the output:"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:374
|
||
|
msgid "We've brought back a positional argument, hence the complaint."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:376
|
||
|
msgid "Note that the order does not matter."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:378
|
||
|
msgid ""
|
||
|
"How about we give this program of ours back the ability to have multiple "
|
||
|
"verbosity values, and actually get to use them::"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:412
|
||
|
msgid ""
|
||
|
"These all look good except the last one, which exposes a bug in our program. "
|
||
|
"Let's fix it by restricting the values the ``--verbosity`` option can "
|
||
|
"accept::"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:448
|
||
|
msgid ""
|
||
|
"Note that the change also reflects both in the error message as well as the "
|
||
|
"help string."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:451
|
||
|
msgid ""
|
||
|
"Now, let's use a different approach of playing with verbosity, which is "
|
||
|
"pretty common. It also matches the way the CPython executable handles its "
|
||
|
"own verbosity argument (check the output of ``python --help``)::"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:470
|
||
|
msgid ""
|
||
|
"We have introduced another action, \"count\", to count the number of "
|
||
|
"occurrences of a specific optional arguments:"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:498
|
||
|
msgid ""
|
||
|
"Yes, it's now more of a flag (similar to ``action=\"store_true\"``) in the "
|
||
|
"previous version of our script. That should explain the complaint."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:501
|
||
|
msgid "It also behaves similar to \"store_true\" action."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:503
|
||
|
msgid ""
|
||
|
"Now here's a demonstration of what the \"count\" action gives. You've "
|
||
|
"probably seen this sort of usage before."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:506
|
||
|
msgid ""
|
||
|
"And if you don't specify the ``-v`` flag, that flag is considered to have "
|
||
|
"``None`` value."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:509
|
||
|
msgid ""
|
||
|
"As should be expected, specifying the long form of the flag, we should get "
|
||
|
"the same output."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:512
|
||
|
msgid ""
|
||
|
"Sadly, our help output isn't very informative on the new ability our script "
|
||
|
"has acquired, but that can always be fixed by improving the documentation "
|
||
|
"for our script (e.g. via the ``help`` keyword argument)."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:516
|
||
|
msgid "That last output exposes a bug in our program."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:519
|
||
|
msgid "Let's fix::"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:538
|
||
|
msgid "And this is what it gives:"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:553
|
||
|
msgid ""
|
||
|
"First output went well, and fixes the bug we had before. That is, we want "
|
||
|
"any value >= 2 to be as verbose as possible."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:556
|
||
|
msgid "Third output not so good."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:558
|
||
|
msgid "Let's fix that bug::"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:575
|
||
|
msgid ""
|
||
|
"We've just introduced yet another keyword, ``default``. We've set it to "
|
||
|
"``0`` in order to make it comparable to the other int values. Remember that "
|
||
|
"by default, if an optional argument isn't specified, it gets the ``None`` "
|
||
|
"value, and that cannot be compared to an int value (hence the :exc:"
|
||
|
"`TypeError` exception)."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:582
|
||
|
msgid "And:"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:589
|
||
|
msgid ""
|
||
|
"You can go quite far just with what we've learned so far, and we have only "
|
||
|
"scratched the surface. The :mod:`argparse` module is very powerful, and "
|
||
|
"we'll explore a bit more of it before we end this tutorial."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:596
|
||
|
msgid "Getting a little more advanced"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:598
|
||
|
msgid ""
|
||
|
"What if we wanted to expand our tiny program to perform other powers, not "
|
||
|
"just squares::"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:615 ../Doc/howto/argparse.rst:653
|
||
|
msgid "Output:"
|
||
|
msgstr "Sortie :"
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:636
|
||
|
msgid ""
|
||
|
"Notice that so far we've been using verbosity level to *change* the text "
|
||
|
"that gets displayed. The following example instead uses verbosity level to "
|
||
|
"display *more* text instead::"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:667
|
||
|
msgid "Conflicting options"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:669
|
||
|
msgid ""
|
||
|
"So far, we have been working with two methods of an :class:`argparse."
|
||
|
"ArgumentParser` instance. Let's introduce a third one, :meth:"
|
||
|
"`add_mutually_exclusive_group`. It allows for us to specify options that "
|
||
|
"conflict with each other. Let's also change the rest of the program so that "
|
||
|
"the new functionality makes more sense: we'll introduce the ``--quiet`` "
|
||
|
"option, which will be the opposite of the ``--verbose`` one::"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:695
|
||
|
msgid ""
|
||
|
"Our program is now simpler, and we've lost some functionality for the sake "
|
||
|
"of demonstration. Anyways, here's the output:"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:713
|
||
|
msgid ""
|
||
|
"That should be easy to follow. I've added that last output so you can see "
|
||
|
"the sort of flexibility you get, i.e. mixing long form options with short "
|
||
|
"form ones."
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:717
|
||
|
msgid ""
|
||
|
"Before we conclude, you probably want to tell your users the main purpose of "
|
||
|
"your program, just in case they don't know::"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:738
|
||
|
msgid ""
|
||
|
"Note that slight difference in the usage text. Note the ``[-v | -q]``, which "
|
||
|
"tells us that we can either use ``-v`` or ``-q``, but not both at the same "
|
||
|
"time:"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:760
|
||
|
msgid "Conclusion"
|
||
|
msgstr ""
|
||
|
|
||
|
#: ../Doc/howto/argparse.rst:762
|
||
|
msgid ""
|
||
|
"The :mod:`argparse` module offers a lot more than shown here. Its docs are "
|
||
|
"quite detailed and thorough, and full of examples. Having gone through this "
|
||
|
"tutorial, you should easily digest them without feeling overwhelmed."
|
||
|
msgstr ""
|