wings.h

Go to the documentation of this file.

 
#pragma once
#include <stdint.h>
 
#ifdef __cplusplus
extern "C" {
#define WG_DEFAULT_ARG(arg) = arg
#else
#include <stdbool.h>
#define WG_DEFAULT_ARG(arg)
#endif
 
#if defined(_WIN32) && defined(_WINDLL)
#define WG_DLL_EXPORT __declspec(dllexport)
#else
#define WG_DLL_EXPORT
#endif
 
typedef struct Wg_Context Wg_Context;
 
typedef struct Wg_Obj Wg_Obj;
 
typedef int64_t Wg_int;
 
typedef uint64_t Wg_uint;
 
typedef double Wg_float;
 
typedef Wg_Obj* (*Wg_Function)(Wg_Context* context, Wg_Obj** argv, int argc);
 
typedef void (*Wg_Finalizer)(void* userdata);
 
typedef void (*Wg_PrintFunction)(const char* message, int len, void* userdata);
 
typedef void (*Wg_ErrorCallback)(const char* message);
 
typedef bool (*Wg_IterationCallback)(Wg_Obj* obj, void* userdata);
 
typedef bool (*Wg_ModuleLoader)(Wg_Context* context);
 
typedef struct Wg_Config {
    bool enableOSAccess;
    int maxAlloc;
    int maxRecursion;
    float gcRunFactor;
    Wg_PrintFunction print;
    void* printUserdata;
    const char* importPath;
    const char* const* argv;
    int argc;
} Wg_Config;
 
typedef enum Wg_UnOp {
    WG_UOP_POS,
    WG_UOP_NEG,
    WG_UOP_BITNOT,
    WG_UOP_NOT,
    WG_UOP_HASH,
    WG_UOP_LEN,
    WG_UOP_BOOL,
    WG_UOP_INT,
    WG_UOP_FLOAT,
    WG_UOP_STR,
    WG_UOP_REPR,
    WG_UOP_INDEX,
} Wg_UnOp;
 
typedef enum Wg_BinOp {
    WG_BOP_ADD,
    WG_BOP_SUB,
    WG_BOP_MUL,
    WG_BOP_DIV,
    WG_BOP_FLOORDIV,
    WG_BOP_MOD,
    WG_BOP_POW,
    WG_BOP_BITAND,
    WG_BOP_BITOR,
    WG_BOP_BITXOR,
    WG_BOP_AND,
    WG_BOP_OR,
    WG_BOP_SHL,
    WG_BOP_SHR,
    WG_BOP_IN,
    WG_BOP_NOTIN,
    WG_BOP_EQ,
    WG_BOP_NE,
    WG_BOP_LT,
    WG_BOP_LE,
    WG_BOP_GT,
    WG_BOP_GE,
} Wg_BinOp;
 
typedef enum Wg_Exc {
    WG_EXC_BASEEXCEPTION,
    WG_EXC_SYSTEMEXIT,
    WG_EXC_EXCEPTION,
    WG_EXC_STOPITERATION,
    WG_EXC_ARITHMETICERROR,
    WG_EXC_OVERFLOWERROR,
    WG_EXC_ZERODIVISIONERROR,
    WG_EXC_ATTRIBUTEERROR,
    WG_EXC_IMPORTERROR,
    WG_EXC_LOOKUPERROR,
    WG_EXC_INDEXERROR,
    WG_EXC_KEYERROR,
    WG_EXC_MEMORYERROR,
    WG_EXC_NAMEERROR,
    WG_EXC_OSERROR,
    WG_EXC_ISADIRECTORYERROR,
    WG_EXC_RUNTIMEERROR,
    WG_EXC_NOTIMPLEMENTEDERROR,
    WG_EXC_RECURSIONERROR,
    WG_EXC_SYNTAXERROR,
    WG_EXC_TYPEERROR,
    WG_EXC_VALUEERROR,
} Wg_Exc;
 
WG_DLL_EXPORT
Wg_Context* Wg_CreateContext(const Wg_Config* config WG_DEFAULT_ARG(nullptr));
 
WG_DLL_EXPORT
void Wg_DestroyContext(Wg_Context* context);
 
WG_DLL_EXPORT
void Wg_DefaultConfig(Wg_Config* config);
 
WG_DLL_EXPORT
bool Wg_Execute(Wg_Context* context, const char* script, const char* prettyName WG_DEFAULT_ARG(nullptr));
 
WG_DLL_EXPORT
Wg_Obj* Wg_ExecuteExpression(Wg_Context* context, const char* script, const char* prettyName WG_DEFAULT_ARG(nullptr));
 
WG_DLL_EXPORT
Wg_Obj* Wg_Compile(Wg_Context* context, const char* script, const char* prettyName WG_DEFAULT_ARG(nullptr));
 
WG_DLL_EXPORT
Wg_Obj* Wg_CompileExpression(Wg_Context* context, const char* script, const char* prettyName WG_DEFAULT_ARG(nullptr));
 
WG_DLL_EXPORT
void Wg_SetErrorCallback(Wg_ErrorCallback callback);
 
WG_DLL_EXPORT
const char* Wg_GetErrorMessage(Wg_Context* context);
 
WG_DLL_EXPORT
Wg_Obj* Wg_GetException(Wg_Context* context);
 
WG_DLL_EXPORT
void Wg_RaiseException(Wg_Context* context, Wg_Exc type, const char* message WG_DEFAULT_ARG(nullptr));
 
WG_DLL_EXPORT
void Wg_RaiseExceptionClass(Wg_Obj* klass, const char* message WG_DEFAULT_ARG(nullptr));
 
WG_DLL_EXPORT
void Wg_RaiseExceptionObject(Wg_Obj* obj);
 
WG_DLL_EXPORT
void Wg_ReraiseExceptionObject(Wg_Obj* obj);
 
WG_DLL_EXPORT
void Wg_RaiseArgumentCountError(Wg_Context* context, int given, int expected);
 
WG_DLL_EXPORT
void Wg_RaiseArgumentTypeError(Wg_Context* context, int index, const char* expected);
 
WG_DLL_EXPORT
void Wg_RaiseAttributeError(const Wg_Obj* obj, const char* attribute);
 
WG_DLL_EXPORT
void Wg_RaiseKeyError(Wg_Context* context, Wg_Obj* key WG_DEFAULT_ARG(nullptr));
 
WG_DLL_EXPORT
void Wg_RaiseNameError(Wg_Context* context, const char* name);
 
WG_DLL_EXPORT
void Wg_ClearException(Wg_Context* context);
 
WG_DLL_EXPORT
Wg_Context* Wg_GetContextFromObject(Wg_Obj* obj);
 
WG_DLL_EXPORT
Wg_Obj* Wg_IsInstance(const Wg_Obj* instance, Wg_Obj*const* types, int typesLen);
 
WG_DLL_EXPORT
Wg_Obj* Wg_GetGlobal(Wg_Context* context, const char* name);
 
WG_DLL_EXPORT
void Wg_SetGlobal(Wg_Context* context, const char* name, Wg_Obj* value);
 
WG_DLL_EXPORT
void Wg_Print(const Wg_Context* context, const char* message, int len);
 
WG_DLL_EXPORT
void Wg_PrintString(const Wg_Context* context, const char* message);
 
WG_DLL_EXPORT
void Wg_CollectGarbage(Wg_Context* context);
 
WG_DLL_EXPORT
void Wg_IncRef(Wg_Obj* obj);
 
WG_DLL_EXPORT
void Wg_DecRef(Wg_Obj* obj);
 
WG_DLL_EXPORT
Wg_Obj* Wg_None(Wg_Context* context);
 
WG_DLL_EXPORT
Wg_Obj* Wg_NewBool(Wg_Context* context, bool value WG_DEFAULT_ARG(false));
 
WG_DLL_EXPORT
Wg_Obj* Wg_NewInt(Wg_Context* context, Wg_int value WG_DEFAULT_ARG(0));
 
WG_DLL_EXPORT
Wg_Obj* Wg_NewFloat(Wg_Context* context, Wg_float value WG_DEFAULT_ARG(0));
 
WG_DLL_EXPORT
Wg_Obj* Wg_NewString(Wg_Context* context, const char* value WG_DEFAULT_ARG(nullptr));
 
WG_DLL_EXPORT
Wg_Obj* Wg_NewStringBuffer(Wg_Context* context, const char* buffer, int len);
 
WG_DLL_EXPORT
Wg_Obj* Wg_NewTuple(Wg_Context* context, Wg_Obj** argv, int argc);
 
WG_DLL_EXPORT
Wg_Obj* Wg_NewList(Wg_Context* context, Wg_Obj** argv WG_DEFAULT_ARG(nullptr), int argc WG_DEFAULT_ARG(0));
 
WG_DLL_EXPORT
Wg_Obj* Wg_NewDictionary(Wg_Context* context, Wg_Obj** keys WG_DEFAULT_ARG(nullptr), Wg_Obj** values WG_DEFAULT_ARG(nullptr), int len WG_DEFAULT_ARG(0));
 
WG_DLL_EXPORT
Wg_Obj* Wg_NewSet(Wg_Context* context, Wg_Obj** argv WG_DEFAULT_ARG(nullptr), int argc WG_DEFAULT_ARG(0));
 
WG_DLL_EXPORT
Wg_Obj* Wg_NewFunction(Wg_Context* context, Wg_Function fptr, void* userdata, const char* prettyName WG_DEFAULT_ARG(nullptr));
 
WG_DLL_EXPORT
Wg_Obj* Wg_BindMethod(Wg_Obj* klass, const char* name, Wg_Function fptr, void* userdata);
 
WG_DLL_EXPORT
Wg_Obj* Wg_NewClass(Wg_Context* context, const char* name, Wg_Obj** bases, int basesLen);
 
WG_DLL_EXPORT
bool Wg_IsNone(const Wg_Obj* obj);
 
WG_DLL_EXPORT
bool Wg_IsBool(const Wg_Obj* obj);
 
WG_DLL_EXPORT
bool Wg_IsInt(const Wg_Obj* obj);
 
WG_DLL_EXPORT
bool Wg_IsIntOrFloat(const Wg_Obj* obj);
 
WG_DLL_EXPORT
bool Wg_IsString(const Wg_Obj* obj);
 
WG_DLL_EXPORT
bool Wg_IsTuple(const Wg_Obj* obj);
 
WG_DLL_EXPORT
bool Wg_IsList(const Wg_Obj* obj);
 
WG_DLL_EXPORT
bool Wg_IsDictionary(const Wg_Obj* obj);
 
WG_DLL_EXPORT
bool Wg_IsSet(const Wg_Obj* obj);
 
WG_DLL_EXPORT
bool Wg_IsFunction(const Wg_Obj* obj);
 
WG_DLL_EXPORT
bool Wg_IsClass(const Wg_Obj* obj);
 
WG_DLL_EXPORT
bool Wg_GetBool(const Wg_Obj* obj);
 
WG_DLL_EXPORT
Wg_int Wg_GetInt(const Wg_Obj* obj);
 
WG_DLL_EXPORT
Wg_float Wg_GetFloat(const Wg_Obj* obj);
 
WG_DLL_EXPORT
const char* Wg_GetString(const Wg_Obj* obj, int* len WG_DEFAULT_ARG(nullptr));
 
WG_DLL_EXPORT
void Wg_SetUserdata(Wg_Obj* obj, void* userdata);
 
WG_DLL_EXPORT
bool Wg_TryGetUserdata(const Wg_Obj* obj, const char* type, void** userdata);
 
WG_DLL_EXPORT
void Wg_RegisterFinalizer(Wg_Obj* obj, Wg_Finalizer finalizer, void* userdata WG_DEFAULT_ARG(nullptr));
 
WG_DLL_EXPORT
bool Wg_HasAttribute(Wg_Obj* obj, const char* attribute);
 
WG_DLL_EXPORT
Wg_Obj* Wg_GetAttribute(Wg_Obj* obj, const char* attribute);
 
WG_DLL_EXPORT
Wg_Obj* Wg_GetAttributeNoExcept(Wg_Obj* obj, const char* attribute);
 
WG_DLL_EXPORT
void Wg_SetAttribute(Wg_Obj* obj, const char* attribute, Wg_Obj* value);
 
WG_DLL_EXPORT
Wg_Obj* Wg_GetAttributeFromBase(Wg_Obj* obj, const char* attribute, Wg_Obj* baseClass WG_DEFAULT_ARG(nullptr));
 
WG_DLL_EXPORT
bool Wg_Iterate(Wg_Obj* obj, void* userdata, Wg_IterationCallback callback);
 
WG_DLL_EXPORT
bool Wg_Unpack(Wg_Obj* obj, int count, Wg_Obj** values);
 
WG_DLL_EXPORT
Wg_Obj* Wg_GetKwargs(Wg_Context* context);
 
WG_DLL_EXPORT
void* Wg_GetFunctionUserdata(Wg_Context* context);
 
WG_DLL_EXPORT
Wg_Obj* Wg_Call(Wg_Obj* callable, Wg_Obj** argv, int argc, Wg_Obj* kwargs WG_DEFAULT_ARG(nullptr));
 
WG_DLL_EXPORT
Wg_Obj* Wg_CallMethod(Wg_Obj* obj, const char* method, Wg_Obj** argv, int argc, Wg_Obj* kwargs WG_DEFAULT_ARG(nullptr));
 
WG_DLL_EXPORT
Wg_Obj* Wg_CallMethodFromBase(Wg_Obj* obj, const char* method, Wg_Obj** argv, int argc, Wg_Obj* kwargs WG_DEFAULT_ARG(nullptr), Wg_Obj* baseClass WG_DEFAULT_ARG(nullptr));
 
WG_DLL_EXPORT
bool Wg_ParseKwargs(Wg_Obj* dict, const char*const* keys, int keysLen, Wg_Obj** values);
 
WG_DLL_EXPORT
Wg_Obj* Wg_GetIndex(Wg_Obj* obj, Wg_Obj* index);
 
WG_DLL_EXPORT
Wg_Obj* Wg_SetIndex(Wg_Obj* obj, Wg_Obj* index, Wg_Obj* value);
 
WG_DLL_EXPORT
Wg_Obj* Wg_UnaryOp(Wg_UnOp op, Wg_Obj* arg);
 
WG_DLL_EXPORT
Wg_Obj* Wg_BinaryOp(Wg_BinOp op, Wg_Obj* lhs, Wg_Obj* rhs);
 
WG_DLL_EXPORT
void Wg_RegisterModule(Wg_Context* context, const char* name, Wg_ModuleLoader loader);
 
WG_DLL_EXPORT
Wg_Obj* Wg_ImportModule(Wg_Context* context, const char* module, const char* alias WG_DEFAULT_ARG(nullptr));
 
WG_DLL_EXPORT
Wg_Obj* Wg_ImportFromModule(Wg_Context* context, const char* module, const char* name, const char* alias WG_DEFAULT_ARG(nullptr));
 
WG_DLL_EXPORT
bool Wg_ImportAllFromModule(Wg_Context* context, const char* module);
 
#undef WG_DEFAULT_ARG
#undef WG_DLL_EXPORT
 
#ifdef __cplusplus
} // extern "C"
#endif