7.5.2 Module Objects
Keywords: api

##
7.5.2 Module Objects

There are only a few functions special to module objects.

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

int `PyModule_Check` (PyObject *p)
  Returns true if its argument is a module object.

PyObject* `PyModule_New` (char *name)
  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.

PyObject* `PyModule_GetDict` (PyObject *module)
  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.

char* `PyModule_GetName` (PyObject *module)
  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.

char* `PyModule_GetFilename` (PyObject *module)
  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`.

int `PyModule_AddObject` (PyObject *module, char *name, PyObject *value)
  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. Returns `-1` on error, `0` on success. New in version 2.0.

int `PyModule_AddIntConstant` (PyObject *module, char *name, int value)
  Add an integer constant to module as name. This convenience function can be used from the module's initialization function. Returns `-1` on error, `0` on success. New in version 2.0.

int `PyModule_AddStringConstant` (PyObject *module, char *name, char *value)
  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. Returns `-1` on error, `0` on success. New in version 2.0.