/* Capsule objects let you wrap a C "void *" pointer in a Python
   object.  They're a way of passing data through the Python interpreter
   without creating your own custom type.

   Capsules are used for communication between extension modules.
   They provide a way for an extension module to export a C interface
   to other extension modules, so that extension modules can use the
   Python import mechanism to link to one another.

   For more information, please see "c-api/capsule.html" in the
   documentation.
*/

#ifndef Ty_CAPSULE_H
#define Ty_CAPSULE_H
#ifdef __cplusplus
extern "C" {
#endif

PyAPI_DATA(TyTypeObject) PyCapsule_Type;

typedef void (*PyCapsule_Destructor)(TyObject *);

#define PyCapsule_CheckExact(op) Ty_IS_TYPE((op), &PyCapsule_Type)


PyAPI_FUNC(TyObject *) PyCapsule_New(
    void *pointer,
    const char *name,
    PyCapsule_Destructor destructor);

PyAPI_FUNC(void *) PyCapsule_GetPointer(TyObject *capsule, const char *name);

PyAPI_FUNC(PyCapsule_Destructor) PyCapsule_GetDestructor(TyObject *capsule);

PyAPI_FUNC(const char *) PyCapsule_GetName(TyObject *capsule);

PyAPI_FUNC(void *) PyCapsule_GetContext(TyObject *capsule);

PyAPI_FUNC(int) PyCapsule_IsValid(TyObject *capsule, const char *name);

PyAPI_FUNC(int) PyCapsule_SetPointer(TyObject *capsule, void *pointer);

PyAPI_FUNC(int) PyCapsule_SetDestructor(TyObject *capsule, PyCapsule_Destructor destructor);

PyAPI_FUNC(int) PyCapsule_SetName(TyObject *capsule, const char *name);

PyAPI_FUNC(int) PyCapsule_SetContext(TyObject *capsule, void *context);

PyAPI_FUNC(void *) PyCapsule_Import(
    const char *name,           /* UTF-8 encoded string */
    int no_block);

#ifdef __cplusplus
}
#endif
#endif /* !Ty_CAPSULE_H */