forked from AFPy/python-docs-fr
170 lines
6.5 KiB
Plaintext
170 lines
6.5 KiB
Plaintext
# Copyright (C) 2001-2018, Python Software Foundation
|
|
# For licence information, see README file.
|
|
#
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: Python 3\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2020-08-24 09:01+0200\n"
|
|
"PO-Revision-Date: 2020-02-04 21:19+0100\n"
|
|
"Last-Translator: ZepmanBC <zepman@gmail.com>\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"
|
|
"X-Generator: Poedit 2.2.4\n"
|
|
|
|
#: distutils/configfile.rst:5
|
|
msgid "Writing the Setup Configuration File"
|
|
msgstr ""
|
|
|
|
#: distutils/_setuptools_disclaimer.rst:3
|
|
msgid ""
|
|
"This document is being retained solely until the ``setuptools`` "
|
|
"documentation at https://setuptools.readthedocs.io/en/latest/setuptools.html "
|
|
"independently covers all of the relevant information currently included here."
|
|
msgstr ""
|
|
"Cette page est conservée uniquement jusqu'à ce que la documentation "
|
|
"``setuptool`` sur https://setuptools.readthedocs.io/en/latest/setuptools."
|
|
"html couvre de manière indépendante toutes les informations pertinentes "
|
|
"actuellement incluses ici."
|
|
|
|
#: distutils/configfile.rst:9
|
|
msgid ""
|
|
"Often, it's not possible to write down everything needed to build a "
|
|
"distribution *a priori*: you may need to get some information from the user, "
|
|
"or from the user's system, in order to proceed. As long as that information "
|
|
"is fairly simple---a list of directories to search for C header files or "
|
|
"libraries, for example---then providing a configuration file, :file:`setup."
|
|
"cfg`, for users to edit is a cheap and easy way to solicit it. "
|
|
"Configuration files also let you provide default values for any command "
|
|
"option, which the installer can then override either on the command-line or "
|
|
"by editing the config file."
|
|
msgstr ""
|
|
|
|
#: distutils/configfile.rst:18
|
|
msgid ""
|
|
"The setup configuration file is a useful middle-ground between the setup "
|
|
"script---which, ideally, would be opaque to installers [#]_---and the "
|
|
"command-line to the setup script, which is outside of your control and "
|
|
"entirely up to the installer. In fact, :file:`setup.cfg` (and any other "
|
|
"Distutils configuration files present on the target system) are processed "
|
|
"after the contents of the setup script, but before the command-line. This "
|
|
"has several useful consequences:"
|
|
msgstr ""
|
|
|
|
#: distutils/configfile.rst:32
|
|
msgid ""
|
|
"installers can override some of what you put in :file:`setup.py` by editing :"
|
|
"file:`setup.cfg`"
|
|
msgstr ""
|
|
|
|
#: distutils/configfile.rst:35
|
|
msgid ""
|
|
"you can provide non-standard defaults for options that are not easily set "
|
|
"in :file:`setup.py`"
|
|
msgstr ""
|
|
|
|
#: distutils/configfile.rst:38
|
|
msgid ""
|
|
"installers can override anything in :file:`setup.cfg` using the command-line "
|
|
"options to :file:`setup.py`"
|
|
msgstr ""
|
|
|
|
#: distutils/configfile.rst:41
|
|
msgid "The basic syntax of the configuration file is simple:"
|
|
msgstr ""
|
|
|
|
#: distutils/configfile.rst:49
|
|
msgid ""
|
|
"where *command* is one of the Distutils commands (e.g. :command:`build_py`, :"
|
|
"command:`install`), and *option* is one of the options that command "
|
|
"supports. Any number of options can be supplied for each command, and any "
|
|
"number of command sections can be included in the file. Blank lines are "
|
|
"ignored, as are comments, which run from a ``'#'`` character until the end "
|
|
"of the line. Long option values can be split across multiple lines simply "
|
|
"by indenting the continuation lines."
|
|
msgstr ""
|
|
|
|
#: distutils/configfile.rst:57
|
|
msgid ""
|
|
"You can find out the list of options supported by a particular command with "
|
|
"the universal :option:`!--help` option, e.g."
|
|
msgstr ""
|
|
|
|
#: distutils/configfile.rst:75
|
|
msgid ""
|
|
"Note that an option spelled :option:`!--foo-bar` on the command-line is "
|
|
"spelled ``foo_bar`` in configuration files."
|
|
msgstr ""
|
|
|
|
#: distutils/configfile.rst:80
|
|
msgid ""
|
|
"For example, say you want your extensions to be built \"in-place\"---that "
|
|
"is, you have an extension :mod:`pkg.ext`, and you want the compiled "
|
|
"extension file (:file:`ext.so` on Unix, say) to be put in the same source "
|
|
"directory as your pure Python modules :mod:`pkg.mod1` and :mod:`pkg.mod2`. "
|
|
"You can always use the :option:`!--inplace` option on the command-line to "
|
|
"ensure this:"
|
|
msgstr ""
|
|
|
|
#: distutils/configfile.rst:90
|
|
msgid ""
|
|
"But this requires that you always specify the :command:`build_ext` command "
|
|
"explicitly, and remember to provide :option:`!--inplace`. An easier way is "
|
|
"to \"set and forget\" this option, by encoding it in :file:`setup.cfg`, the "
|
|
"configuration file for this distribution:"
|
|
msgstr ""
|
|
|
|
#: distutils/configfile.rst:100
|
|
msgid ""
|
|
"This will affect all builds of this module distribution, whether or not you "
|
|
"explicitly specify :command:`build_ext`. If you include :file:`setup.cfg` "
|
|
"in your source distribution, it will also affect end-user builds---which is "
|
|
"probably a bad idea for this option, since always building extensions in-"
|
|
"place would break installation of the module distribution. In certain "
|
|
"peculiar cases, though, modules are built right in their installation "
|
|
"directory, so this is conceivably a useful ability. (Distributing "
|
|
"extensions that expect to be built in their installation directory is almost "
|
|
"always a bad idea, though.)"
|
|
msgstr ""
|
|
|
|
#: distutils/configfile.rst:109
|
|
msgid ""
|
|
"Another example: certain commands take a lot of options that don't change "
|
|
"from run to run; for example, :command:`bdist_rpm` needs to know everything "
|
|
"required to generate a \"spec\" file for creating an RPM distribution. Some "
|
|
"of this information comes from the setup script, and some is automatically "
|
|
"generated by the Distutils (such as the list of files installed). But some "
|
|
"of it has to be supplied as options to :command:`bdist_rpm`, which would be "
|
|
"very tedious to do on the command-line for every run. Hence, here is a "
|
|
"snippet from the Distutils' own :file:`setup.cfg`:"
|
|
msgstr ""
|
|
|
|
#: distutils/configfile.rst:129
|
|
msgid ""
|
|
"Note that the ``doc_files`` option is simply a whitespace-separated string "
|
|
"split across multiple lines for readability."
|
|
msgstr ""
|
|
|
|
#: distutils/configfile.rst:136
|
|
msgid ":ref:`inst-config-syntax` in \"Installing Python Modules\""
|
|
msgstr ""
|
|
|
|
#: distutils/configfile.rst:136
|
|
msgid ""
|
|
"More information on the configuration files is available in the manual for "
|
|
"system administrators."
|
|
msgstr ""
|
|
|
|
#: distutils/configfile.rst:141
|
|
msgid "Footnotes"
|
|
msgstr "Notes"
|
|
|
|
#: distutils/configfile.rst:142
|
|
msgid ""
|
|
"This ideal probably won't be achieved until auto-configuration is fully "
|
|
"supported by the Distutils."
|
|
msgstr ""
|