# SOME DESCRIPTIVE TITLE.

# Copyright (C) 2001 Python Software Foundation

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

# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.

#

#, fuzzy

msgid ""

msgstr ""

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

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

"POT-Creation-Date: 2026-09-14 20:17+0000\n"

"PO-Revision-Date: 2025-09-16 00:00+0000\n"

"Language-Team: German (https://app.transifex.com/python-doc/teams/5390/de/)\n"

"Language: de\n"

"MIME-Version: 1.0\n"

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

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

"Plural-Forms: nplurals=2; plural=(n != 1);\n"

#: ../../c-api/module.rst:6

msgid "Module Objects"

msgstr ""

#: ../../c-api/module.rst:14

msgid ""

"This instance of :c:type:`PyTypeObject` represents the Python module type. "

"This is exposed to Python programs as :py:class:`types.ModuleType`."

msgstr ""

#: ../../c-api/module.rst:20

msgid ""

"Return true if *p* is a module object, or a subtype of a module object. This "

"function always succeeds."

msgstr ""

#: ../../c-api/module.rst:26

msgid ""

"Return true if *p* is a module object, but not a subtype of :c:data:"

"`PyModule_Type`. This function always succeeds."

msgstr ""

#: ../../c-api/module.rst:39

msgid ""

"Return a new module object with :attr:`module.__name__` set to *name*. The "

"module's :attr:`!__name__`, :attr:`~module.__doc__`, :attr:`~module."

"__package__` and :attr:`~module.__loader__` attributes are filled in (all "

"but :attr:`!__name__` are set to ``None``). The caller is responsible for "

"setting a :attr:`~module.__file__` attribute."

msgstr ""

#: ../../c-api/module.rst:45 ../../c-api/module.rst:836

#: ../../c-api/module.rst:867

msgid "Return ``NULL`` with an exception set on error."

msgstr ""

#: ../../c-api/module.rst:49

msgid ""

":attr:`~module.__package__` and :attr:`~module.__loader__` are now set to "

"``None``."

msgstr ""

#: ../../c-api/module.rst:56

msgid ""

"Similar to :c:func:`PyModule_NewObject`, but the name is a UTF-8 encoded "

"string instead of a Unicode object."

msgstr ""

#: ../../c-api/module.rst:64

msgid ""

"Return the dictionary object that implements *module*'s namespace; this "

"object is the same as the :attr:`~object.__dict__` attribute of the module "

"object. If *module* is not a module object (or a subtype of a module "

"object), :exc:`SystemError` is raised and ``NULL`` is returned."

msgstr ""

#: ../../c-api/module.rst:69

msgid ""

"It is recommended extensions use other ``PyModule_*`` and ``PyObject_*`` "

"functions rather than directly manipulate a module's :attr:`~object."

"__dict__`."

msgstr ""

#: ../../c-api/module.rst:73

msgid ""

"The returned reference is borrowed from the module; it is valid until the "

"module is destroyed."

msgstr ""

#: ../../c-api/module.rst:83

msgid ""

"Return *module*'s :attr:`~module.__name__` value. If the module does not "

"provide one, or if it is not a string, :exc:`SystemError` is raised and "

"``NULL`` is returned."

msgstr ""

#: ../../c-api/module.rst:92

msgid ""

"Similar to :c:func:`PyModule_GetNameObject` but return the name encoded to "

"``'utf-8'``."

msgstr ""

#: ../../c-api/module.rst:95

msgid ""

"The returned buffer is only valid until the module is renamed or destroyed. "

"Note that Python code may rename a module by setting its :py:attr:`~module."

"__name__` attribute."

msgstr ""

#: ../../c-api/module.rst:101

msgid ""

"Return a pointer to the :c:type:`PyModuleDef` struct from which the module "

"was created, or ``NULL`` if the module wasn't created from a definition."

msgstr ""

#: ../../c-api/module.rst:104

msgid ""

"On error, return ``NULL`` with an exception set. Use :c:func:"

"`PyErr_Occurred` to tell this case apart from a missing :c:type:`!"

"PyModuleDef`."

msgstr ""

#: ../../c-api/module.rst:115

msgid ""

"Return the name of the file from which *module* was loaded using *module*'s :"

"attr:`~module.__file__` attribute. If this is not defined, or if it is not "

"a string, raise :exc:`SystemError` and return ``NULL``; otherwise return a "

"reference to a Unicode object."

msgstr ""

#: ../../c-api/module.rst:125

msgid ""

"Similar to :c:func:`PyModule_GetFilenameObject` but return the filename "

"encoded to 'utf-8'."

msgstr ""

#: ../../c-api/module.rst:128

msgid ""

"The returned buffer is only valid until the module's :py:attr:`~module."

"__file__` attribute is reassigned or the module is destroyed."

msgstr ""

#: ../../c-api/module.rst:131

msgid ""

":c:func:`PyModule_GetFilename` raises :exc:`UnicodeEncodeError` on "

"unencodable filenames, use :c:func:`PyModule_GetFilenameObject` instead."

msgstr ""

#: ../../c-api/module.rst:140

msgid "Module definition"

msgstr ""

#: ../../c-api/module.rst:142

msgid ""

"Modules created using the C API are typically defined using an array of :c:"

"type:`PySlot` structs, which provides a \"description\" of how a module "

"should be created. See :ref:`capi-slots` for more information on slots in "

"general."

msgstr ""

#: ../../c-api/module.rst:149

msgid ""

"Previously, a :c:type:`PyModuleDef` struct was necessary to define modules. "

"The older way of defining modules is still available: consult either the :"

"ref:`pymoduledef` section or earlier versions of this documentation if you "

"plan to support earlier Python versions."

msgstr ""

#: ../../c-api/module.rst:154

msgid ""

"The slots array is usually used to define an extension module's “main” "

"module object (see :ref:`extension-modules` for details). It can also be "

"used to :ref:`create extension modules dynamically <module-from-slots>`."

msgstr ""

#: ../../c-api/module.rst:159

msgid ""

"Unless specified otherwise, the same slot ID may not be repeated in an array "

"of slots."

msgstr ""

#: ../../c-api/module.rst:164

msgid "Metadata slots"

msgstr ""

#: ../../c-api/module.rst:168

msgid ""

":c:member:`Slot ID <PySlot.sl_id>` for the name of the new module, as a NUL-"

"terminated UTF8-encoded ``const char *``."

msgstr ""

#: ../../c-api/module.rst:171

msgid ""

"Note that modules are typically created using a :py:class:`~importlib."

"machinery.ModuleSpec`, and when they are, the name from the spec will be "

"used instead of :c:data:`!Py_mod_name`. However, it is still recommended to "

"include this slot for introspection and debugging purposes."

msgstr ""

#: ../../c-api/module.rst:179

msgid ""

"Use :c:member:`PyModuleDef.m_name` instead to support previous versions."

msgstr ""

#: ../../c-api/module.rst:183

msgid ""

":c:type:`Slot ID <PySlot.sl_id>` for the docstring of the new module, as a "

"NUL-terminated UTF8-encoded ``const char *``."

msgstr ""

#: ../../c-api/module.rst:186

msgid "Usually it is set to a variable created with :c:macro:`PyDoc_STRVAR`."

msgstr ""

#: ../../c-api/module.rst:190

msgid "Use :c:member:`PyModuleDef.m_doc` instead to support previous versions."

msgstr ""

#: ../../c-api/module.rst:194

msgid "Feature slots"

msgstr ""

#: ../../c-api/module.rst:198

msgid ""

":c:member:`Slot ID <PySlot.sl_id>` whose value points to a :c:struct:"

"`PyABIInfo` structure describing the ABI that the extension is using."

msgstr ""

#: ../../c-api/module.rst:202

msgid ""

"A suitable :c:struct:`!PyABIInfo` variable can be defined using the :c:macro:"

"`PyABIInfo_VAR` macro, as in:"

msgstr ""

#: ../../c-api/module.rst:205

msgid ""

"PyABIInfo_VAR(abi_info);\n"

"\n"

"static PySlot mymodule_slots[] = {\n"

" PySlot_DATA(Py_mod_abi, &abi_info),\n"

" ...\n"

"};"

msgstr ""

#: ../../c-api/module.rst:214

msgid ""

"When creating a module, Python checks the value of this slot using :c:func:"

"`PyABIInfo_Check`."

msgstr ""

#: ../../c-api/module.rst:217

msgid ""

"This slot is required, except for modules created from :c:struct:"

"`PyModuleDef`."

msgstr ""

#: ../../c-api/module.rst:224 ../../c-api/module.rst:263

msgid ":c:member:`Slot ID <PySlot.sl_id>` whose value is one of:"

msgstr ""

#: ../../c-api/module.rst:230

msgid "The module does not support being imported in subinterpreters."

msgstr ""

#: ../../c-api/module.rst:234

msgid ""

"The module supports being imported in subinterpreters, but only when they "

"share the main interpreter's GIL. (See :ref:`isolating-extensions-howto`.)"

msgstr ""

#: ../../c-api/module.rst:240

msgid ""

"The module supports being imported in subinterpreters, even when they have "

"their own GIL. (See :ref:`isolating-extensions-howto`.)"

msgstr ""

#: ../../c-api/module.rst:244

msgid ""

"This slot determines whether or not importing this module in a "

"subinterpreter will fail."

msgstr ""

#: ../../c-api/module.rst:247

msgid ""

"If ``Py_mod_multiple_interpreters`` is not specified, the import machinery "

"defaults to ``Py_MOD_MULTIPLE_INTERPRETERS_SUPPORTED``."

msgstr ""

#: ../../c-api/module.rst:250

msgid ""

"For historical reasons, the values are declared as pointers (``void *``). "

"When using :c:type:`PySlot` arrays, use :c:macro:`PySlot_DATA` for :c:macro:"

"`!Py_mod_multiple_interpreters`:"

msgstr ""

#: ../../c-api/module.rst:254

msgid ""

"PySlot_DATA(Py_mod_multiple_interpreters,\n"

" Py_MOD_PER_INTERPRETER_GIL_SUPPORTED)"

msgstr ""

#: ../../c-api/module.rst:269

msgid ""

"The module depends on the presence of the global interpreter lock (GIL), and "

"may access global state without synchronization."

msgstr ""

#: ../../c-api/module.rst:274

msgid "The module is safe to run without an active GIL."

msgstr ""

#: ../../c-api/module.rst:276

msgid ""

"This slot is ignored by Python builds not configured with :option:`--disable-"

"gil`. Otherwise, it determines whether or not importing this module will "

"cause the GIL to be automatically enabled. See :ref:`whatsnew313-free-"

"threaded-cpython` for more detail."

msgstr ""

#: ../../c-api/module.rst:281

msgid ""

"If ``Py_mod_gil`` is not specified, the import machinery defaults to "

"``Py_MOD_GIL_USED``."

msgstr ""

#: ../../c-api/module.rst:284

msgid ""

"For historical reasons, the values are declared as pointers (``void *``). "

"When using :c:type:`PySlot` arrays, use :c:macro:`PySlot_DATA` for :c:macro:"

"`!Py_mod_gil`:"

msgstr ""

#: ../../c-api/module.rst:288

msgid "PySlot_DATA(Py_mod_gil, Py_MOD_GIL_NOT_USED)"

msgstr ""

#: ../../c-api/module.rst:296

msgid "Creation and initialization slots"

msgstr ""

#: ../../c-api/module.rst:300

msgid ""

":c:member:`Slot ID <PySlot.sl_id>` for a function that creates the module "

"object itself. The function must have the signature:"

msgstr ""

#: ../../c-api/module.rst:308

msgid "The function will be called with:"

msgstr ""

#: ../../c-api/module.rst:310

msgid ""

"*spec*: a ``ModuleSpec``-like object, meaning that any attributes defined "

"for :py:class:`importlib.machinery.ModuleSpec` have matching semantics. "

"However, any of the attributes may be missing."

msgstr ""

#: ../../c-api/module.rst:313

msgid ""

"*def*: ``NULL``, or the module definition if the module is created from one."

msgstr ""

#: ../../c-api/module.rst:315

msgid ""

"The function should return a new module object, or set an error and return "

"``NULL``."

msgstr ""

#: ../../c-api/module.rst:318

msgid ""

"This function should be kept minimal. In particular, it should not call "

"arbitrary Python code, as trying to import the same module again may result "

"in an infinite loop."

msgstr ""

#: ../../c-api/module.rst:322

msgid ""

"If ``Py_mod_create`` is not specified, the import machinery will create a "

"normal module object using :c:func:`PyModule_New`. The name is taken from "

"*spec*, not the definition, to allow extension modules to dynamically adjust "

"to their place in the module hierarchy and be imported under different names "

"through symlinks, all while sharing a single module definition."

msgstr ""

#: ../../c-api/module.rst:328

msgid ""

"There is no requirement for the returned object to be an instance of :c:type:"

"`PyModule_Type`. However, some slots may only be used with :c:type:`!"

"PyModule_Type` instances; in particular:"

msgstr ""

#: ../../c-api/module.rst:333

msgid ":c:macro:`Py_mod_exec`,"

msgstr ""

#: ../../c-api/module.rst:334

msgid ""

":ref:`module state slots <ext-module-state-slots>` (``Py_mod_state_*``),"

msgstr ""

#: ../../c-api/module.rst:335

msgid ":c:macro:`Py_mod_token`."

msgstr ""

#: ../../c-api/module.rst:341

msgid ""

"The *slots* argument may be a ``ModuleSpec``-like object, rather than a "

"true :py:class:`~importlib.machinery.ModuleSpec` instance. Note that "

"previous versions of CPython did not enforce this."

msgstr ""

#: ../../c-api/module.rst:345

msgid ""

"The *def* argument may now be ``NULL``, since modules are not necessarily "

"made from definitions."

msgstr ""

#: ../../c-api/module.rst:350

msgid ""

":c:member:`Slot ID <PySlot.sl_id>` for a function that will :dfn:`execute`, "

"or initialize, the module. This function does the equivalent to executing "

"the code of a Python module: typically, it adds classes and constants to the "

"module. The signature of the function is:"

msgstr ""

#: ../../c-api/module.rst:360

msgid ""

"See the :ref:`capi-module-support-functions` section for some useful "

"functions to call."

msgstr ""

#: ../../c-api/module.rst:363

msgid ""

"For backwards compatibility, the :c:type:`PyModuleDef.m_slots` array may "

"contain multiple :c:macro:`!Py_mod_exec` slots; these are processed in the "

"order they appear in the array. Elsewhere (that is, in arguments to :c:func:"

"`PyModule_FromSlotsAndSpec` and in return values of :samp:"

"`PyModExport_{<name>}`), repeating the slot is not allowed."

msgstr ""

#: ../../c-api/module.rst:374

msgid ""

"Repeated ``Py_mod_exec`` slots are disallowed, except in :c:type:"

"`PyModuleDef.m_slots`."

msgstr ""

#: ../../c-api/module.rst:379

msgid ""

":c:member:`Slot ID <PySlot.sl_id>` for a table of module-level functions, as "

"an array of :c:type:`PyMethodDef` values suitable as the *functions* "

"argument to :c:func:`PyModule_AddFunctions`."

msgstr ""

#: ../../c-api/module.rst:383

msgid ""

"Like other slot IDs, a slots array may only contain one :c:macro:`!"

"Py_mod_methods` entry. To add functions from multiple :c:type:`PyMethodDef` "

"arrays, call :c:func:`PyModule_AddFunctions` in the :c:macro:`Py_mod_exec` "

"function."

msgstr ""

#: ../../c-api/module.rst:388

msgid ""

"The table must be statically allocated (or otherwise guaranteed to outlive "

"the module object)."

msgstr ""

#: ../../c-api/module.rst:393

msgid ""

"Use :c:member:`PyModuleDef.m_methods` instead to support previous versions."

msgstr ""

#: ../../c-api/module.rst:398

msgid "Module state"

msgstr ""

#: ../../c-api/module.rst:400

msgid ""

"Extension modules can have *module state* -- a piece of memory that is "

"allocated on module creation, and freed when the module object is "

"deallocated. The module state is specified using :ref:`dedicated slots <ext-"

"module-state-slots>`."

msgstr ""

#: ../../c-api/module.rst:405

msgid ""

"A typical use of module state is storing an exception type -- or indeed "

"*any* type object defined by the module --"

msgstr ""

#: ../../c-api/module.rst:408

msgid ""

"Unlike the module's Python attributes, Python code cannot replace or delete "

"data stored in module state."

msgstr ""

#: ../../c-api/module.rst:411

msgid ""

"Keeping per-module information in attributes and module state, rather than "

"in static globals, makes module objects *isolated* and safer for use in "

"multiple sub-interpreters. It also helps Python do an orderly clean-up when "

"it shuts down."

msgstr ""

#: ../../c-api/module.rst:416

msgid ""

"Extensions that keep references to Python objects as part of module state "

"must implement :c:macro:`Py_mod_state_traverse` and :c:macro:"

"`Py_mod_state_clear` functions to avoid reference leaks."

msgstr ""

#: ../../c-api/module.rst:420

msgid "To retrieve the state from a given module, use the following functions:"

msgstr ""

#: ../../c-api/module.rst:424

msgid ""

"Return the \"state\" of the module, that is, a pointer to the block of "

"memory allocated at module creation time, or ``NULL``. See :c:macro:"

"`Py_mod_state_size`."

msgstr ""

#: ../../c-api/module.rst:428

msgid ""

"On error, return ``NULL`` with an exception set. Use :c:func:"

"`PyErr_Occurred` to tell this case apart from missing module state."

msgstr ""

#: ../../c-api/module.rst:435

msgid ""

"Set *\\*result* to the size of *module*'s state, as specified using :c:macro:"

"`Py_mod_state_size` (or :c:member:`PyModuleDef.m_size`), and return 0."

msgstr ""

#: ../../c-api/module.rst:439

msgid "On error, set *\\*result* to -1, and return -1 with an exception set."

msgstr ""

#: ../../c-api/module.rst:448

msgid "Slots for defining module state"

msgstr ""

#: ../../c-api/module.rst:450

msgid ""

"The following :c:member:`slot IDs <PySlot.sl_id>` are available for "

"defining the module state."

msgstr ""

#: ../../c-api/module.rst:455

msgid ""

":c:member:`Slot ID <PySlot.sl_id>` for the size of the module state, in "

"bytes."

msgstr ""

#: ../../c-api/module.rst:458

msgid ""

"Setting the value to a non-negative value means that the module can be re-"

"initialized and specifies the additional amount of memory it requires for "

"its state."

msgstr ""

#: ../../c-api/module.rst:462

msgid "See :PEP:`3121` for more details."

msgstr ""

#: ../../c-api/module.rst:464

msgid ""

"Use :c:func:`PyModule_GetStateSize` to retrieve the size of a given module."

msgstr ""

#: ../../c-api/module.rst:468

msgid ""

"Use :c:member:`PyModuleDef.m_size` instead to support previous versions."

msgstr ""

#: ../../c-api/module.rst:472

msgid ""

":c:member:`Slot ID <PySlot.sl_id>` for a traversal function to call during "

"GC traversal of the module object."

msgstr ""

#: ../../c-api/module.rst:475

msgid ""

"The signature of the function, and meanings of the arguments, is similar as "

"for :c:member:`PyTypeObject.tp_traverse`:"

msgstr ""

#: ../../c-api/module.rst:482 ../../c-api/module.rst:504

#: ../../c-api/module.rst:532

msgid ""

"This function is not called if the module state was requested but is not "

"allocated yet. This is the case immediately after the module is created and "

"before the module is executed (:c:data:`Py_mod_exec` function). More "

"precisely, this function is not called if the state size (:c:data:"

"`Py_mod_state_size`) is greater than 0 and the module state (as returned by :"

"c:func:`PyModule_GetState`) is ``NULL``."

msgstr ""

#: ../../c-api/module.rst:491

msgid ""

"Use :c:member:`PyModuleDef.m_traverse` instead to support previous versions."

msgstr ""

#: ../../c-api/module.rst:495

msgid ""

":c:member:`Slot ID <PySlot.sl_id>` for a clear function to call during GC "

"clearing of the module object."

msgstr ""

#: ../../c-api/module.rst:498 ../../c-api/module.rst:526

msgid "The signature of the function is:"

msgstr ""

#: ../../c-api/module.rst:511

msgid ""

"Like :c:member:`PyTypeObject.tp_clear`, this function is not *always* called "

"before a module is deallocated. For example, when reference counting is "

"enough to determine that an object is no longer used, the cyclic garbage "

"collector is not involved and the :c:macro:`Py_mod_state_free` function is "

"called directly."

msgstr ""

#: ../../c-api/module.rst:519

msgid ""

"Use :c:member:`PyModuleDef.m_clear` instead to support previous versions."

msgstr ""

#: ../../c-api/module.rst:523

msgid ""

":c:member:`Slot ID <PySlot.sl_id>` for a function to call during "

"deallocation of the module object."

msgstr ""

#: ../../c-api/module.rst:541

msgid ""

"Use :c:member:`PyModuleDef.m_free` instead to support previous versions."

msgstr ""

#: ../../c-api/module.rst:547

msgid "Module token"

msgstr ""

#: ../../c-api/module.rst:549

msgid ""

"Each module may have an associated *token*: a pointer-sized value intended "

"to identify of the module state's memory layout. This means that if you have "

"a module object, but you are not sure if it “belongs” to your extension, you "

"can check using code like this:"

msgstr ""

#: ../../c-api/module.rst:554

msgid ""

"PyObject *module = <the module in question>\n"

"\n"

"void *module_token;\n"

"if (PyModule_GetToken(module, &module_token) < 0) {\n"

" return NULL;\n"

"}\n"

"if (module_token != your_token) {\n"

" PyErr_SetString(PyExc_ValueError, \"unexpected module\")\n"

" return NULL;\n"

"}\n"

"\n"

"// This module's state has the expected memory layout; it's safe to cast\n"

"struct my_state state = (struct my_state*)PyModule_GetState(module)"

msgstr ""

#: ../../c-api/module.rst:570

msgid ""

"A module's token -- and the *your_token* value to use in the above code -- "

"is:"

msgstr ""

#: ../../c-api/module.rst:572

msgid ""

"For modules created with :c:type:`PyModuleDef`: the address of that :c:type:"

"`PyModuleDef`;"

msgstr ""

#: ../../c-api/module.rst:574

msgid ""

"For modules defined with the :c:macro:`Py_mod_token` slot: the value of that "

"slot;"

msgstr ""

#: ../../c-api/module.rst:576

msgid ""

"For modules created from an ``PyModExport_*`` :ref:`export hook <extension-"

"export-hook>`: the slots array that the export hook returned (unless "

"overridden with :c:macro:`Py_mod_token`)."

msgstr ""

#: ../../c-api/module.rst:582

msgid ":c:member:`Slot ID <PySlot.sl_id>` for the module token."

msgstr ""

#: ../../c-api/module.rst:584

msgid ""

"If you use this slot to set the module token (rather than rely on the "

"default), you must ensure that:"

msgstr ""

#: ../../c-api/module.rst:587

msgid ""

"The pointer outlives the class, so it's not reused for something else while "

"the class exists."

msgstr ""

#: ../../c-api/module.rst:589

msgid ""

"It \"belongs\" to the extension module where the class lives, so it will not "

"clash with other extensions."

msgstr ""

#: ../../c-api/module.rst:591

msgid ""

"If the token points to a :c:type:`PyModuleDef` struct, the module should "

"behave as if it was created from that :c:type:`PyModuleDef`. In particular, "

"the module state must have matching layout and semantics."

msgstr ""

#: ../../c-api/module.rst:595

msgid ""

"Modules created from :c:type:`PyModuleDef` always use the address of the :c:"

"type:`PyModuleDef` as the token. This means that :c:macro:`!Py_mod_token` "

"cannot be used in :c:member:`PyModuleDef.m_slots`."

msgstr ""

#: ../../c-api/module.rst:604

msgid "Set *\\*result* to the module token for *module* and return 0."

msgstr ""

#: ../../c-api/module.rst:606

msgid "On error, set *\\*result* to NULL, and return -1 with an exception set."

msgstr ""

#: ../../c-api/module.rst:610

msgid "See also :c:func:`PyType_GetModuleByToken`."

msgstr ""

#: ../../c-api/module.rst:616

msgid "Creating extension modules dynamically"

msgstr ""

#: ../../c-api/module.rst:618

msgid ""

"The following functions may be used to create an extension module "

"dynamically, rather than from an extension's :ref:`export hook <extension-"

"export-hook>`."

msgstr ""

#: ../../c-api/module.rst:623

msgid ""

"Create a new module object, given an array of :ref:`slots "

"<pymoduledef_slot>` and the :py:class:`~importlib.machinery.ModuleSpec` "

"*spec*."

msgstr ""

#: ../../c-api/module.rst:626

msgid ""

"The *slots* argument must point to an array of :c:type:`PySlot` structures, "

"terminated by an entry with slot ID of 0 (typically written as :c:macro:"

"`PySlot_END`). The array must include a :c:data:`Py_mod_abi` entry."

msgstr ""

#: ../../c-api/module.rst:631

msgid ""

"The *spec* argument may be any ``ModuleSpec``-like object, as described in :"

"c:macro:`Py_mod_create` documentation. Currently, the *spec* must have a "

"``name`` attribute."

msgstr ""

#: ../../c-api/module.rst:635

msgid ""

"On success, return the new module. On error, return ``NULL`` with an "

"exception set."

msgstr ""

#: ../../c-api/module.rst:638

msgid ""

"Note that this does not process the module's execution slot (:c:data:"

"`Py_mod_exec`). Both :c:func:`!PyModule_FromSlotsAndSpec` and :c:func:"

"`PyModule_Exec` must be called to fully initialize a module. (See also :ref:"

"`multi-phase-initialization`.)"

msgstr ""

#: ../../c-api/module.rst:648

msgid "Execute the :c:data:`Py_mod_exec` slot(s) of *module*."

msgstr ""

#: ../../c-api/module.rst:650

msgid "On success, return 0. On error, return -1 with an exception set."

msgstr ""

#: ../../c-api/module.rst:653

msgid ""

"For clarity: If *module* has no slots, for example if it uses :ref:`legacy "

"single-phase initialization <single-phase-initialization>`, this function "

"does nothing and returns 0."

msgstr ""

#: ../../c-api/module.rst:664

msgid "Module definition struct"

msgstr ""

#: ../../c-api/module.rst:666

msgid ""

"Traditionally, extension modules were defined using a *module definition* as "

"the “description\" of how a module should be created. Rather than using an "

"array of :ref:`slots <pymoduledef_slot>` directly, the definition has "

"dedicated members for most common functionality, and allows additional slots "

"as an extension mechanism."

msgstr ""

#: ../../c-api/module.rst:672

msgid ""

"This way of defining modules is still available and there are no plans to "

"remove it."

msgstr ""

#: ../../c-api/module.rst:677

msgid ""

"The module definition struct, which holds information needed to create a "

"module object."

msgstr ""

#: ../../c-api/module.rst:680

msgid ""

"This structure must be statically allocated (or be otherwise guaranteed to "

"be valid while any modules created from it exist). Usually, there is only "

"one variable of this type for each extension module defined this way."

msgstr ""

#: ../../c-api/module.rst:685

msgid ""

"The struct, including all members, is part of the :ref:`Stable ABI <stable-"

"abi>` for non-free-threaded builds (``abi3``). In the Stable ABI for free-"

"threaded builds (``abi3t``), this struct is opaque, and unusable in "

"practice; see :ref:`pymoduledef_slot` for a replacement."

msgstr ""

#: ../../c-api/module.rst:693

msgid "Always initialize this member to :c:macro:`PyModuleDef_HEAD_INIT`:"

msgstr ""

#: ../../c-api/module.rst:699

msgid "The type of :c:member:`!PyModuleDef.m_base`."

msgstr ""

#: ../../c-api/module.rst:701

msgid ""

"The struct is part of the :ref:`Stable ABI <stable-abi>` for non-free-"

"threaded builds (``abi3``). In the Stable ABI for Free-Threaded Builds "

"(``abi3t``), this struct is opaque, and unusable in practice."

msgstr ""

#: ../../c-api/module.rst:708

msgid "The required initial value for :c:member:`!PyModuleDef.m_base`."

msgstr ""

#: ../../c-api/module.rst:712

msgid "Corresponds to the :c:macro:`Py_mod_name` slot."

msgstr ""

#: ../../c-api/module.rst:716

msgid ""

"These members correspond to the :c:macro:`Py_mod_doc` slot. Setting this to "

"NULL is equivalent to omitting the slot."

msgstr ""

#: ../../c-api/module.rst:721

msgid ""

"Corresponds to the :c:macro:`Py_mod_state_size` slot. Setting this to zero "

"is equivalent to omitting the slot."

msgstr ""

#: ../../c-api/module.rst:724

msgid ""

"When using :ref:`legacy single-phase initialization <single-phase-"

"initialization>` or when creating modules dynamically using :c:func:"

"`PyModule_Create` or :c:func:`PyModule_Create2`, :c:member:`!m_size` may be "

"set to -1. This indicates that the module does not support sub-interpreters, "

"because it has global state."

msgstr ""

#: ../../c-api/module.rst:732

msgid ""

"Corresponds to the :c:macro:`Py_mod_methods` slot. Setting this to NULL is "

"equivalent to omitting the slot."

msgstr ""

#: ../../c-api/module.rst:737

msgid ""

"An array of additional slots, terminated by a ``{0, NULL}`` entry. Note that "

"the entries use the older :c:type:`PyModuleDef_Slot` structure, rather than :"

"c:type:`PySlot`."

msgstr ""

#: ../../c-api/module.rst:741

msgid ""

"If the array contains slots corresponding to :c:type:`PyModuleDef` members, "

"the values must match. For example, if you use :c:macro:`Py_mod_name` in :c:"

"member:`!m_slots`, :c:member:`PyModuleDef.m_name` must be set to the same "

"pointer (not just an equal string)."

msgstr ""

#: ../../c-api/module.rst:749

msgid ""

"Prior to version 3.5, this member was always set to ``NULL``, and was "

"defined as:"

msgstr ""

#: ../../c-api/module.rst:758

msgid "Older structure defining additional slots of a module."

msgstr ""

#: ../../c-api/module.rst:760

msgid ""

"Note that a :c:type:`!PyModuleDef_Slot` array may be included in a :c:type:`!"

"PySlot` array using :c:macro:`Py_mod_slots`, and vice versa using :c:macro:"

"`Py_slot_subslots`."

msgstr ""

#: ../../c-api/module.rst:764

msgid ""

"Each :c:type:`!PyModuleDef_Slot` structure ``modslot`` is interpreted as the "

"following :c:type:`PySlot` structure::"

msgstr ""

#: ../../c-api/module.rst:767

msgid ""

"(PySlot){\n"

" .sl_id=modslot.slot,\n"

" .sl_flags=PySlot_INTPTR | sub_static,\n"

" .sl_ptr=modslot.value\n"

"}"

msgstr ""

#: ../../c-api/module.rst:773

msgid ""

"where ``sub_static`` is ``PySlot_STATIC`` if the slot requires the flag "

"(such as for :c:macro:`Py_mod_methods`), or if this flag is present on the "

"\"parent\" :c:macro:`!Py_mod_slots` slot (if any)."

msgstr ""

#: ../../c-api/module.rst:779

msgid "Corresponds to :c:member:`PySlot.sl_id`."

msgstr ""

#: ../../c-api/module.rst:783

msgid "Corresponds to :c:member:`PySlot.sl_ptr`."

msgstr ""

#: ../../c-api/module.rst:791

msgid ""

"These members correspond to the :c:macro:`Py_mod_state_traverse`, :c:macro:"

"`Py_mod_state_clear`, and :c:macro:`Py_mod_state_free` slots, respectively."

msgstr ""

#: ../../c-api/module.rst:795

msgid ""

"Setting these members to NULL is equivalent to omitting the corresponding "

"slots."

msgstr ""

#: ../../c-api/module.rst:800

msgid ""

":c:member:`m_traverse`, :c:member:`m_clear` and :c:member:`m_free` functions "

"are no longer called before the module state is allocated."

msgstr ""

#: ../../c-api/module.rst:806

msgid "The type of ``PyModuleDef`` objects."

msgstr ""

#: ../../c-api/module.rst:811

msgid ""

":c:member:`Slot ID <PySlot.sl_id>` that works like :c:macro:"

"`Py_slot_subslots`, except it specifies an array of :c:type:"

"`PyModuleDef_Slot` structures."

msgstr ""

#: ../../c-api/module.rst:819

msgid ""

"The following API can be used to create modules from a :c:type:`!"

"PyModuleDef` struct:"

msgstr ""

#: ../../c-api/module.rst:824

msgid ""

"Create a new module object, given the definition in *def*. This is a macro "

"that calls :c:func:`PyModule_Create2` with *module_api_version* set to :c:"

"macro:`PYTHON_API_VERSION`, or to :c:macro:`PYTHON_ABI_VERSION` if using "

"the :ref:`limited API <limited-c-api>`."

msgstr ""

#: ../../c-api/module.rst:832

msgid ""

"Create a new module object, given the definition in *def*, assuming the API "

"version *module_api_version*. If that version does not match the version of "

"the running interpreter, a :exc:`RuntimeWarning` is emitted."