[gitmo/Class-MOP.git] / mop.h

#ifndef __MOP_H__
#define __MOP_H__

#define PERL_NO_GET_CONTEXT
#include "EXTERN.h"
#include "perl.h"
#include "XSUB.h"

#include "ppport.h"

#define MOP_CALL_BOOT(name)  mop_call_xs(aTHX_ name, cv, mark);

#ifndef XSPROTO
#define XSPROTO(name) XS(name)
#endif

void mop_call_xs (pTHX_ XSPROTO(subaddr), CV *cv, SV **mark);


#define MAKE_KEYSV(name) newSVpvn_share(#name, sizeof(#name)-1, 0U)

XS(mop_xs_simple_accessor);
XS(mop_xs_simple_reader);
XS(mop_xs_simple_writer);
XS(mop_xs_simple_predicate);
XS(mop_xs_simple_predicate_for_metaclass);
XS(mop_xs_simple_clearer);

extern SV *mop_method_metaclass;
extern SV *mop_associated_metaclass;
extern SV *mop_wrap;
extern SV *mop_methods;
extern SV *mop_name;
extern SV *mop_body;
extern SV *mop_package;
extern SV *mop_package_name;
extern SV *mop_package_cache_flag;
extern SV *mop_initialize;
extern SV *mop_can;
extern SV *mop_Class;
extern SV *mop_VERSION;
extern SV *mop_ISA;

UV mop_check_package_cache_flag(pTHX_ HV *stash);
int mop_get_code_info (SV *coderef, char **pkg, char **name);
SV *mop_call0(pTHX_ SV *const self, SV *const method);
SV *mop_call1(pTHX_ SV *const self, SV *const method, SV *const arg1);

#define mop_call0_pvs(o, m)    mop_call0(aTHX_ o, newSVpvs_flags(m, SVs_TEMP))
#define mop_call1_pvs(o, m, a) mop_call1(aTHX_ o, newSVpvs_flags(m, SVs_TEMP), a)

bool mop_is_class_loaded(pTHX_ SV*);
#define is_class_loaded(klass) mop_is_class_loaded(aTHX_ klass)

bool mop_is_instance_of(pTHX_ SV*, SV*);
#define is_instance_of(sv, klass)     mop_is_instance_of(aTHX_ sv, klass)
#define is_instance_of_pvs(sv, klass) mop_is_instance_of(aTHX_ sv, newSVpvs_flags(klass, SVs_TEMP))

typedef enum {
    TYPE_FILTER_NONE,
    TYPE_FILTER_CODE,
    TYPE_FILTER_ARRAY,
    TYPE_FILTER_IO,
    TYPE_FILTER_HASH,
    TYPE_FILTER_SCALAR,
} type_filter_t;

typedef bool (*get_package_symbols_cb_t) (const char *, STRLEN, SV *, void *);

void mop_get_package_symbols(HV *stash, type_filter_t filter, get_package_symbols_cb_t cb, void *ud);
HV  *mop_get_all_package_symbols (HV *stash, type_filter_t filter);


/* Class::MOP Magic stuff */

/* MG: MOP Magic object */

/* All the MOP_mg_* macros require MAGIC* mg for the first argument */

typedef struct {
    SV*  (*create_instance)(pTHX_ HV* const stash);
    bool (*has_slot)       (pTHX_ SV* const mi, SV* const instance);
    SV*  (*get_slot)       (pTHX_ SV* const mi, SV* const instance);
    SV*  (*set_slot)       (pTHX_ SV* const mi, SV* const instance, SV* const value);
    SV*  (*delete_slot)    (pTHX_ SV* const mi, SV* const instance);
    void (*weaken_slot)    (pTHX_ SV* const mi, SV* const instance);
} mop_instance_vtbl;

SV*  mop_instance_create     (pTHX_ HV* const stash);
SV*  mop_instance_slot       (pTHX_ SV* const meta_instance, SV* const attr);
bool mop_instance_has_slot   (pTHX_ SV* const instance, SV* const slot);
SV*  mop_instance_get_slot   (pTHX_ SV* const instance, SV* const slot);
SV*  mop_instance_set_slot   (pTHX_ SV* const instance, SV* const slot, SV* const value);
SV*  mop_instance_delete_slot(pTHX_ SV* const instance, SV* const slot);
void mop_instance_weaken_slot(pTHX_ SV* const instance, SV* const slot);

const mop_instance_vtbl* mop_get_default_instance_vtbl(pTHX);

#define MOP_mg_obj(mg)   ((mg)->mg_obj)
#define MOP_mg_ptr(mg)   ((mg)->mg_ptr)
#define MOP_mg_vtbl(mg)  ((const mop_instance_vtbl*)MOP_mg_ptr(mg))
#define MOP_mg_flags(mg) ((mg)->mg_private)
#define MOP_mg_virtual(mg) ((mg)->mg_virtual)

#define MOP_mg_obj_refcounted_on(mg)    (void)((mg)->mg_flags |= MGf_REFCOUNTED);

#define MOP_mg_create_instance(mg, stash) MOP_mg_vtbl(mg)->create_instance (aTHX_ (stash))
#define MOP_mg_has_slot(mg, o, slot)      MOP_mg_vtbl(mg)->has_slot        (aTHX_ (o), (slot))
#define MOP_mg_get_slot(mg, o, slot)      MOP_mg_vtbl(mg)->get_slot        (aTHX_ (o), (slot))
#define MOP_mg_set_slot(mg, o, slot, v)   MOP_mg_vtbl(mg)->set_slot        (aTHX_ (o), (slot), (v))
#define MOP_mg_delete_slot(mg, o, slot)   MOP_mg_vtbl(mg)->delete_slot     (aTHX_ (o), (slot))
#define MOP_mg_weaken_slot(mg, o, slot)   MOP_mg_vtbl(mg)->weaken_slot     (aTHX_ (o), (slot))

/* Class::MOP::Attribute stuff */

MAGIC* mop_attr_get_mg(pTHX_ SV* const attr);

/* Class::MOP::Method::Accessor stuff */

#define dMOP_self      SV* const self = mop_accessor_get_self(aTHX_ ax, items, cv)
#define dMOP_mg(xsub)  MAGIC* mg      = (MAGIC*)CvXSUBANY(xsub).any_ptr
#define dMOP_METHOD_COMMON  dMOP_self; dMOP_mg(cv)


SV*    mop_accessor_get_self(pTHX_ I32 const ax, I32 const items, CV* const cv);
MAGIC* mop_attr_get_mg(pTHX_ SV* const attr);

CV*    mop_install_accessor(pTHX_ const char* const fq_name, const char* const key, I32 const keylen, XSUBADDR_t const accessor_impl, const mop_instance_vtbl* vtbl);
CV*    mop_instantiate_xs_accessor(pTHX_ SV* const accessor, XSUBADDR_t const accessor_impl, mop_instance_vtbl* const vtbl);

#define INSTALL_SIMPLE_READER(klass, name)                  INSTALL_SIMPLE_READER_WITH_KEY(klass, name, name)
#define INSTALL_SIMPLE_READER_WITH_KEY(klass, name, key)    (void)mop_install_accessor(aTHX_ "Class::MOP::" #klass "::" #name, #key, sizeof(#key)-1, mop_xs_simple_reader, NULL)

#define INSTALL_SIMPLE_WRITER(klass, name)                  INSTALL_SIMPLE_WRITER_WITH_KEY(klass, name, name)
#define INSTALL_SIMPLE_WRITER_WITH_KEY(klass, name, key)    (void)mop_install_accessor(aTHX_ "Class::MOP::" #klass "::" #name, #key, sizeof(#key)-1, mop_xs_simple_writer, NULL)

#define INSTALL_SIMPLE_PREDICATE(klass, name)                INSTALL_SIMPLE_PREDICATE_WITH_KEY(klass, name, name)
#define INSTALL_SIMPLE_PREDICATE_WITH_KEY(klass, name, key) (void)mop_install_accessor(aTHX_ "Class::MOP::" #klass "::has_" #name, #key, sizeof(#key)-1, mop_xs_simple_predicate_for_metaclass, NULL)

#define MOPf_DIE_ON_FAIL 0x01
MAGIC* mop_mg_find(pTHX_ SV* const sv, const MGVTBL* const vtbl, I32 const flags);


#ifdef DEBUGGING
#define MOP_av_at(av, ix)  *mop_av_at_safe(aTHX_ (av) , (ix))
SV** mop_av_at_safe(pTHX_ AV* const mi, I32 const ix);
#else
#define MOP_av_at(av, ix)  AvARRAY(av)[ix]
#endif

#define IsObject(sv) (SvROK(sv) && SvOBJECT(SvRV(sv)))

#define newSVsv_share(sv) mop_newSVsv_share(aTHX_ sv)
SV* mop_newSVsv_share(pTHX_ SV*);

SV* mop_class_of(pTHX_ SV* const sv);

#endif
Commit	Line	Data
d846ade3	1	#ifndef __MOP_H__
	2	#define __MOP_H__
	3
e989c0df	4	#define PERL_NO_GET_CONTEXT
d846ade3	5	#include "EXTERN.h"
	6	#include "perl.h"
	7	#include "XSUB.h"
	8
d846ade3	9	#include "ppport.h"
d846ade3	10
25bcd95c	11	#define MOP_CALL_BOOT(name) mop_call_xs(aTHX_ name, cv, mark);
d846ade3	12
c97ec1de	13	#ifndef XSPROTO
	14	#define XSPROTO(name) XS(name)
	15	#endif
	16
1be56175	17	void mop_call_xs (pTHX_ XSPROTO(subaddr), CV cv, SV *mark);
d846ade3	18
1bc0cb6b	19
	20	#define MAKE_KEYSV(name) newSVpvn_share(#name, sizeof(#name)-1, 0U)
	21
206860b8	22	XS(mop_xs_simple_accessor);
7ec7b950	23	XS(mop_xs_simple_reader);
206860b8	24	XS(mop_xs_simple_writer);
	25	XS(mop_xs_simple_predicate);
	26	XS(mop_xs_simple_predicate_for_metaclass);
	27	XS(mop_xs_simple_clearer);
7ec7b950	28
e1f52a8a	29	extern SV *mop_method_metaclass;
	30	extern SV *mop_associated_metaclass;
	31	extern SV *mop_wrap;
1bc0cb6b	32	extern SV *mop_methods;
	33	extern SV *mop_name;
	34	extern SV *mop_body;
	35	extern SV *mop_package;
	36	extern SV *mop_package_name;
	37	extern SV *mop_package_cache_flag;
87cfe982	38	extern SV *mop_initialize;
	39	extern SV *mop_can;
	40	extern SV *mop_Class;
1bc0cb6b	41	extern SV *mop_VERSION;
1bc0cb6b	42	extern SV *mop_ISA;
d846ade3	43
d846ade3	44	UV mop_check_package_cache_flag(pTHX_ HV *stash);
e1f52a8a	45	int mop_get_code_info (SV coderef, char pkg, char *name);
d846ade3	46	SV mop_call0(pTHX_ SV const self, SV *const method);
e989c0df	47	SV mop_call1(pTHX_ SV const self, SV const method, SV const arg1);
	48
	49	#define mop_call0_pvs(o, m) mop_call0(aTHX_ o, newSVpvs_flags(m, SVs_TEMP))
	50	#define mop_call1_pvs(o, m, a) mop_call1(aTHX_ o, newSVpvs_flags(m, SVs_TEMP), a)
	51
eaca1141	52	bool mop_is_class_loaded(pTHX_ SV*);
eaca1141	53	#define is_class_loaded(klass) mop_is_class_loaded(aTHX_ klass)
d846ade3	54
00370481	55	bool mop_is_instance_of(pTHX_ SV, SV);
	56	#define is_instance_of(sv, klass) mop_is_instance_of(aTHX_ sv, klass)
	57	#define is_instance_of_pvs(sv, klass) mop_is_instance_of(aTHX_ sv, newSVpvs_flags(klass, SVs_TEMP))
	58
d846ade3	59	typedef enum {
	60	TYPE_FILTER_NONE,
	61	TYPE_FILTER_CODE,
	62	TYPE_FILTER_ARRAY,
	63	TYPE_FILTER_IO,
	64	TYPE_FILTER_HASH,
	65	TYPE_FILTER_SCALAR,
	66	} type_filter_t;
	67
	68	typedef bool (get_package_symbols_cb_t) (const char , STRLEN, SV , void );
	69
e1f52a8a	70	void mop_get_package_symbols(HV stash, type_filter_t filter, get_package_symbols_cb_t cb, void ud);
e989c0df	71	HV mop_get_all_package_symbols (HV stash, type_filter_t filter);
	72
	73
acdbc948	74	/* Class::MOP Magic stuff */
e989c0df	75
acdbc948	76	/* MG: MOP Magic object */
d83eddd0	77
d83eddd0	78	/* All the MOP_mg_* macros require MAGIC* mg for the first argument */
d83eddd0	79
e989c0df	80	typedef struct {
87cfe982	81	SV* (create_instance)(pTHX_ HV const stash);
acdbc948	82	bool (has_slot) (pTHX_ SV const mi, SV* const instance);
	83	SV* (get_slot) (pTHX_ SV const mi, SV* const instance);
	84	SV* (set_slot) (pTHX_ SV const mi, SV* const instance, SV* const value);
	85	SV* (delete_slot) (pTHX_ SV const mi, SV* const instance);
	86	void (weaken_slot) (pTHX_ SV const mi, SV* const instance);
e989c0df	87	} mop_instance_vtbl;
e989c0df	88
87cfe982	89	SV* mop_instance_create (pTHX_ HV* const stash);
	90	SV* mop_instance_slot (pTHX_ SV* const meta_instance, SV* const attr);
	91	bool mop_instance_has_slot (pTHX_ SV* const instance, SV* const slot);
	92	SV* mop_instance_get_slot (pTHX_ SV* const instance, SV* const slot);
	93	SV* mop_instance_set_slot (pTHX_ SV* const instance, SV* const slot, SV* const value);
e192207e	94	SV* mop_instance_delete_slot(pTHX_ SV* const instance, SV* const slot);
	95	void mop_instance_weaken_slot(pTHX_ SV* const instance, SV* const slot);
	96
e989c0df	97	const mop_instance_vtbl* mop_get_default_instance_vtbl(pTHX);
e989c0df	98
19b618cb	99	#define MOP_mg_obj(mg) ((mg)->mg_obj)
3ac9bef6	100	#define MOP_mg_ptr(mg) ((mg)->mg_ptr)
3ac9bef6	101	#define MOP_mg_vtbl(mg) ((const mop_instance_vtbl*)MOP_mg_ptr(mg))
d83eddd0	102	#define MOP_mg_flags(mg) ((mg)->mg_private)
22b82ca0	103	#define MOP_mg_virtual(mg) ((mg)->mg_virtual)
d83eddd0	104
3ac9bef6	105	#define MOP_mg_obj_refcounted_on(mg) (void)((mg)->mg_flags \|= MGf_REFCOUNTED);
3ac9bef6	106
19b618cb	107	#define MOP_mg_create_instance(mg, stash) MOP_mg_vtbl(mg)->create_instance (aTHX_ (stash))
87cfe982	108	#define MOP_mg_has_slot(mg, o, slot) MOP_mg_vtbl(mg)->has_slot (aTHX_ (o), (slot))
	109	#define MOP_mg_get_slot(mg, o, slot) MOP_mg_vtbl(mg)->get_slot (aTHX_ (o), (slot))
	110	#define MOP_mg_set_slot(mg, o, slot, v) MOP_mg_vtbl(mg)->set_slot (aTHX_ (o), (slot), (v))
	111	#define MOP_mg_delete_slot(mg, o, slot) MOP_mg_vtbl(mg)->delete_slot (aTHX_ (o), (slot))
	112	#define MOP_mg_weaken_slot(mg, o, slot) MOP_mg_vtbl(mg)->weaken_slot (aTHX_ (o), (slot))
d83eddd0	113
3ac9bef6	114	/* Class::MOP::Attribute stuff */
	115
	116	MAGIC* mop_attr_get_mg(pTHX_ SV* const attr);
e989c0df	117
	118	/* Class::MOP::Method::Accessor stuff */
	119
d83eddd0	120	#define dMOP_self SV* const self = mop_accessor_get_self(aTHX_ ax, items, cv)
	121	#define dMOP_mg(xsub) MAGIC* mg = (MAGIC*)CvXSUBANY(xsub).any_ptr
	122	#define dMOP_METHOD_COMMON dMOP_self; dMOP_mg(cv)
e989c0df	123
	124
	125	SV* mop_accessor_get_self(pTHX_ I32 const ax, I32 const items, CV* const cv);
e192207e	126	MAGIC* mop_attr_get_mg(pTHX_ SV* const attr);
e989c0df	127
22b82ca0	128	CV* mop_install_accessor(pTHX_ const char* const fq_name, const char* const key, I32 const keylen, XSUBADDR_t const accessor_impl, const mop_instance_vtbl* vtbl);
22b82ca0	129	CV* mop_instantiate_xs_accessor(pTHX_ SV* const accessor, XSUBADDR_t const accessor_impl, mop_instance_vtbl* const vtbl);
e989c0df	130
	131	#define INSTALL_SIMPLE_READER(klass, name) INSTALL_SIMPLE_READER_WITH_KEY(klass, name, name)
	132	#define INSTALL_SIMPLE_READER_WITH_KEY(klass, name, key) (void)mop_install_accessor(aTHX_ "Class::MOP::" #klass "::" #name, #key, sizeof(#key)-1, mop_xs_simple_reader, NULL)
	133
	134	#define INSTALL_SIMPLE_WRITER(klass, name) INSTALL_SIMPLE_WRITER_WITH_KEY(klass, name, name)
	135	#define INSTALL_SIMPLE_WRITER_WITH_KEY(klass, name, key) (void)mop_install_accessor(aTHX_ "Class::MOP::" #klass "::" #name, #key, sizeof(#key)-1, mop_xs_simple_writer, NULL)
	136
	137	#define INSTALL_SIMPLE_PREDICATE(klass, name) INSTALL_SIMPLE_PREDICATE_WITH_KEY(klass, name, name)
	138	#define INSTALL_SIMPLE_PREDICATE_WITH_KEY(klass, name, key) (void)mop_install_accessor(aTHX_ "Class::MOP::" #klass "::has_" #name, #key, sizeof(#key)-1, mop_xs_simple_predicate_for_metaclass, NULL)
	139
	140	#define MOPf_DIE_ON_FAIL 0x01
	141	MAGIC* mop_mg_find(pTHX_ SV* const sv, const MGVTBL* const vtbl, I32 const flags);
d846ade3	142
87cfe982	143
	144	#ifdef DEBUGGING
	145	#define MOP_av_at(av, ix) *mop_av_at_safe(aTHX_ (av) , (ix))
	146	SV** mop_av_at_safe(pTHX_ AV* const mi, I32 const ix);
	147	#else
	148	#define MOP_av_at(av, ix) AvARRAY(av)[ix]
	149	#endif
	150
	151	#define IsObject(sv) (SvROK(sv) && SvOBJECT(SvRV(sv)))
	152
	153	#define newSVsv_share(sv) mop_newSVsv_share(aTHX_ sv)
	154	SV* mop_newSVsv_share(pTHX_ SV*);
	155
	156	SV* mop_class_of(pTHX_ SV* const sv);
	157
d846ade3	158	#endif