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