# SOME DESCRIPTIVE TITLE. # Copyright (C) 2001-2023, 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.11\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2023-07-23 14:38+0200\n" "PO-Revision-Date: 2022-12-04 22:18+0100\n" "Last-Translator: Jules Lasne \n" "Language-Team: FRENCH \n" "Language: fr\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #: ../Doc/distutils/apiref.rst:5 msgid "API Reference" msgstr "" #: ../Doc/distutils/apiref.rst:11 msgid "`New and changed setup.py arguments in setuptools`_" msgstr "" #: ../Doc/distutils/apiref.rst:10 msgid "" "The ``setuptools`` project adds new capabilities to the ``setup`` function " "and other APIs, makes the API consistent across different Python versions, " "and is hence recommended over using ``distutils`` directly." msgstr "" #: ../Doc/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 "" #: ../Doc/distutils/apiref.rst:19 msgid ":mod:`distutils.core` --- Core Distutils functionality" msgstr "" #: ../Doc/distutils/apiref.rst:25 msgid "" "The :mod:`distutils.core` module is the only module that needs to be " "installed to use the Distutils. It provides the :func:`setup` (which is " "called from the setup script). Indirectly provides the :class:`distutils." "dist.Distribution` and :class:`distutils.cmd.Command` class." msgstr "" #: ../Doc/distutils/apiref.rst:33 msgid "" "The basic do-everything function that does most everything you could ever " "ask for from a Distutils method." msgstr "" #: ../Doc/distutils/apiref.rst:36 msgid "" "The setup function takes a large number of arguments. These are laid out in " "the following table." msgstr "" #: ../Doc/distutils/apiref.rst:42 ../Doc/distutils/apiref.rst:185 msgid "argument name" msgstr "" #: ../Doc/distutils/apiref.rst:42 ../Doc/distutils/apiref.rst:143 #: ../Doc/distutils/apiref.rst:185 msgid "value" msgstr "" #: ../Doc/distutils/apiref.rst:42 ../Doc/distutils/apiref.rst:185 msgid "type" msgstr "" #: ../Doc/distutils/apiref.rst:44 ../Doc/distutils/apiref.rst:187 msgid "*name*" msgstr "" #: ../Doc/distutils/apiref.rst:44 msgid "The name of the package" msgstr "" #: ../Doc/distutils/apiref.rst:44 ../Doc/distutils/apiref.rst:46 #: ../Doc/distutils/apiref.rst:50 ../Doc/distutils/apiref.rst:53 #: ../Doc/distutils/apiref.rst:56 ../Doc/distutils/apiref.rst:58 #: ../Doc/distutils/apiref.rst:61 ../Doc/distutils/apiref.rst:68 #: ../Doc/distutils/apiref.rst:72 ../Doc/distutils/apiref.rst:75 #: ../Doc/distutils/apiref.rst:96 ../Doc/distutils/apiref.rst:106 #: ../Doc/distutils/apiref.rst:187 ../Doc/distutils/apiref.rst:278 msgid "a string" msgstr "" #: ../Doc/distutils/apiref.rst:46 msgid "*version*" msgstr "" #: ../Doc/distutils/apiref.rst:46 msgid "The version number of the package; see :mod:`distutils.version`" msgstr "" #: ../Doc/distutils/apiref.rst:50 msgid "*description*" msgstr "" #: ../Doc/distutils/apiref.rst:50 msgid "A single line describing the package" msgstr "" #: ../Doc/distutils/apiref.rst:53 msgid "*long_description*" msgstr "" #: ../Doc/distutils/apiref.rst:53 msgid "Longer description of the package" msgstr "" #: ../Doc/distutils/apiref.rst:56 msgid "*author*" msgstr "" #: ../Doc/distutils/apiref.rst:56 msgid "The name of the package author" msgstr "" #: ../Doc/distutils/apiref.rst:58 msgid "*author_email*" msgstr "" #: ../Doc/distutils/apiref.rst:58 msgid "The email address of the package author" msgstr "" #: ../Doc/distutils/apiref.rst:61 msgid "*maintainer*" msgstr "" #: ../Doc/distutils/apiref.rst:61 msgid "" "The name of the current maintainer, if different from the author. Note that " "if the maintainer is provided, distutils will use it as the author in :file:" "`PKG-INFO`" msgstr "" #: ../Doc/distutils/apiref.rst:68 msgid "*maintainer_email*" msgstr "" #: ../Doc/distutils/apiref.rst:68 msgid "" "The email address of the current maintainer, if different from the author" msgstr "" #: ../Doc/distutils/apiref.rst:72 msgid "*url*" msgstr "" #: ../Doc/distutils/apiref.rst:72 msgid "A URL for the package (homepage)" msgstr "" #: ../Doc/distutils/apiref.rst:75 msgid "*download_url*" msgstr "" #: ../Doc/distutils/apiref.rst:75 msgid "A URL to download the package" msgstr "" #: ../Doc/distutils/apiref.rst:77 msgid "*packages*" msgstr "" #: ../Doc/distutils/apiref.rst:77 msgid "A list of Python packages that distutils will manipulate" msgstr "" #: ../Doc/distutils/apiref.rst:77 ../Doc/distutils/apiref.rst:80 #: ../Doc/distutils/apiref.rst:83 ../Doc/distutils/apiref.rst:100 #: ../Doc/distutils/apiref.rst:193 ../Doc/distutils/apiref.rst:207 #: ../Doc/distutils/apiref.rst:223 ../Doc/distutils/apiref.rst:226 #: ../Doc/distutils/apiref.rst:230 ../Doc/distutils/apiref.rst:234 #: ../Doc/distutils/apiref.rst:240 ../Doc/distutils/apiref.rst:247 #: ../Doc/distutils/apiref.rst:258 ../Doc/distutils/apiref.rst:267 #: ../Doc/distutils/apiref.rst:275 msgid "a list of strings" msgstr "" #: ../Doc/distutils/apiref.rst:80 msgid "*py_modules*" msgstr "" #: ../Doc/distutils/apiref.rst:80 msgid "A list of Python modules that distutils will manipulate" msgstr "" #: ../Doc/distutils/apiref.rst:83 msgid "*scripts*" msgstr "" #: ../Doc/distutils/apiref.rst:83 msgid "A list of standalone script files to be built and installed" msgstr "" #: ../Doc/distutils/apiref.rst:87 msgid "*ext_modules*" msgstr "" #: ../Doc/distutils/apiref.rst:87 msgid "A list of Python extensions to be built" msgstr "" #: ../Doc/distutils/apiref.rst:87 msgid "a list of instances of :class:`distutils.core.Extension`" msgstr "" #: ../Doc/distutils/apiref.rst:90 msgid "*classifiers*" msgstr "" #: ../Doc/distutils/apiref.rst:90 msgid "A list of categories for the package" msgstr "" #: ../Doc/distutils/apiref.rst:90 msgid "" "a list of strings; valid classifiers are listed on `PyPI `_." msgstr "" #: ../Doc/distutils/apiref.rst:93 msgid "*distclass*" msgstr "" #: ../Doc/distutils/apiref.rst:93 msgid "the :class:`Distribution` class to use" msgstr "" #: ../Doc/distutils/apiref.rst:93 msgid "a subclass of :class:`distutils.core.Distribution`" msgstr "" #: ../Doc/distutils/apiref.rst:96 msgid "*script_name*" msgstr "" #: ../Doc/distutils/apiref.rst:96 msgid "The name of the setup.py script - defaults to ``sys.argv[0]``" msgstr "" #: ../Doc/distutils/apiref.rst:100 msgid "*script_args*" msgstr "" #: ../Doc/distutils/apiref.rst:100 msgid "Arguments to supply to the setup script" msgstr "" #: ../Doc/distutils/apiref.rst:103 msgid "*options*" msgstr "" #: ../Doc/distutils/apiref.rst:103 msgid "default options for the setup script" msgstr "" #: ../Doc/distutils/apiref.rst:103 ../Doc/distutils/apiref.rst:113 #: ../Doc/distutils/apiref.rst:119 msgid "a dictionary" msgstr "" #: ../Doc/distutils/apiref.rst:106 msgid "*license*" msgstr "" #: ../Doc/distutils/apiref.rst:106 msgid "The license for the package" msgstr "" #: ../Doc/distutils/apiref.rst:108 msgid "*keywords*" msgstr "" #: ../Doc/distutils/apiref.rst:108 msgid "Descriptive meta-data, see :pep:`314`" msgstr "" #: ../Doc/distutils/apiref.rst:108 ../Doc/distutils/apiref.rst:111 msgid "a list of strings or a comma-separated string" msgstr "" #: ../Doc/distutils/apiref.rst:111 msgid "*platforms*" msgstr "" #: ../Doc/distutils/apiref.rst:113 msgid "*cmdclass*" msgstr "" #: ../Doc/distutils/apiref.rst:113 msgid "A mapping of command names to :class:`Command` subclasses" msgstr "" #: ../Doc/distutils/apiref.rst:116 msgid "*data_files*" msgstr "" #: ../Doc/distutils/apiref.rst:116 msgid "A list of data files to install" msgstr "" #: ../Doc/distutils/apiref.rst:116 msgid "a list" msgstr "" #: ../Doc/distutils/apiref.rst:119 msgid "*package_dir*" msgstr "" #: ../Doc/distutils/apiref.rst:119 msgid "A mapping of package to directory names" msgstr "" #: ../Doc/distutils/apiref.rst:127 msgid "" "Run a setup script in a somewhat controlled environment, and return the :" "class:`distutils.dist.Distribution` instance that drives things. This is " "useful if you need to find out the distribution meta-data (passed as " "keyword args from *script* to :func:`setup`), or the contents of the config " "files or command-line." msgstr "" #: ../Doc/distutils/apiref.rst:133 msgid "" "*script_name* is a file that will be read and run with :func:`exec`. ``sys." "argv[0]`` will be replaced with *script* for the duration of the call. " "*script_args* is a list of strings; if supplied, ``sys.argv[1:]`` will be " "replaced by *script_args* for the duration of the call." msgstr "" #: ../Doc/distutils/apiref.rst:138 msgid "" "*stop_after* tells :func:`setup` when to stop processing; possible values:" msgstr "" #: ../Doc/distutils/apiref.rst:143 ../Doc/distutils/apiref.rst:562 #: ../Doc/distutils/apiref.rst:1606 msgid "description" msgstr "" #: ../Doc/distutils/apiref.rst:145 msgid "*init*" msgstr "" #: ../Doc/distutils/apiref.rst:145 msgid "" "Stop after the :class:`Distribution` instance has been created and " "populated with the keyword arguments to :func:`setup`" msgstr "" #: ../Doc/distutils/apiref.rst:149 msgid "*config*" msgstr "" #: ../Doc/distutils/apiref.rst:149 msgid "" "Stop after config files have been parsed (and their data stored in the :" "class:`Distribution` instance)" msgstr "" #: ../Doc/distutils/apiref.rst:153 msgid "*commandline*" msgstr "" #: ../Doc/distutils/apiref.rst:153 msgid "" "Stop after the command-line (``sys.argv[1:]`` or *script_args*) have been " "parsed (and the data stored in the :class:`Distribution` instance.)" msgstr "" #: ../Doc/distutils/apiref.rst:158 msgid "*run*" msgstr "" #: ../Doc/distutils/apiref.rst:158 msgid "" "Stop after all commands have been run (the same as if :func:`setup` had " "been called in the usual way). This is the default value." msgstr "" #: ../Doc/distutils/apiref.rst:164 msgid "" "In addition, the :mod:`distutils.core` module exposed a number of classes " "that live elsewhere." msgstr "" #: ../Doc/distutils/apiref.rst:167 msgid ":class:`~distutils.extension.Extension` from :mod:`distutils.extension`" msgstr "" #: ../Doc/distutils/apiref.rst:169 msgid ":class:`~distutils.cmd.Command` from :mod:`distutils.cmd`" msgstr "" #: ../Doc/distutils/apiref.rst:171 msgid ":class:`~distutils.dist.Distribution` from :mod:`distutils.dist`" msgstr "" #: ../Doc/distutils/apiref.rst:173 msgid "" "A short description of each of these follows, but see the relevant module " "for the full reference." msgstr "" #: ../Doc/distutils/apiref.rst:179 msgid "" "The Extension class describes a single C or C++ extension module in a setup " "script. It accepts the following keyword arguments in its constructor:" msgstr "" #: ../Doc/distutils/apiref.rst:187 msgid "" "the full name of the extension, including any packages --- ie. *not* a " "filename or pathname, but Python dotted name" msgstr "" #: ../Doc/distutils/apiref.rst:193 msgid "*sources*" msgstr "" #: ../Doc/distutils/apiref.rst:193 msgid "" "list of source filenames, relative to the distribution root (where the setup " "script lives), in Unix form (slash-separated) for portability. Source files " "may be C, C++, SWIG (.i), platform-specific resource files, or whatever else " "is recognized by the :command:`build_ext` command as source for a Python " "extension." msgstr "" #: ../Doc/distutils/apiref.rst:207 msgid "*include_dirs*" msgstr "" #: ../Doc/distutils/apiref.rst:207 msgid "" "list of directories to search for C/C++ header files (in Unix form for " "portability)" msgstr "" #: ../Doc/distutils/apiref.rst:211 msgid "*define_macros*" msgstr "" #: ../Doc/distutils/apiref.rst:211 msgid "" "list of macros to define; each macro is defined using a 2-tuple ``(name, " "value)``, where *value* is either the string to define it to or ``None`` to " "define it without a particular value (equivalent of ``#define FOO`` in " "source or :option:`!-DFOO` on Unix C compiler command line)" msgstr "" #: ../Doc/distutils/apiref.rst:211 msgid "a list of tuples" msgstr "" #: ../Doc/distutils/apiref.rst:223 msgid "*undef_macros*" msgstr "" #: ../Doc/distutils/apiref.rst:223 msgid "list of macros to undefine explicitly" msgstr "" #: ../Doc/distutils/apiref.rst:226 msgid "*library_dirs*" msgstr "" #: ../Doc/distutils/apiref.rst:226 msgid "list of directories to search for C/C++ libraries at link time" msgstr "" #: ../Doc/distutils/apiref.rst:230 msgid "*libraries*" msgstr "" #: ../Doc/distutils/apiref.rst:230 msgid "list of library names (not filenames or paths) to link against" msgstr "" #: ../Doc/distutils/apiref.rst:234 msgid "*runtime_library_dirs*" msgstr "" #: ../Doc/distutils/apiref.rst:234 msgid "" "list of directories to search for C/C++ libraries at run time (for shared " "extensions, this is when the extension is loaded)" msgstr "" #: ../Doc/distutils/apiref.rst:240 msgid "*extra_objects*" msgstr "" #: ../Doc/distutils/apiref.rst:240 msgid "" "list of extra files to link with (eg. object files not implied by 'sources', " "static library that must be explicitly specified, binary resource files, " "etc.)" msgstr "" #: ../Doc/distutils/apiref.rst:247 msgid "*extra_compile_args*" msgstr "" #: ../Doc/distutils/apiref.rst:247 msgid "" "any extra platform- and compiler-specific information to use when compiling " "the source files in 'sources'. For platforms and compilers where a command " "line makes sense, this is typically a list of command-line arguments, but " "for other platforms it could be anything." msgstr "" #: ../Doc/distutils/apiref.rst:258 msgid "*extra_link_args*" msgstr "" #: ../Doc/distutils/apiref.rst:258 msgid "" "any extra platform- and compiler-specific information to use when linking " "object files together to create the extension (or to create a new static " "Python interpreter). Similar interpretation as for 'extra_compile_args'." msgstr "" #: ../Doc/distutils/apiref.rst:267 msgid "*export_symbols*" msgstr "" #: ../Doc/distutils/apiref.rst:267 msgid "" "list of symbols to be exported from a shared extension. Not used on all " "platforms, and not generally necessary for Python extensions, which " "typically export exactly one symbol: ``init`` + extension_name." msgstr "" #: ../Doc/distutils/apiref.rst:275 msgid "*depends*" msgstr "" #: ../Doc/distutils/apiref.rst:275 msgid "list of files that the extension depends on" msgstr "" #: ../Doc/distutils/apiref.rst:278 msgid "*language*" msgstr "" #: ../Doc/distutils/apiref.rst:278 msgid "" "extension language (i.e. ``'c'``, ``'c++'``, ``'objc'``). Will be detected " "from the source extensions if not provided." msgstr "" #: ../Doc/distutils/apiref.rst:284 msgid "*optional*" msgstr "" #: ../Doc/distutils/apiref.rst:284 msgid "" "specifies that a build failure in the extension should not abort the build " "process, but simply skip the extension." msgstr "" #: ../Doc/distutils/apiref.rst:284 msgid "a boolean" msgstr "" #: ../Doc/distutils/apiref.rst:292 msgid "" "On Unix, C extensions are no longer linked to libpython except on Android " "and Cygwin." msgstr "" #: ../Doc/distutils/apiref.rst:298 msgid "" "A :class:`Distribution` describes how to build, install and package up a " "Python software package." msgstr "" #: ../Doc/distutils/apiref.rst:301 msgid "" "See the :func:`setup` function for a list of keyword arguments accepted by " "the Distribution constructor. :func:`setup` creates a Distribution instance." msgstr "" #: ../Doc/distutils/apiref.rst:304 msgid "" ":class:`~distutils.core.Distribution` now warns if ``classifiers``, " "``keywords`` and ``platforms`` fields are not specified as a list or a " "string." msgstr "" #: ../Doc/distutils/apiref.rst:311 msgid "" "A :class:`Command` class (or rather, an instance of one of its subclasses) " "implement a single distutils command." msgstr "" #: ../Doc/distutils/apiref.rst:316 msgid ":mod:`distutils.ccompiler` --- CCompiler base class" msgstr "" #: ../Doc/distutils/apiref.rst:322 msgid "" "This module provides the abstract base class for the :class:`CCompiler` " "classes. A :class:`CCompiler` instance can be used for all the compile and " "link steps needed to build a single project. Methods are provided to set " "options for the compiler --- macro definitions, include directories, link " "path, libraries and the like." msgstr "" #: ../Doc/distutils/apiref.rst:328 msgid "This module provides the following functions." msgstr "" #: ../Doc/distutils/apiref.rst:333 msgid "" "Generate linker options for searching library directories and linking with " "specific libraries. *libraries* and *library_dirs* are, respectively, lists " "of library names (not filenames!) and search directories. Returns a list of " "command-line options suitable for use with some compiler (depending on the " "two format strings passed in)." msgstr "" #: ../Doc/distutils/apiref.rst:342 msgid "" "Generate C pre-processor options (:option:`!-D`, :option:`!-U`, :option:`!-" "I`) as used by at least two types of compilers: the typical Unix compiler " "and Visual C++. *macros* is the usual thing, a list of 1- or 2-tuples, where " "``(name,)`` means undefine (:option:`!-U`) macro *name*, and ``(name, " "value)`` means define (:option:`!-D`) macro *name* to *value*. " "*include_dirs* is just a list of directory names to be added to the header " "file search path (:option:`!-I`). Returns a list of command-line options " "suitable for either Unix compilers or Visual C++." msgstr "" #: ../Doc/distutils/apiref.rst:354 msgid "Determine the default compiler to use for the given platform." msgstr "" #: ../Doc/distutils/apiref.rst:356 msgid "" "*osname* should be one of the standard Python OS names (i.e. the ones " "returned by ``os.name``) and *platform* the common value returned by ``sys." "platform`` for the platform in question." msgstr "" #: ../Doc/distutils/apiref.rst:360 msgid "" "The default values are ``os.name`` and ``sys.platform`` in case the " "parameters are not given." msgstr "" #: ../Doc/distutils/apiref.rst:366 msgid "" "Factory function to generate an instance of some CCompiler subclass for the " "supplied platform/compiler combination. *plat* defaults to ``os.name`` (eg. " "``'posix'``, ``'nt'``), and *compiler* defaults to the default compiler for " "that platform. Currently only ``'posix'`` and ``'nt'`` are supported, and " "the default compilers are \"traditional Unix interface\" (:class:" "`UnixCCompiler` class) and Visual C++ (:class:`MSVCCompiler` class). Note " "that it's perfectly possible to ask for a Unix compiler object under " "Windows, and a Microsoft compiler object under Unix---if you supply a value " "for *compiler*, *plat* is ignored." msgstr "" #: ../Doc/distutils/apiref.rst:382 msgid "" "Print list of available compilers (used by the :option:`!--help-compiler` " "options to :command:`build`, :command:`build_ext`, :command:`build_clib`)." msgstr "" #: ../Doc/distutils/apiref.rst:388 msgid "" "The abstract base class :class:`CCompiler` defines the interface that must " "be implemented by real compiler classes. The class also has some utility " "methods used by several compiler classes." msgstr "" #: ../Doc/distutils/apiref.rst:392 msgid "" "The basic idea behind a compiler abstraction class is that each instance can " "be used for all the compile/link steps in building a single project. Thus, " "attributes common to all of those compile and link steps --- include " "directories, macros to define, libraries to link against, etc. --- are " "attributes of the compiler instance. To allow for variability in how " "individual files are treated, most of those attributes may be varied on a " "per-compilation or per-link basis." msgstr "" #: ../Doc/distutils/apiref.rst:400 msgid "" "The constructor for each subclass creates an instance of the Compiler " "object. Flags are *verbose* (show verbose output), *dry_run* (don't actually " "execute the steps) and *force* (rebuild everything, regardless of " "dependencies). All of these flags default to ``0`` (off). Note that you " "probably don't want to instantiate :class:`CCompiler` or one of its " "subclasses directly - use the :func:`distutils.CCompiler.new_compiler` " "factory function instead." msgstr "" #: ../Doc/distutils/apiref.rst:407 msgid "" "The following methods allow you to manually alter compiler options for the " "instance of the Compiler class." msgstr "" #: ../Doc/distutils/apiref.rst:413 msgid "" "Add *dir* to the list of directories that will be searched for header files. " "The compiler is instructed to search directories in the order in which they " "are supplied by successive calls to :meth:`add_include_dir`." msgstr "" #: ../Doc/distutils/apiref.rst:420 msgid "" "Set the list of directories that will be searched to *dirs* (a list of " "strings). Overrides any preceding calls to :meth:`add_include_dir`; " "subsequent calls to :meth:`add_include_dir` add to the list passed to :meth:" "`set_include_dirs`. This does not affect any list of standard include " "directories that the compiler may search by default." msgstr "" #: ../Doc/distutils/apiref.rst:429 msgid "" "Add *libname* to the list of libraries that will be included in all links " "driven by this compiler object. Note that *libname* should \\*not\\* be the " "name of a file containing a library, but the name of the library itself: the " "actual filename will be inferred by the linker, the compiler, or the " "compiler class (depending on the platform)." msgstr "" #: ../Doc/distutils/apiref.rst:435 msgid "" "The linker will be instructed to link against libraries in the order they " "were supplied to :meth:`add_library` and/or :meth:`set_libraries`. It is " "perfectly valid to duplicate library names; the linker will be instructed to " "link against libraries as many times as they are mentioned." msgstr "" #: ../Doc/distutils/apiref.rst:443 msgid "" "Set the list of libraries to be included in all links driven by this " "compiler object to *libnames* (a list of strings). This does not affect any " "standard system libraries that the linker may include by default." msgstr "" #: ../Doc/distutils/apiref.rst:450 msgid "" "Add *dir* to the list of directories that will be searched for libraries " "specified to :meth:`add_library` and :meth:`set_libraries`. The linker will " "be instructed to search for libraries in the order they are supplied to :" "meth:`add_library_dir` and/or :meth:`set_library_dirs`." msgstr "" #: ../Doc/distutils/apiref.rst:458 msgid "" "Set the list of library search directories to *dirs* (a list of strings). " "This does not affect any standard library search path that the linker may " "search by default." msgstr "" #: ../Doc/distutils/apiref.rst:465 msgid "" "Add *dir* to the list of directories that will be searched for shared " "libraries at runtime." msgstr "" #: ../Doc/distutils/apiref.rst:471 msgid "" "Set the list of directories to search for shared libraries at runtime to " "*dirs* (a list of strings). This does not affect any standard search path " "that the runtime linker may search by default." msgstr "" #: ../Doc/distutils/apiref.rst:478 msgid "" "Define a preprocessor macro for all compilations driven by this compiler " "object. The optional parameter *value* should be a string; if it is not " "supplied, then the macro will be defined without an explicit value and the " "exact outcome depends on the compiler used." msgstr "" #: ../Doc/distutils/apiref.rst:488 msgid "" "Undefine a preprocessor macro for all compilations driven by this compiler " "object. If the same macro is defined by :meth:`define_macro` and undefined " "by :meth:`undefine_macro` the last call takes precedence (including multiple " "redefinitions or undefinitions). If the macro is redefined/undefined on a " "per-compilation basis (ie. in the call to :meth:`compile`), then that takes " "precedence." msgstr "" #: ../Doc/distutils/apiref.rst:498 msgid "" "Add *object* to the list of object files (or analogues, such as explicitly " "named library files or the output of \"resource compilers\") to be included " "in every link driven by this compiler object." msgstr "" #: ../Doc/distutils/apiref.rst:505 msgid "" "Set the list of object files (or analogues) to be included in every link to " "*objects*. This does not affect any standard object files that the linker " "may include by default (such as system libraries)." msgstr "" #: ../Doc/distutils/apiref.rst:509 msgid "" "The following methods implement methods for autodetection of compiler " "options, providing some functionality similar to GNU :program:`autoconf`." msgstr "" #: ../Doc/distutils/apiref.rst:515 msgid "" "Detect the language of a given file, or list of files. Uses the instance " "attributes :attr:`language_map` (a dictionary), and :attr:`language_order` " "(a list) to do the job." msgstr "" #: ../Doc/distutils/apiref.rst:522 msgid "" "Search the specified list of directories for a static or shared library file " "*lib* and return the full path to that file. If *debug* is true, look for a " "debugging version (if that makes sense on the current platform). Return " "``None`` if *lib* wasn't found in any of the specified directories." msgstr "" #: ../Doc/distutils/apiref.rst:530 msgid "" "Return a boolean indicating whether *funcname* is supported on the current " "platform. The optional arguments can be used to augment the compilation " "environment by providing additional include files and paths and libraries " "and paths." msgstr "" #: ../Doc/distutils/apiref.rst:538 msgid "" "Return the compiler option to add *dir* to the list of directories searched " "for libraries." msgstr "" #: ../Doc/distutils/apiref.rst:544 msgid "" "Return the compiler option to add *lib* to the list of libraries linked into " "the shared library or executable." msgstr "" #: ../Doc/distutils/apiref.rst:550 msgid "" "Return the compiler option to add *dir* to the list of directories searched " "for runtime libraries." msgstr "" #: ../Doc/distutils/apiref.rst:556 msgid "" "Define the executables (and options for them) that will be run to perform " "the various stages of compilation. The exact set of executables that may be " "specified here depends on the compiler class (via the 'executables' class " "attribute), but most will have:" msgstr "" #: ../Doc/distutils/apiref.rst:562 msgid "attribute" msgstr "" #: ../Doc/distutils/apiref.rst:564 msgid "*compiler*" msgstr "" #: ../Doc/distutils/apiref.rst:564 msgid "the C/C++ compiler" msgstr "" #: ../Doc/distutils/apiref.rst:566 msgid "*linker_so*" msgstr "" #: ../Doc/distutils/apiref.rst:566 msgid "linker used to create shared objects and libraries" msgstr "" #: ../Doc/distutils/apiref.rst:569 msgid "*linker_exe*" msgstr "" #: ../Doc/distutils/apiref.rst:569 msgid "linker used to create binary executables" msgstr "" #: ../Doc/distutils/apiref.rst:571 msgid "*archiver*" msgstr "" #: ../Doc/distutils/apiref.rst:571 msgid "static library creator" msgstr "" #: ../Doc/distutils/apiref.rst:574 msgid "" "On platforms with a command-line (Unix, DOS/Windows), each of these is a " "string that will be split into executable name and (optional) list of " "arguments. (Splitting the string is done similarly to how Unix shells " "operate: words are delimited by spaces, but quotes and backslashes can " "override this. See :func:`distutils.util.split_quoted`.)" msgstr "" #: ../Doc/distutils/apiref.rst:580 msgid "The following methods invoke stages in the build process." msgstr "" #: ../Doc/distutils/apiref.rst:585 msgid "" "Compile one or more source files. Generates object files (e.g. transforms " "a :file:`.c` file to a :file:`.o` file.)" msgstr "" #: ../Doc/distutils/apiref.rst:588 msgid "" "*sources* must be a list of filenames, most likely C/C++ files, but in " "reality anything that can be handled by a particular compiler and compiler " "class (eg. :class:`MSVCCompiler` can handle resource files in *sources*). " "Return a list of object filenames, one per source filename in *sources*. " "Depending on the implementation, not all source files will necessarily be " "compiled, but all corresponding object filenames will be returned." msgstr "" #: ../Doc/distutils/apiref.rst:595 msgid "" "If *output_dir* is given, object files will be put under it, while retaining " "their original path component. That is, :file:`foo/bar.c` normally compiles " "to :file:`foo/bar.o` (for a Unix implementation); if *output_dir* is " "*build*, then it would compile to :file:`build/foo/bar.o`." msgstr "" #: ../Doc/distutils/apiref.rst:600 msgid "" "*macros*, if given, must be a list of macro definitions. A macro definition " "is either a ``(name, value)`` 2-tuple or a ``(name,)`` 1-tuple. The former " "defines a macro; if the value is ``None``, the macro is defined without an " "explicit value. The 1-tuple case undefines a macro. Later definitions/" "redefinitions/undefinitions take precedence." msgstr "" #: ../Doc/distutils/apiref.rst:606 msgid "" "*include_dirs*, if given, must be a list of strings, the directories to add " "to the default include file search path for this compilation only." msgstr "" #: ../Doc/distutils/apiref.rst:609 msgid "" "*debug* is a boolean; if true, the compiler will be instructed to output " "debug symbols in (or alongside) the object file(s)." msgstr "" #: ../Doc/distutils/apiref.rst:612 msgid "" "*extra_preargs* and *extra_postargs* are implementation-dependent. On " "platforms that have the notion of a command-line (e.g. Unix, DOS/Windows), " "they are most likely lists of strings: extra command-line arguments to " "prepend/append to the compiler command line. On other platforms, consult " "the implementation class documentation. In any event, they are intended as " "an escape hatch for those occasions when the abstract compiler framework " "doesn't cut the mustard." msgstr "" #: ../Doc/distutils/apiref.rst:619 msgid "" "*depends*, if given, is a list of filenames that all targets depend on. If " "a source file is older than any file in depends, then the source file will " "be recompiled. This supports dependency tracking, but only at a coarse " "granularity." msgstr "" #: ../Doc/distutils/apiref.rst:624 msgid "Raises :exc:`CompileError` on failure." msgstr "" #: ../Doc/distutils/apiref.rst:629 msgid "" "Link a bunch of stuff together to create a static library file. The \"bunch " "of stuff\" consists of the list of object files supplied as *objects*, the " "extra object files supplied to :meth:`add_link_object` and/or :meth:" "`set_link_objects`, the libraries supplied to :meth:`add_library` and/or :" "meth:`set_libraries`, and the libraries supplied as *libraries* (if any)." msgstr "" #: ../Doc/distutils/apiref.rst:635 msgid "" "*output_libname* should be a library name, not a filename; the filename will " "be inferred from the library name. *output_dir* is the directory where the " "library file will be put." msgstr "" #: ../Doc/distutils/apiref.rst:641 msgid "" "*debug* is a boolean; if true, debugging information will be included in the " "library (note that on most platforms, it is the compile step where this " "matters: the *debug* flag is included here just for consistency)." msgstr "" #: ../Doc/distutils/apiref.rst:645 ../Doc/distutils/apiref.rst:687 msgid "" "*target_lang* is the target language for which the given objects are being " "compiled. This allows specific linkage time treatment of certain languages." msgstr "" #: ../Doc/distutils/apiref.rst:648 msgid "Raises :exc:`LibError` on failure." msgstr "" #: ../Doc/distutils/apiref.rst:653 msgid "" "Link a bunch of stuff together to create an executable or shared library " "file." msgstr "" #: ../Doc/distutils/apiref.rst:655 msgid "" "The \"bunch of stuff\" consists of the list of object files supplied as " "*objects*. *output_filename* should be a filename. If *output_dir* is " "supplied, *output_filename* is relative to it (i.e. *output_filename* can " "provide directory components if needed)." msgstr "" #: ../Doc/distutils/apiref.rst:660 msgid "" "*libraries* is a list of libraries to link against. These are library " "names, not filenames, since they're translated into filenames in a platform-" "specific way (eg. *foo* becomes :file:`libfoo.a` on Unix and :file:`foo.lib` " "on DOS/Windows). However, they can include a directory component, which " "means the linker will look in that specific directory rather than searching " "all the normal locations." msgstr "" #: ../Doc/distutils/apiref.rst:667 msgid "" "*library_dirs*, if supplied, should be a list of directories to search for " "libraries that were specified as bare library names (ie. no directory " "component). These are on top of the system default and those supplied to :" "meth:`add_library_dir` and/or :meth:`set_library_dirs`. " "*runtime_library_dirs* is a list of directories that will be embedded into " "the shared library and used to search for other shared libraries that " "\\*it\\* depends on at run-time. (This may only be relevant on Unix.)" msgstr "" #: ../Doc/distutils/apiref.rst:675 msgid "" "*export_symbols* is a list of symbols that the shared library will export. " "(This appears to be relevant only on Windows.)" msgstr "" #: ../Doc/distutils/apiref.rst:678 msgid "" "*debug* is as for :meth:`compile` and :meth:`create_static_lib`, with the " "slight distinction that it actually matters on most platforms (as opposed " "to :meth:`create_static_lib`, which includes a *debug* flag mostly for " "form's sake)." msgstr "" #: ../Doc/distutils/apiref.rst:683 msgid "" "*extra_preargs* and *extra_postargs* are as for :meth:`compile` (except of " "course that they supply command-line arguments for the particular linker " "being used)." msgstr "" #: ../Doc/distutils/apiref.rst:690 msgid "Raises :exc:`LinkError` on failure." msgstr "" #: ../Doc/distutils/apiref.rst:695 msgid "" "Link an executable. *output_progname* is the name of the file executable, " "while *objects* are a list of object filenames to link in. Other arguments " "are as for the :meth:`link` method." msgstr "" #: ../Doc/distutils/apiref.rst:702 msgid "" "Link a shared library. *output_libname* is the name of the output library, " "while *objects* is a list of object filenames to link in. Other arguments " "are as for the :meth:`link` method." msgstr "" #: ../Doc/distutils/apiref.rst:709 msgid "" "Link a shared object. *output_filename* is the name of the shared object " "that will be created, while *objects* is a list of object filenames to link " "in. Other arguments are as for the :meth:`link` method." msgstr "" #: ../Doc/distutils/apiref.rst:716 msgid "" "Preprocess a single C/C++ source file, named in *source*. Output will be " "written to file named *output_file*, or *stdout* if *output_file* not " "supplied. *macros* is a list of macro definitions as for :meth:`compile`, " "which will augment the macros set with :meth:`define_macro` and :meth:" "`undefine_macro`. *include_dirs* is a list of directory names that will be " "added to the default list, in the same way as :meth:`add_include_dir`." msgstr "" #: ../Doc/distutils/apiref.rst:723 msgid "Raises :exc:`PreprocessError` on failure." msgstr "" #: ../Doc/distutils/apiref.rst:725 msgid "" "The following utility methods are defined by the :class:`CCompiler` class, " "for use by the various concrete subclasses." msgstr "" #: ../Doc/distutils/apiref.rst:731 msgid "" "Returns the filename of the executable for the given *basename*. Typically " "for non-Windows platforms this is the same as the basename, while Windows " "will get a :file:`.exe` added." msgstr "" #: ../Doc/distutils/apiref.rst:738 msgid "" "Returns the filename for the given library name on the current platform. On " "Unix a library with *lib_type* of ``'static'`` will typically be of the " "form :file:`liblibname.a`, while a *lib_type* of ``'dynamic'`` will be of " "the form :file:`liblibname.so`." msgstr "" #: ../Doc/distutils/apiref.rst:746 msgid "" "Returns the name of the object files for the given source files. " "*source_filenames* should be a list of filenames." msgstr "" #: ../Doc/distutils/apiref.rst:752 msgid "" "Returns the name of a shared object file for the given file name *basename*." msgstr "" #: ../Doc/distutils/apiref.rst:757 msgid "" "Invokes :func:`distutils.util.execute`. This method invokes a Python " "function *func* with the given arguments *args*, after logging and taking " "into account the *dry_run* flag." msgstr "" #: ../Doc/distutils/apiref.rst:764 msgid "" "Invokes :func:`distutils.util.spawn`. This invokes an external process to " "run the given command." msgstr "" #: ../Doc/distutils/apiref.rst:770 msgid "" "Invokes :func:`distutils.dir_util.mkpath`. This creates a directory and any " "missing ancestor directories." msgstr "" #: ../Doc/distutils/apiref.rst:776 msgid "Invokes :meth:`distutils.file_util.move_file`. Renames *src* to *dst*." msgstr "" #: ../Doc/distutils/apiref.rst:781 msgid "Write a message using :func:`distutils.log.debug`." msgstr "" #: ../Doc/distutils/apiref.rst:786 msgid "Write a warning message *msg* to standard error." msgstr "" #: ../Doc/distutils/apiref.rst:791 msgid "" "If the *debug* flag is set on this :class:`CCompiler` instance, print *msg* " "to standard output, otherwise do nothing." msgstr "" #: ../Doc/distutils/apiref.rst:803 msgid ":mod:`distutils.unixccompiler` --- Unix C Compiler" msgstr "" #: ../Doc/distutils/apiref.rst:809 msgid "" "This module provides the :class:`UnixCCompiler` class, a subclass of :class:" "`CCompiler` that handles the typical Unix-style command-line C compiler:" msgstr "" #: ../Doc/distutils/apiref.rst:812 msgid "macros defined with :option:`!-Dname[=value]`" msgstr "" #: ../Doc/distutils/apiref.rst:814 msgid "macros undefined with :option:`!-Uname`" msgstr "" #: ../Doc/distutils/apiref.rst:816 msgid "include search directories specified with :option:`!-Idir`" msgstr "" #: ../Doc/distutils/apiref.rst:818 msgid "libraries specified with :option:`!-llib`" msgstr "" #: ../Doc/distutils/apiref.rst:820 msgid "library search directories specified with :option:`!-Ldir`" msgstr "" #: ../Doc/distutils/apiref.rst:822 msgid "" "compile handled by :program:`cc` (or similar) executable with :option:`!-c` " "option: compiles :file:`.c` to :file:`.o`" msgstr "" #: ../Doc/distutils/apiref.rst:825 msgid "" "link static library handled by :program:`ar` command (possibly with :program:" "`ranlib`)" msgstr "" #: ../Doc/distutils/apiref.rst:828 msgid "link shared library handled by :program:`cc` :option:`!-shared`" msgstr "" #: ../Doc/distutils/apiref.rst:832 msgid ":mod:`distutils.msvccompiler` --- Microsoft Compiler" msgstr "" #: ../Doc/distutils/apiref.rst:839 msgid "" "This module provides :class:`MSVCCompiler`, an implementation of the " "abstract :class:`CCompiler` class for Microsoft Visual Studio. Typically, " "extension modules need to be compiled with the same compiler that was used " "to compile Python. For Python 2.3 and earlier, the compiler was Visual " "Studio 6. For Python 2.4 and 2.5, the compiler is Visual Studio .NET 2003." msgstr "" #: ../Doc/distutils/apiref.rst:845 msgid "" ":class:`MSVCCompiler` will normally choose the right compiler, linker etc. " "on its own. To override this choice, the environment variables " "*DISTUTILS_USE_SDK* and *MSSdk* must be both set. *MSSdk* indicates that the " "current environment has been setup by the SDK's ``SetEnv.Cmd`` script, or " "that the environment variables had been registered when the SDK was " "installed; *DISTUTILS_USE_SDK* indicates that the distutils user has made an " "explicit choice to override the compiler selection by :class:`MSVCCompiler`." msgstr "" #: ../Doc/distutils/apiref.rst:855 msgid ":mod:`distutils.bcppcompiler` --- Borland Compiler" msgstr "" #: ../Doc/distutils/apiref.rst:860 msgid "" "This module provides :class:`BorlandCCompiler`, a subclass of the abstract :" "class:`CCompiler` class for the Borland C++ compiler." msgstr "" #: ../Doc/distutils/apiref.rst:865 msgid ":mod:`distutils.cygwincompiler` --- Cygwin Compiler" msgstr "" #: ../Doc/distutils/apiref.rst:870 msgid "" "This module provides the :class:`CygwinCCompiler` class, a subclass of :" "class:`UnixCCompiler` that handles the Cygwin port of the GNU C compiler to " "Windows. It also contains the Mingw32CCompiler class which handles the " "mingw32 port of GCC (same as cygwin in no-cygwin mode)." msgstr "" #: ../Doc/distutils/apiref.rst:877 msgid ":mod:`distutils.archive_util` --- Archiving utilities" msgstr "" #: ../Doc/distutils/apiref.rst:883 msgid "" "This module provides a few functions for creating archive files, such as " "tarballs or zipfiles." msgstr "" #: ../Doc/distutils/apiref.rst:889 msgid "" "Create an archive file (eg. ``zip`` or ``tar``). *base_name* is the name " "of the file to create, minus any format-specific extension; *format* is the " "archive format: one of ``zip``, ``tar``, ``gztar``, ``bztar``, ``xztar``, or " "``ztar``. *root_dir* is a directory that will be the root directory of the " "archive; ie. we typically ``chdir`` into *root_dir* before creating the " "archive. *base_dir* is the directory where we start archiving from; ie. " "*base_dir* will be the common prefix of all files and directories in the " "archive. *root_dir* and *base_dir* both default to the current directory. " "Returns the name of the archive file." msgstr "" #: ../Doc/distutils/apiref.rst:899 msgid "Added support for the ``xztar`` format." msgstr "" #: ../Doc/distutils/apiref.rst:905 msgid "" "'Create an (optional compressed) archive as a tar file from all files in and " "under *base_dir*. *compress* must be ``'gzip'`` (the default), ``'bzip2'``, " "``'xz'``, ``'compress'``, or ``None``. For the ``'compress'`` method the " "compression utility named by :program:`compress` must be on the default " "program search path, so this is probably Unix-specific. The output tar file " "will be named :file:`base_dir.tar`, possibly plus the appropriate " "compression extension (``.gz``, ``.bz2``, ``.xz`` or ``.Z``). Return the " "output filename." msgstr "" #: ../Doc/distutils/apiref.rst:914 msgid "Added support for the ``xz`` compression." msgstr "" #: ../Doc/distutils/apiref.rst:920 msgid "" "Create a zip file from all files in and under *base_dir*. The output zip " "file will be named *base_name* + :file:`.zip`. Uses either the :mod:" "`zipfile` Python module (if available) or the InfoZIP :file:`zip` utility " "(if installed and found on the default search path). If neither tool is " "available, raises :exc:`DistutilsExecError`. Returns the name of the " "output zip file." msgstr "" #: ../Doc/distutils/apiref.rst:928 msgid ":mod:`distutils.dep_util` --- Dependency checking" msgstr "" #: ../Doc/distutils/apiref.rst:934 msgid "" "This module provides functions for performing simple, timestamp-based " "dependency of files and groups of files; also, functions based entirely on " "such timestamp dependency analysis." msgstr "" #: ../Doc/distutils/apiref.rst:941 msgid "" "Return true if *source* exists and is more recently modified than *target*, " "or if *source* exists and *target* doesn't. Return false if both exist and " "*target* is the same age or newer than *source*. Raise :exc:" "`DistutilsFileError` if *source* does not exist." msgstr "" #: ../Doc/distutils/apiref.rst:949 msgid "" "Walk two filename lists in parallel, testing if each source is newer than " "its corresponding target. Return a pair of lists (*sources*, *targets*) " "where source is newer than target, according to the semantics of :func:" "`newer`." msgstr "" #: ../Doc/distutils/apiref.rst:958 msgid "" "Return true if *target* is out-of-date with respect to any file listed in " "*sources*. In other words, if *target* exists and is newer than every file " "in *sources*, return false; otherwise return true. *missing* controls what " "we do when a source file is missing; the default (``'error'``) is to blow up " "with an :exc:`OSError` from inside :func:`os.stat`; if it is ``'ignore'``, " "we silently drop any missing source files; if it is ``'newer'``, any missing " "source files make us assume that *target* is out-of-date (this is handy in " "\"dry-run\" mode: it'll make you pretend to carry out commands that wouldn't " "work because inputs are missing, but that doesn't matter because you're not " "actually going to run the commands)." msgstr "" #: ../Doc/distutils/apiref.rst:971 msgid ":mod:`distutils.dir_util` --- Directory tree operations" msgstr "" #: ../Doc/distutils/apiref.rst:977 msgid "" "This module provides functions for operating on directories and trees of " "directories." msgstr "" #: ../Doc/distutils/apiref.rst:983 msgid "" "Create a directory and any missing ancestor directories. If the directory " "already exists (or if *name* is the empty string, which means the current " "directory, which of course exists), then do nothing. Raise :exc:" "`DistutilsFileError` if unable to create some directory along the way (eg. " "some sub-path exists, but is a file rather than a directory). If *verbose* " "is true, print a one-line summary of each mkdir to stdout. Return the list " "of directories actually created." msgstr "" #: ../Doc/distutils/apiref.rst:994 msgid "" "Create all the empty directories under *base_dir* needed to put *files* " "there. *base_dir* is just the name of a directory which doesn't necessarily " "exist yet; *files* is a list of filenames to be interpreted relative to " "*base_dir*. *base_dir* + the directory portion of every file in *files* will " "be created if it doesn't already exist. *mode*, *verbose* and *dry_run* " "flags are as for :func:`mkpath`." msgstr "" #: ../Doc/distutils/apiref.rst:1004 msgid "" "Copy an entire directory tree *src* to a new location *dst*. Both *src* and " "*dst* must be directory names. If *src* is not a directory, raise :exc:" "`DistutilsFileError`. If *dst* does not exist, it is created with :func:" "`mkpath`. The end result of the copy is that every file in *src* is copied " "to *dst*, and directories under *src* are recursively copied to *dst*. " "Return the list of files that were copied or might have been copied, using " "their output name. The return value is unaffected by *update* or *dry_run*: " "it is simply the list of all files under *src*, with the names changed to be " "under *dst*." msgstr "" #: ../Doc/distutils/apiref.rst:1014 msgid "" "*preserve_mode* and *preserve_times* are the same as for :func:`distutils." "file_util.copy_file`; note that they only apply to regular files, not to " "directories. If *preserve_symlinks* is true, symlinks will be copied as " "symlinks (on platforms that support them!); otherwise (the default), the " "destination of the symlink will be copied. *update* and *verbose* are the " "same as for :func:`copy_file`." msgstr "" #: distutils/apiref.rst:1022 #, fuzzy msgid "" "Files in *src* that begin with :file:`.nfs` are skipped (more information on " "these files is available in answer D2 of the `NFS FAQ page `_)." msgstr "" #: ../Doc/distutils/apiref.rst:1026 msgid "NFS files are ignored." msgstr "" #: ../Doc/distutils/apiref.rst:1031 msgid "" "Recursively remove *directory* and all files and directories underneath it. " "Any errors are ignored (apart from being reported to ``sys.stdout`` if " "*verbose* is true)." msgstr "" #: ../Doc/distutils/apiref.rst:1037 msgid ":mod:`distutils.file_util` --- Single file operations" msgstr "" #: ../Doc/distutils/apiref.rst:1043 msgid "" "This module contains some utility functions for operating on individual " "files." msgstr "" #: ../Doc/distutils/apiref.rst:1048 msgid "" "Copy file *src* to *dst*. If *dst* is a directory, then *src* is copied " "there with the same name; otherwise, it must be a filename. (If the file " "exists, it will be ruthlessly clobbered.) If *preserve_mode* is true (the " "default), the file's mode (type and permission bits, or whatever is " "analogous on the current platform) is copied. If *preserve_times* is true " "(the default), the last-modified and last-access times are copied as well. " "If *update* is true, *src* will only be copied if *dst* does not exist, or " "if *dst* does exist but is older than *src*." msgstr "" #: ../Doc/distutils/apiref.rst:1057 msgid "" "*link* allows you to make hard links (using :func:`os.link`) or symbolic " "links (using :func:`os.symlink`) instead of copying: set it to ``'hard'`` or " "``'sym'``; if it is ``None`` (the default), files are copied. Don't set " "*link* on systems that don't support it: :func:`copy_file` doesn't check if " "hard or symbolic linking is available. It uses :func:`_copy_file_contents` " "to copy file contents." msgstr "" #: ../Doc/distutils/apiref.rst:1064 msgid "" "Return a tuple ``(dest_name, copied)``: *dest_name* is the actual name of " "the output file, and *copied* is true if the file was copied (or would have " "been copied, if *dry_run* true)." msgstr "" #: ../Doc/distutils/apiref.rst:1078 msgid "" "Move file *src* to *dst*. If *dst* is a directory, the file will be moved " "into it with the same name; otherwise, *src* is just renamed to *dst*. " "Returns the new full name of the file." msgstr "" #: ../Doc/distutils/apiref.rst:1084 msgid "" "Handles cross-device moves on Unix using :func:`copy_file`. What about " "other systems?" msgstr "" #: ../Doc/distutils/apiref.rst:1090 msgid "" "Create a file called *filename* and write *contents* (a sequence of strings " "without line terminators) to it." msgstr "" #: ../Doc/distutils/apiref.rst:1095 msgid ":mod:`distutils.util` --- Miscellaneous other utility functions" msgstr "" #: ../Doc/distutils/apiref.rst:1101 msgid "" "This module contains other assorted bits and pieces that don't fit into any " "other utility module." msgstr "" #: ../Doc/distutils/apiref.rst:1107 msgid "" "Return a string that identifies the current platform. This is used mainly " "to distinguish platform-specific build directories and platform-specific " "built distributions. Typically includes the OS name and version and the " "architecture (as supplied by 'os.uname()'), although the exact information " "included depends on the OS; e.g., on Linux, the kernel version isn't " "particularly important." msgstr "" #: ../Doc/distutils/apiref.rst:1114 msgid "Examples of returned values:" msgstr "" #: ../Doc/distutils/apiref.rst:1116 msgid "``linux-i586``" msgstr "" #: ../Doc/distutils/apiref.rst:1117 msgid "``linux-alpha``" msgstr "" #: ../Doc/distutils/apiref.rst:1118 msgid "``solaris-2.6-sun4u``" msgstr "" #: ../Doc/distutils/apiref.rst:1120 msgid "For non-POSIX platforms, currently just returns ``sys.platform``." msgstr "" #: ../Doc/distutils/apiref.rst:1122 msgid "" "For macOS systems the OS version reflects the minimal version on which " "binaries will run (that is, the value of ``MACOSX_DEPLOYMENT_TARGET`` during " "the build of Python), not the OS version of the current system." msgstr "" #: ../Doc/distutils/apiref.rst:1126 msgid "" "For universal binary builds on macOS the architecture value reflects the " "universal binary status instead of the architecture of the current " "processor. For 32-bit universal binaries the architecture is ``fat``, for 64-" "bit universal binaries the architecture is ``fat64``, and for 4-way " "universal binaries the architecture is ``universal``. Starting from Python " "2.7 and Python 3.2 the architecture ``fat3`` is used for a 3-way universal " "build (ppc, i386, x86_64) and ``intel`` is used for a universal build with " "the i386 and x86_64 architectures" msgstr "" #: ../Doc/distutils/apiref.rst:1135 msgid "Examples of returned values on macOS:" msgstr "" #: ../Doc/distutils/apiref.rst:1137 msgid "``macosx-10.3-ppc``" msgstr "" #: ../Doc/distutils/apiref.rst:1139 msgid "``macosx-10.3-fat``" msgstr "" #: ../Doc/distutils/apiref.rst:1141 msgid "``macosx-10.5-universal``" msgstr "" #: ../Doc/distutils/apiref.rst:1143 msgid "``macosx-10.6-intel``" msgstr "" #: ../Doc/distutils/apiref.rst:1145 msgid "" "For AIX, Python 3.9 and later return a string starting with \"aix\", " "followed by additional fields (separated by ``'-'``) that represent the " "combined values of AIX Version, Release and Technology Level (first field), " "Build Date (second field), and bit-size (third field). Python 3.8 and " "earlier returned only a single additional field with the AIX Version and " "Release." msgstr "" #: ../Doc/distutils/apiref.rst:1151 msgid "Examples of returned values on AIX:" msgstr "" #: ../Doc/distutils/apiref.rst:1153 msgid "" "``aix-5307-0747-32`` # 32-bit build on AIX ``oslevel -s``: 5300-07-00-0000" msgstr "" #: ../Doc/distutils/apiref.rst:1155 msgid "" "``aix-7105-1731-64`` # 64-bit build on AIX ``oslevel -s``: 7100-05-01-1731" msgstr "" #: ../Doc/distutils/apiref.rst:1157 msgid "``aix-7.2`` # Legacy form reported in Python 3.8 and earlier" msgstr "" #: ../Doc/distutils/apiref.rst:1159 msgid "" "The AIX platform string format now also includes the technology level, build " "date, and ABI bit-size." msgstr "" #: ../Doc/distutils/apiref.rst:1166 msgid "" "Return 'pathname' as a name that will work on the native filesystem, i.e. " "split it on '/' and put it back together again using the current directory " "separator. Needed because filenames in the setup script are always supplied " "in Unix style, and have to be converted to the local convention before we " "can actually use them in the filesystem. Raises :exc:`ValueError` on non-" "Unix-ish systems if *pathname* either starts or ends with a slash." msgstr "" #: ../Doc/distutils/apiref.rst:1176 msgid "" "Return *pathname* with *new_root* prepended. If *pathname* is relative, " "this is equivalent to ``os.path.join(new_root,pathname)`` Otherwise, it " "requires making *pathname* relative and then joining the two, which is " "tricky on DOS/Windows." msgstr "" #: ../Doc/distutils/apiref.rst:1183 msgid "" "Ensure that 'os.environ' has all the environment variables we guarantee that " "users can use in config files, command-line options, etc. Currently this " "includes:" msgstr "" #: ../Doc/distutils/apiref.rst:1187 msgid ":envvar:`HOME` - user's home directory (Unix only)" msgstr "" #: ../Doc/distutils/apiref.rst:1188 msgid "" ":envvar:`PLAT` - description of the current platform, including hardware and " "OS (see :func:`get_platform`)" msgstr "" #: ../Doc/distutils/apiref.rst:1194 msgid "" "Perform shell/Perl-style variable substitution on *s*. Every occurrence of " "``$`` followed by a name is considered a variable, and variable is " "substituted by the value found in the *local_vars* dictionary, or in ``os." "environ`` if it's not in *local_vars*. *os.environ* is first checked/" "augmented to guarantee that it contains certain values: see :func:" "`check_environ`. Raise :exc:`ValueError` for any variables not found in " "either *local_vars* or ``os.environ``." msgstr "" #: ../Doc/distutils/apiref.rst:1201 msgid "" "Note that this is not a full-fledged string interpolation function. A valid " "``$variable`` can consist only of upper and lower case letters, numbers and " "an underscore. No { } or ( ) style quoting is available." msgstr "" #: ../Doc/distutils/apiref.rst:1208 msgid "" "Split a string up according to Unix shell-like rules for quotes and " "backslashes. In short: words are delimited by spaces, as long as those " "spaces are not escaped by a backslash, or inside a quoted string. Single and " "double quotes are equivalent, and the quote characters can be backslash-" "escaped. The backslash is stripped from any two-character escape sequence, " "leaving only the escaped character. The quote characters are stripped from " "any quoted string. Returns a list of words." msgstr "" #: ../Doc/distutils/apiref.rst:1221 msgid "" "Perform some action that affects the outside world (for instance, writing to " "the filesystem). Such actions are special because they are disabled by the " "*dry_run* flag. This method takes care of all that bureaucracy for you; " "all you have to do is supply the function to call and an argument tuple for " "it (to embody the \"external action\" being performed), and an optional " "message to print." msgstr "" #: ../Doc/distutils/apiref.rst:1230 msgid "Convert a string representation of truth to true (1) or false (0)." msgstr "" #: ../Doc/distutils/apiref.rst:1232 msgid "" "True values are ``y``, ``yes``, ``t``, ``true``, ``on`` and ``1``; false " "values are ``n``, ``no``, ``f``, ``false``, ``off`` and ``0``. Raises :exc:" "`ValueError` if *val* is anything else." msgstr "" #: ../Doc/distutils/apiref.rst:1239 msgid "" "Byte-compile a collection of Python source files to :file:`.pyc` files in a :" "file:`__pycache__` subdirectory (see :pep:`3147` and :pep:`488`). *py_files* " "is a list of files to compile; any files that don't end in :file:`.py` are " "silently skipped. *optimize* must be one of the following:" msgstr "" #: ../Doc/distutils/apiref.rst:1244 msgid "``0`` - don't optimize" msgstr "" #: ../Doc/distutils/apiref.rst:1245 msgid "``1`` - normal optimization (like ``python -O``)" msgstr "" #: ../Doc/distutils/apiref.rst:1246 msgid "``2`` - extra optimization (like ``python -OO``)" msgstr "" #: ../Doc/distutils/apiref.rst:1248 msgid "If *force* is true, all files are recompiled regardless of timestamps." msgstr "" #: ../Doc/distutils/apiref.rst:1250 msgid "" "The source filename encoded in each :term:`bytecode` file defaults to the " "filenames listed in *py_files*; you can modify these with *prefix* and " "*basedir*. *prefix* is a string that will be stripped off of each source " "filename, and *base_dir* is a directory name that will be prepended (after " "*prefix* is stripped). You can supply either or both (or neither) of " "*prefix* and *base_dir*, as you wish." msgstr "" #: ../Doc/distutils/apiref.rst:1257 msgid "" "If *dry_run* is true, doesn't actually do anything that would affect the " "filesystem." msgstr "" #: ../Doc/distutils/apiref.rst:1260 msgid "" "Byte-compilation is either done directly in this interpreter process with " "the standard :mod:`py_compile` module, or indirectly by writing a temporary " "script and executing it. Normally, you should let :func:`byte_compile` " "figure out to use direct compilation or not (see the source for details). " "The *direct* flag is used by the script generated in indirect mode; unless " "you know what you're doing, leave it set to ``None``." msgstr "" #: ../Doc/distutils/apiref.rst:1267 msgid "" "Create ``.pyc`` files with an :func:`import magic tag ` in " "their name, in a :file:`__pycache__` subdirectory instead of files without " "tag in the current directory." msgstr "" #: ../Doc/distutils/apiref.rst:1272 msgid "Create ``.pyc`` files according to :pep:`488`." msgstr "" #: ../Doc/distutils/apiref.rst:1278 msgid "" "Return a version of *header* escaped for inclusion in an :rfc:`822` header, " "by ensuring there are 8 spaces space after each newline. Note that it does " "no other modification of the string." msgstr "" #: ../Doc/distutils/apiref.rst:1288 msgid ":mod:`distutils.dist` --- The Distribution class" msgstr "" #: ../Doc/distutils/apiref.rst:1295 msgid "" "This module provides the :class:`~distutils.core.Distribution` class, which " "represents the module distribution being built/installed/distributed." msgstr "" #: ../Doc/distutils/apiref.rst:1300 msgid ":mod:`distutils.extension` --- The Extension class" msgstr "" #: ../Doc/distutils/apiref.rst:1307 msgid "" "This module provides the :class:`Extension` class, used to describe C/C++ " "extension modules in setup scripts." msgstr "" #: ../Doc/distutils/apiref.rst:1315 msgid ":mod:`distutils.debug` --- Distutils debug mode" msgstr "" #: ../Doc/distutils/apiref.rst:1321 msgid "This module provides the DEBUG flag." msgstr "" #: ../Doc/distutils/apiref.rst:1325 msgid ":mod:`distutils.errors` --- Distutils exceptions" msgstr "" #: ../Doc/distutils/apiref.rst:1331 msgid "" "Provides exceptions used by the Distutils modules. Note that Distutils " "modules may raise standard exceptions; in particular, SystemExit is usually " "raised for errors that are obviously the end-user's fault (eg. bad command-" "line arguments)." msgstr "" #: ../Doc/distutils/apiref.rst:1335 msgid "" "This module is safe to use in ``from ... import *`` mode; it only exports " "symbols whose names start with ``Distutils`` and end with ``Error``." msgstr "" #: ../Doc/distutils/apiref.rst:1340 msgid "" ":mod:`distutils.fancy_getopt` --- Wrapper around the standard getopt module" msgstr "" #: ../Doc/distutils/apiref.rst:1346 msgid "" "This module provides a wrapper around the standard :mod:`getopt` module " "that provides the following additional features:" msgstr "" #: ../Doc/distutils/apiref.rst:1349 msgid "short and long options are tied together" msgstr "" #: ../Doc/distutils/apiref.rst:1351 msgid "" "options have help strings, so :func:`fancy_getopt` could potentially create " "a complete usage summary" msgstr "" #: ../Doc/distutils/apiref.rst:1354 msgid "options set attributes of a passed-in object" msgstr "" #: ../Doc/distutils/apiref.rst:1356 msgid "" "boolean options can have \"negative aliases\" --- eg. if :option:`!--quiet` " "is the \"negative alias\" of :option:`!--verbose`, then :option:`!--quiet` " "on the command line sets *verbose* to false." msgstr "" #: ../Doc/distutils/apiref.rst:1362 msgid "" "Wrapper function. *options* is a list of ``(long_option, short_option, " "help_string)`` 3-tuples as described in the constructor for :class:" "`FancyGetopt`. *negative_opt* should be a dictionary mapping option names to " "option names, both the key and value should be in the *options* list. " "*object* is an object which will be used to store values (see the :meth:" "`getopt` method of the :class:`FancyGetopt` class). *args* is the argument " "list. Will use ``sys.argv[1:]`` if you pass ``None`` as *args*." msgstr "" #: ../Doc/distutils/apiref.rst:1373 msgid "Wraps *text* to less than *width* wide." msgstr "" #: ../Doc/distutils/apiref.rst:1378 msgid "" "The option_table is a list of 3-tuples: ``(long_option, short_option, " "help_string)``" msgstr "" #: ../Doc/distutils/apiref.rst:1381 msgid "" "If an option takes an argument, its *long_option* should have ``'='`` " "appended; *short_option* should just be a single character, no ``':'`` in " "any case. *short_option* should be ``None`` if a *long_option* doesn't have " "a corresponding *short_option*. All option tuples must have long options." msgstr "" #: ../Doc/distutils/apiref.rst:1386 msgid "The :class:`FancyGetopt` class provides the following methods:" msgstr "" #: ../Doc/distutils/apiref.rst:1391 msgid "Parse command-line options in args. Store as attributes on *object*." msgstr "" #: ../Doc/distutils/apiref.rst:1393 msgid "" "If *args* is ``None`` or not supplied, uses ``sys.argv[1:]``. If *object* " "is ``None`` or not supplied, creates a new :class:`OptionDummy` instance, " "stores option values there, and returns a tuple ``(args, object)``. If " "*object* is supplied, it is modified in place and :func:`getopt` just " "returns *args*; in both cases, the returned *args* is a modified copy of the " "passed-in *args* list, which is left untouched." msgstr "" #: ../Doc/distutils/apiref.rst:1405 msgid "" "Returns the list of ``(option, value)`` tuples processed by the previous run " "of :meth:`getopt` Raises :exc:`RuntimeError` if :meth:`getopt` hasn't been " "called yet." msgstr "" #: ../Doc/distutils/apiref.rst:1412 msgid "" "Generate help text (a list of strings, one per suggested line of output) " "from the option table for this :class:`FancyGetopt` object." msgstr "" #: ../Doc/distutils/apiref.rst:1415 msgid "If supplied, prints the supplied *header* at the top of the help." msgstr "" #: ../Doc/distutils/apiref.rst:1419 msgid ":mod:`distutils.filelist` --- The FileList class" msgstr "" #: ../Doc/distutils/apiref.rst:1426 msgid "" "This module provides the :class:`FileList` class, used for poking about the " "filesystem and building lists of files." msgstr "" #: ../Doc/distutils/apiref.rst:1431 msgid ":mod:`distutils.log` --- Simple :pep:`282`-style logging" msgstr "" #: ../Doc/distutils/apiref.rst:1438 msgid ":mod:`distutils.spawn` --- Spawn a sub-process" msgstr "" #: ../Doc/distutils/apiref.rst:1444 msgid "" "This module provides the :func:`spawn` function, a front-end to various " "platform-specific functions for launching another program in a sub-process. " "Also provides :func:`find_executable` to search the path for a given " "executable name." msgstr "" #: ../Doc/distutils/apiref.rst:1451 msgid ":mod:`distutils.sysconfig` --- System configuration information" msgstr "" #: ../Doc/distutils/apiref.rst:1455 msgid ":mod:`distutils.sysconfig` has been merged into :mod:`sysconfig`." msgstr "" #: ../Doc/distutils/apiref.rst:1462 msgid "" "The :mod:`distutils.sysconfig` module provides access to Python's low-level " "configuration information. The specific configuration variables available " "depend heavily on the platform and configuration. The specific variables " "depend on the build process for the specific version of Python being run; " "the variables are those found in the :file:`Makefile` and configuration " "header that are installed with Python on Unix systems. The configuration " "header is called :file:`pyconfig.h` for Python versions starting with 2.2, " "and :file:`config.h` for earlier versions of Python." msgstr "" #: ../Doc/distutils/apiref.rst:1471 msgid "" "Some additional functions are provided which perform some useful " "manipulations for other parts of the :mod:`distutils` package." msgstr "" #: ../Doc/distutils/apiref.rst:1477 msgid "The result of ``os.path.normpath(sys.prefix)``." msgstr "" #: ../Doc/distutils/apiref.rst:1482 msgid "The result of ``os.path.normpath(sys.exec_prefix)``." msgstr "" #: ../Doc/distutils/apiref.rst:1487 msgid "" "Return the value of a single variable. This is equivalent to " "``get_config_vars().get(name)``." msgstr "" #: ../Doc/distutils/apiref.rst:1493 msgid "" "Return a set of variable definitions. If there are no arguments, this " "returns a dictionary mapping names of configuration variables to values. If " "arguments are provided, they should be strings, and the return value will be " "a sequence giving the associated values. If a given name does not have a " "corresponding value, ``None`` will be included for that variable." msgstr "" #: ../Doc/distutils/apiref.rst:1502 msgid "" "Return the full path name of the configuration header. For Unix, this will " "be the header generated by the :program:`configure` script; for other " "platforms the header will have been supplied directly by the Python source " "distribution. The file is a platform-specific text file." msgstr "" #: ../Doc/distutils/apiref.rst:1510 msgid "" "Return the full path name of the :file:`Makefile` used to build Python. For " "Unix, this will be a file generated by the :program:`configure` script; the " "meaning for other platforms will vary. The file is a platform-specific text " "file, if it exists. This function is only useful on POSIX platforms." msgstr "" #: ../Doc/distutils/apiref.rst:1515 msgid "" "The following functions are deprecated together with this module and they " "have no direct replacement." msgstr "" #: ../Doc/distutils/apiref.rst:1521 msgid "" "Return the directory for either the general or platform-dependent C include " "files. If *plat_specific* is true, the platform-dependent include directory " "is returned; if false or omitted, the platform-independent directory is " "returned. If *prefix* is given, it is used as either the prefix instead of :" "const:`PREFIX`, or as the exec-prefix instead of :const:`EXEC_PREFIX` if " "*plat_specific* is true." msgstr "" #: ../Doc/distutils/apiref.rst:1531 msgid "" "Return the directory for either the general or platform-dependent library " "installation. If *plat_specific* is true, the platform-dependent include " "directory is returned; if false or omitted, the platform-independent " "directory is returned. If *prefix* is given, it is used as either the " "prefix instead of :const:`PREFIX`, or as the exec-prefix instead of :const:" "`EXEC_PREFIX` if *plat_specific* is true. If *standard_lib* is true, the " "directory for the standard library is returned rather than the directory for " "the installation of third-party extensions." msgstr "" #: ../Doc/distutils/apiref.rst:1540 msgid "" "The following function is only intended for use within the :mod:`distutils` " "package." msgstr "" #: ../Doc/distutils/apiref.rst:1546 msgid "" "Do any platform-specific customization of a :class:`distutils.ccompiler." "CCompiler` instance." msgstr "" #: ../Doc/distutils/apiref.rst:1549 msgid "" "This function is only needed on Unix at this time, but should be called " "consistently to support forward-compatibility. It inserts the information " "that varies across Unix flavors and is stored in Python's :file:`Makefile`. " "This information includes the selected compiler, compiler and linker " "options, and the extension used by the linker for shared objects." msgstr "" #: ../Doc/distutils/apiref.rst:1555 msgid "" "This function is even more special-purpose, and should only be used from " "Python's own build procedures." msgstr "" #: ../Doc/distutils/apiref.rst:1561 msgid "" "Inform the :mod:`distutils.sysconfig` module that it is being used as part " "of the build process for Python. This changes a lot of relative locations " "for files, allowing them to be located in the build area rather than in an " "installed Python." msgstr "" #: ../Doc/distutils/apiref.rst:1568 msgid ":mod:`distutils.text_file` --- The TextFile class" msgstr "" #: ../Doc/distutils/apiref.rst:1574 msgid "" "This module provides the :class:`TextFile` class, which gives an interface " "to text files that (optionally) takes care of stripping comments, ignoring " "blank lines, and joining lines with backslashes." msgstr "" #: ../Doc/distutils/apiref.rst:1581 msgid "" "This class provides a file-like object that takes care of all the things " "you commonly want to do when processing a text file that has some line-by-" "line syntax: strip comments (as long as ``#`` is your comment character), " "skip blank lines, join adjacent lines by escaping the newline (ie. backslash " "at end of line), strip leading and/or trailing whitespace. All of these are " "optional and independently controllable." msgstr "" #: ../Doc/distutils/apiref.rst:1588 msgid "" "The class provides a :meth:`warn` method so you can generate warning " "messages that report physical line number, even if the logical line in " "question spans multiple physical lines. Also provides :meth:`unreadline` " "for implementing line-at-a-time lookahead." msgstr "" #: ../Doc/distutils/apiref.rst:1593 msgid "" ":class:`TextFile` instances are create with either *filename*, *file*, or " "both. :exc:`RuntimeError` is raised if both are ``None``. *filename* should " "be a string, and *file* a file object (or something that provides :meth:" "`readline` and :meth:`close` methods). It is recommended that you supply " "at least *filename*, so that :class:`TextFile` can include it in warning " "messages. If *file* is not supplied, :class:`TextFile` creates its own " "using the :func:`open` built-in function." msgstr "" #: ../Doc/distutils/apiref.rst:1601 msgid "" "The options are all boolean, and affect the values returned by :meth:" "`readline`" msgstr "" #: ../Doc/distutils/apiref.rst:1606 msgid "option name" msgstr "" #: ../Doc/distutils/apiref.rst:1606 msgid "default" msgstr "" #: ../Doc/distutils/apiref.rst:1608 msgid "*strip_comments*" msgstr "" #: ../Doc/distutils/apiref.rst:1608 msgid "" "strip from ``'#'`` to end-of-line, as well as any whitespace leading up to " "the ``'#'``\\ ---unless it is escaped by a backslash" msgstr "" #: ../Doc/distutils/apiref.rst:1608 ../Doc/distutils/apiref.rst:1617 #: ../Doc/distutils/apiref.rst:1622 msgid "true" msgstr "" #: ../Doc/distutils/apiref.rst:1614 msgid "*lstrip_ws*" msgstr "" #: ../Doc/distutils/apiref.rst:1614 msgid "strip leading whitespace from each line before returning it" msgstr "" #: ../Doc/distutils/apiref.rst:1614 ../Doc/distutils/apiref.rst:1632 #: ../Doc/distutils/apiref.rst:1643 msgid "false" msgstr "" #: ../Doc/distutils/apiref.rst:1617 msgid "*rstrip_ws*" msgstr "" #: ../Doc/distutils/apiref.rst:1617 msgid "" "strip trailing whitespace (including line terminator!) from each line before " "returning it." msgstr "" #: ../Doc/distutils/apiref.rst:1622 msgid "*skip_blanks*" msgstr "" #: ../Doc/distutils/apiref.rst:1622 msgid "" "skip lines that are empty \\*after\\* stripping comments and whitespace. " "(If both lstrip_ws and rstrip_ws are false, then some lines may consist of " "solely whitespace: these will \\*not\\* be skipped, even if *skip_blanks* is " "true.)" msgstr "" #: ../Doc/distutils/apiref.rst:1632 msgid "*join_lines*" msgstr "" #: ../Doc/distutils/apiref.rst:1632 msgid "" "if a backslash is the last non-newline character on a line after stripping " "comments and whitespace, join the following line to it to form one logical " "line; if N consecutive lines end with a backslash, then N+1 physical lines " "will be joined to form one logical line." msgstr "" #: ../Doc/distutils/apiref.rst:1643 msgid "*collapse_join*" msgstr "" #: ../Doc/distutils/apiref.rst:1643 msgid "" "strip leading whitespace from lines that are joined to their predecessor; " "only matters if ``(join_lines and not lstrip_ws)``" msgstr "" #: ../Doc/distutils/apiref.rst:1650 msgid "" "Note that since *rstrip_ws* can strip the trailing newline, the semantics " "of :meth:`readline` must differ from those of the built-in file object's :" "meth:`readline` method! In particular, :meth:`readline` returns ``None`` " "for end-of-file: an empty string might just be a blank line (or an all-" "whitespace line), if *rstrip_ws* is true but *skip_blanks* is not." msgstr "" #: ../Doc/distutils/apiref.rst:1659 msgid "" "Open a new file *filename*. This overrides any *file* or *filename* " "constructor arguments." msgstr "" #: ../Doc/distutils/apiref.rst:1665 msgid "" "Close the current file and forget everything we know about it (including the " "filename and the current line number)." msgstr "" #: ../Doc/distutils/apiref.rst:1671 msgid "" "Print (to stderr) a warning message tied to the current logical line in the " "current file. If the current logical line in the file spans multiple " "physical lines, the warning refers to the whole range, such as ``\"lines " "3-5\"``. If *line* is supplied, it overrides the current line number; it " "may be a list or tuple to indicate a range of physical lines, or an integer " "for a single physical line." msgstr "" #: ../Doc/distutils/apiref.rst:1681 msgid "" "Read and return a single logical line from the current file (or from an " "internal buffer if lines have previously been \"unread\" with :meth:" "`unreadline`). If the *join_lines* option is true, this may involve " "reading multiple physical lines concatenated into a single string. Updates " "the current line number, so calling :meth:`warn` after :meth:`readline` " "emits a warning about the physical line(s) just read. Returns ``None`` on " "end-of-file, since the empty string can occur if *rstrip_ws* is true but " "*strip_blanks* is not." msgstr "" #: ../Doc/distutils/apiref.rst:1692 msgid "" "Read and return the list of all logical lines remaining in the current file. " "This updates the current line number to the last line of the file." msgstr "" #: ../Doc/distutils/apiref.rst:1698 msgid "" "Push *line* (a string) onto an internal buffer that will be checked by " "future :meth:`readline` calls. Handy for implementing a parser with line-at-" "a-time lookahead. Note that lines that are \"unread\" with :meth:" "`unreadline` are not subsequently re-cleansed (whitespace stripped, or " "whatever) when read with :meth:`readline`. If multiple calls are made to :" "meth:`unreadline` before a call to :meth:`readline`, the lines will be " "returned most in most recent first order." msgstr "" #: ../Doc/distutils/apiref.rst:1707 msgid ":mod:`distutils.version` --- Version number classes" msgstr "" #: ../Doc/distutils/apiref.rst:1722 msgid ":mod:`distutils.cmd` --- Abstract base class for Distutils commands" msgstr "" #: ../Doc/distutils/apiref.rst:1729 msgid "This module supplies the abstract base class :class:`Command`." msgstr "" #: ../Doc/distutils/apiref.rst:1734 msgid "" "Abstract base class for defining command classes, the \"worker bees\" of the " "Distutils. A useful analogy for command classes is to think of them as " "subroutines with local variables called *options*. The options are declared " "in :meth:`initialize_options` and defined (given their final values) in :" "meth:`finalize_options`, both of which must be defined by every command " "class. The distinction between the two is necessary because option values " "might come from the outside world (command line, config file, ...), and any " "options dependent on other options must be computed after these outside " "influences have been processed --- hence :meth:`finalize_options`. The body " "of the subroutine, where it does all its work based on the values of its " "options, is the :meth:`run` method, which must also be implemented by every " "command class." msgstr "" #: ../Doc/distutils/apiref.rst:1747 msgid "" "The class constructor takes a single argument *dist*, a :class:`~distutils." "core.Distribution` instance." msgstr "" #: ../Doc/distutils/apiref.rst:1752 msgid "Creating a new Distutils command" msgstr "" #: ../Doc/distutils/apiref.rst:1754 msgid "This section outlines the steps to create a new Distutils command." msgstr "" #: ../Doc/distutils/apiref.rst:1756 msgid "" "A new command lives in a module in the :mod:`distutils.command` package. " "There is a sample template in that directory called :file:" "`command_template`. Copy this file to a new module with the same name as " "the new command you're implementing. This module should implement a class " "with the same name as the module (and the command). So, for instance, to " "create the command ``peel_banana`` (so that users can run ``setup.py " "peel_banana``), you'd copy :file:`command_template` to :file:`distutils/" "command/peel_banana.py`, then edit it so that it's implementing the class :" "class:`peel_banana`, a subclass of :class:`distutils.cmd.Command`." msgstr "" #: ../Doc/distutils/apiref.rst:1766 msgid "Subclasses of :class:`Command` must define the following methods." msgstr "" #: ../Doc/distutils/apiref.rst:1770 msgid "" "Set default values for all the options that this command supports. Note " "that these defaults may be overridden by other commands, by the setup " "script, by config files, or by the command-line. Thus, this is not the " "place to code dependencies between options; generally, :meth:" "`initialize_options` implementations are just a bunch of ``self.foo = None`` " "assignments." msgstr "" #: ../Doc/distutils/apiref.rst:1779 msgid "" "Set final values for all the options that this command supports. This is " "always called as late as possible, ie. after any option assignments from " "the command-line or from other commands have been done. Thus, this is the " "place to code option dependencies: if *foo* depends on *bar*, then it is " "safe to set *foo* from *bar* as long as *foo* still has the same value it " "was assigned in :meth:`initialize_options`." msgstr "" #: ../Doc/distutils/apiref.rst:1789 msgid "" "A command's raison d'etre: carry out the action it exists to perform, " "controlled by the options initialized in :meth:`initialize_options`, " "customized by other commands, the setup script, the command-line, and config " "files, and finalized in :meth:`finalize_options`. All terminal output and " "filesystem interaction should be done by :meth:`run`." msgstr "" #: ../Doc/distutils/apiref.rst:1798 msgid "" "*sub_commands* formalizes the notion of a \"family\" of commands, e.g. " "``install`` as the parent with sub-commands ``install_lib``, " "``install_headers``, etc. The parent of a family of commands defines " "*sub_commands* as a class attribute; it's a list of 2-tuples " "``(command_name, predicate)``, with *command_name* a string and *predicate* " "a function, a string or ``None``. *predicate* is a method of the parent " "command that determines whether the corresponding command is applicable in " "the current situation. (E.g. ``install_headers`` is only applicable if we " "have any C header files to install.) If *predicate* is ``None``, that " "command is always applicable." msgstr "" #: ../Doc/distutils/apiref.rst:1809 msgid "" "*sub_commands* is usually defined at the *end* of a class, because " "predicates can be methods of the class, so they must already have been " "defined. The canonical example is the :command:`install` command." msgstr "" #: ../Doc/distutils/apiref.rst:1815 msgid ":mod:`distutils.command` --- Individual Distutils commands" msgstr "" #: ../Doc/distutils/apiref.rst:1826 msgid ":mod:`distutils.command.bdist` --- Build a binary installer" msgstr "" #: ../Doc/distutils/apiref.rst:1836 msgid "" ":mod:`distutils.command.bdist_packager` --- Abstract base class for packagers" msgstr "" #: ../Doc/distutils/apiref.rst:1846 msgid ":mod:`distutils.command.bdist_dumb` --- Build a \"dumb\" installer" msgstr "" #: ../Doc/distutils/apiref.rst:1856 msgid "" ":mod:`distutils.command.bdist_rpm` --- Build a binary distribution as a " "Redhat RPM and SRPM" msgstr "" #: ../Doc/distutils/apiref.rst:1866 msgid ":mod:`distutils.command.sdist` --- Build a source distribution" msgstr "" #: ../Doc/distutils/apiref.rst:1876 msgid ":mod:`distutils.command.build` --- Build all files of a package" msgstr "" #: ../Doc/distutils/apiref.rst:1886 msgid "" ":mod:`distutils.command.build_clib` --- Build any C libraries in a package" msgstr "" #: ../Doc/distutils/apiref.rst:1896 msgid "" ":mod:`distutils.command.build_ext` --- Build any extensions in a package" msgstr "" #: ../Doc/distutils/apiref.rst:1906 msgid "" ":mod:`distutils.command.build_py` --- Build the .py/.pyc files of a package" msgstr "" #: ../Doc/distutils/apiref.rst:1916 msgid "" "Alternative implementation of build_py which also runs the 2to3 conversion " "library on each .py file that is going to be installed. To use this in a " "setup.py file for a distribution that is designed to run with both Python 2." "x and 3.x, add::" msgstr "" #: ../Doc/distutils/apiref.rst:1926 msgid "to your setup.py, and later::" msgstr "" #: ../Doc/distutils/apiref.rst:1930 msgid "to the invocation of setup()." msgstr "" #: ../Doc/distutils/apiref.rst:1934 msgid "" ":mod:`distutils.command.build_scripts` --- Build the scripts of a package" msgstr "" #: ../Doc/distutils/apiref.rst:1944 msgid ":mod:`distutils.command.clean` --- Clean a package build area" msgstr "" #: ../Doc/distutils/apiref.rst:1949 msgid "" "This command removes the temporary files created by :command:`build` and its " "subcommands, like intermediary compiled object files. With the ``--all`` " "option, the complete build directory will be removed." msgstr "" #: ../Doc/distutils/apiref.rst:1953 msgid "" "Extension modules built :ref:`in place ` will " "not be cleaned, as they are not in the build directory." msgstr "" #: ../Doc/distutils/apiref.rst:1958 msgid ":mod:`distutils.command.config` --- Perform package configuration" msgstr "" #: ../Doc/distutils/apiref.rst:1968 msgid ":mod:`distutils.command.install` --- Install a package" msgstr "" #: ../Doc/distutils/apiref.rst:1978 msgid "" ":mod:`distutils.command.install_data` --- Install data files from a package" msgstr "" #: ../Doc/distutils/apiref.rst:1988 msgid "" ":mod:`distutils.command.install_headers` --- Install C/C++ header files from " "a package" msgstr "" #: ../Doc/distutils/apiref.rst:1998 msgid "" ":mod:`distutils.command.install_lib` --- Install library files from a package" msgstr "" #: ../Doc/distutils/apiref.rst:2008 msgid "" ":mod:`distutils.command.install_scripts` --- Install script files from a " "package" msgstr "" #: ../Doc/distutils/apiref.rst:2018 msgid "" ":mod:`distutils.command.register` --- Register a module with the Python " "Package Index" msgstr "" #: ../Doc/distutils/apiref.rst:2024 msgid "" "The ``register`` command registers the package with the Python Package " "Index. This is described in more detail in :pep:`301`." msgstr "" #: ../Doc/distutils/apiref.rst:2031 msgid ":mod:`distutils.command.check` --- Check the meta-data of a package" msgstr "" #: ../Doc/distutils/apiref.rst:2037 msgid "" "The ``check`` command performs some tests on the meta-data of a package. For " "example, it verifies that all required meta-data are provided as the " "arguments passed to the :func:`setup` function." msgstr ""