7.5.5 Module Objects

Python 2.5

7.5.5 Module Objects

There are only a few functions special to module objects.

This instance of PyTypeObject represents the Python module type. This is exposed to Python programs as types.ModuleType.

Return true if p is a module object, or a subtype of a module object. Changed in version 2.2: Allowed subtypes to be accepted.

Return true if p is a module object, but not a subtype of PyModule_Type. New in version 2.2.

Return value: New reference.
Return a new module object with the __name__ attribute set to name. Only the module's __doc__ and __name__ attributes are filled in; the caller is responsible for providing a __file__ attribute.

Return value: Borrowed reference.
Return the dictionary object that implements module's namespace; this object is the same as the __dict__ attribute of the module object. This function never fails. It is recommended extensions use other PyModule_*() and PyObject_*() functions rather than directly manipulate a module's __dict__.

Return module's __name__ value. If the module does not provide one, or if it is not a string, SystemError is raised and NULL is returned.

Return the name of the file from which module was loaded using module's __file__ attribute. If this is not defined, or if it is not a string, raise SystemError and return NULL.

Add an object to module as name. This is a convenience function which can be used from the module's initialization function. This steals a reference to value. Return -1 on error, 0 on success. New in version 2.0.

Add an integer constant to module as name. This convenience function can be used from the module's initialization function. Return -1 on error, 0 on success. New in version 2.0.

Add a string constant to module as name. This convenience function can be used from the module's initialization function. The string value must be null-terminated. Return -1 on error, 0 on success. New in version 2.0.

See About this document... for information on suggesting changes.