1 #define NEED_newSVpvn_flags_GLOBAL
4 /* keywords for methods/keys */
9 SV* mouse_get_attribute;
10 SV* mouse_get_attribute_list;
13 #define MOUSE_xc_flags(a) SvUVX(MOUSE_av_at((a), MOUSE_XC_FLAGS))
14 #define MOUSE_xc_gen(a) MOUSE_av_at((a), MOUSE_XC_GEN)
15 #define MOUSE_xc_stash(a) ( (HV*)MOUSE_av_at((a), MOUSE_XC_STASH) )
16 #define MOUSE_xc_attrall(a) ( (AV*)MOUSE_av_at((a), MOUSE_XC_ATTRALL) )
17 #define MOUSE_xc_buildall(a) ( (AV*)MOUSE_av_at((a), MOUSE_XC_BUILDALL) )
18 #define MOUSE_xc_demolishall(a) ( (AV*)MOUSE_av_at((a), MOUSE_XC_DEMOLISHALL) )
20 enum mouse_xc_flags_t {
21 MOUSEf_XC_IS_IMMUTABLE = 0x0001,
22 MOUSEf_XC_IS_ANON = 0x0002,
23 MOUSEf_XC_HAS_BUILDARGS = 0x0004,
24 MOUSEf_XC_CONSTRUCTOR_IS_STRICT
27 MOUSEf_XC_mask = 0xFFFF /* not used */
30 /* Mouse XS Metaclass object */
34 MOUSE_XC_GEN, /* class generation */
35 MOUSE_XC_STASH, /* symbol table hash */
37 MOUSE_XC_ATTRALL, /* all the attributes */
38 MOUSE_XC_BUILDALL, /* all the BUILD methods */
39 MOUSE_XC_DEMOLISHALL, /* all the DEMOLISH methods */
44 enum mouse_modifier_t {
50 static MGVTBL mouse_xc_vtbl; /* for identity */
53 mouse_class_push_attribute_list(pTHX_ SV* const metaclass, AV* const attrall, HV* const seen){
57 /* $meta->get_attribute_list */
62 n = call_sv(mouse_get_attribute_list, G_ARRAY | G_METHOD);
63 for(NOOP; n > 0; n--){
70 if(hv_exists_ent(seen, name, 0U)){
73 (void)hv_store_ent(seen, name, &PL_sv_undef, 0U);
75 av_push(attrall, newSVsv( mcall1(metaclass, mouse_get_attribute, name) ));
80 mouse_class_has_custom_buildargs(pTHX_ HV* const stash) {
81 XS(XS_Mouse__Object_BUILDARGS); /* prototype */
83 GV* const buildargs = gv_fetchmeth_autoload(stash, "BUILDARGS", sizeof("BUILDARGS")-1, 0);
85 return buildargs && CvXSUB(GvCV(buildargs)) != XS_Mouse__Object_BUILDARGS;
89 mouse_class_update_xc(pTHX_ SV* const metaclass PERL_UNUSED_DECL, HV* const stash, AV* const xc) {
90 AV* const linearized_isa = mro_get_linear_isa(stash);
91 I32 const len = AvFILLp(linearized_isa);
94 AV* const attrall = newAV();
95 AV* const buildall = newAV();
96 AV* const demolishall = newAV();
97 HV* const seen = newHV(); /* for attributes */
102 sv_2mortal((SV*)seen);
104 /* old data will be delete at the end of the perl scope */
105 av_delete(xc, MOUSE_XC_DEMOLISHALL, 0x00);
106 av_delete(xc, MOUSE_XC_BUILDALL, 0x00);
107 av_delete(xc, MOUSE_XC_ATTRALL, 0x00);
109 SvREFCNT_inc_simple_void_NN(linearized_isa);
110 sv_2mortal((SV*)linearized_isa);
114 if(predicate_calls(metaclass, "is_immutable")){
115 flags |= MOUSEf_XC_IS_IMMUTABLE;
118 if(predicate_calls(metaclass, "is_anon_class")){
119 flags |= MOUSEf_XC_IS_ANON;
122 if(mouse_class_has_custom_buildargs(aTHX_ stash)){
123 flags |= MOUSEf_XC_HAS_BUILDARGS;
126 if(predicate_calls(metaclass, "__strict_constructor")){
127 flags |= MOUSEf_XC_CONSTRUCTOR_IS_STRICT;
130 av_store(xc, MOUSE_XC_FLAGS, newSVuv(flags));
131 av_store(xc, MOUSE_XC_ATTRALL, (SV*)attrall);
132 av_store(xc, MOUSE_XC_BUILDALL, (SV*)buildall);
133 av_store(xc, MOUSE_XC_DEMOLISHALL, (SV*)demolishall);
135 for(i = 0; i < len; i++){
136 SV* const klass = MOUSE_av_at(linearized_isa, i);
137 HV* const st = gv_stashsv(klass, TRUE);
141 gv = stash_fetchs(st, "BUILD", FALSE);
143 av_unshift(buildall, 1);
144 av_store(buildall, 0, newRV_inc((SV*)GvCV(gv)));
147 gv = stash_fetchs(st, "DEMOLISH", FALSE);
149 av_push(demolishall, newRV_inc((SV*)GvCV(gv)));
153 meta = get_metaclass(klass);
155 continue; /* skip non-Mouse classes */
158 mouse_class_push_attribute_list(aTHX_ meta, attrall, seen);
164 sv_setuv(MOUSE_xc_gen(xc), mro_get_pkg_gen(stash));
168 mouse_get_xc(pTHX_ SV* const metaclass) {
174 if(!IsObject(metaclass)){
175 croak("Not a Mouse metaclass");
178 mg = mouse_mg_find(aTHX_ SvRV(metaclass), &mouse_xc_vtbl, 0x00);
180 SV* const package = get_slot(metaclass, mouse_package);
182 const char* const pv = SvPV_const(package, len);
184 stash = gv_stashpvn(pv, len, TRUE);
187 mg = sv_magicext(SvRV(metaclass), (SV*)xc, PERL_MAGIC_ext, &mouse_xc_vtbl, pv, len);
188 SvREFCNT_dec(xc); /* refcnt++ in sv_magicext */
190 av_extend(xc, MOUSE_XC_last - 1);
192 av_store(xc, MOUSE_XC_GEN, newSVuv(0U));
193 av_store(xc, MOUSE_XC_STASH, (SV*)stash);
195 SvREFCNT_inc_simple_void_NN(stash);
198 xc = (AV*)MOUSE_mg_obj(mg);
201 assert(SvTYPE(xc) == SVt_PVAV);
204 gen = MOUSE_xc_gen(xc);
206 if(SvUVX(gen) != 0U && MOUSE_xc_flags(xc) & MOUSEf_XC_IS_IMMUTABLE){
210 stash = MOUSE_xc_stash(xc);
212 if(SvUVX(gen) != mro_get_pkg_gen(stash)){
213 mouse_class_update_xc(aTHX_ metaclass, stash, xc);
220 mouse_buildargs(pTHX_ SV* metaclass, SV* const klass, I32 ax, I32 items) {
228 SV* const args_ref = ST(0);
229 if(!IsHashRef(args_ref)){
230 if(!metaclass){ metaclass = get_metaclass(klass); }
231 mouse_throw_error(metaclass, NULL, "Single parameters to new() must be a HASH ref");
233 args = newHVhv((HV*)SvRV(args_ref));
234 sv_2mortal((SV*)args);
239 args = newHV_mortal();
241 if( (items % 2) != 0 ){
242 if(!metaclass){ metaclass = get_metaclass(klass); }
243 mouse_throw_error(metaclass, NULL, "Odd number of parameters to new()");
246 for(i = 0; i < items; i += 2){
247 (void)hv_store_ent(args, ST(i), newSVsv(ST(i+1)), 0U);
255 mouse_report_unknown_args(pTHX_ SV* const meta, AV* const attrs, HV* const args) {
256 HV* const attr_map = newHV_mortal();
257 SV* const unknown = newSVpvs_flags("", SVs_TEMP);
258 I32 const len = AvFILLp(attrs) + 1;
262 for(i = 0; i < len; i++){
263 SV* const attr = MOUSE_av_at(attrs, i);
264 AV* const xa = mouse_get_xa(aTHX_ attr);
265 SV* const init_arg = MOUSE_xa_init_arg(xa);
267 (void)hv_store_ent(attr_map, init_arg, &PL_sv_undef, 0U);
272 while((he = hv_iternext(args))){
273 SV* const key = hv_iterkeysv(he);
274 if(!hv_exists_ent(attr_map, key, 0U)){
275 sv_catpvf(unknown, "%"SVf", ", key);
279 if(SvCUR(unknown) > 0){
280 SvCUR(unknown) -= 2; /* chop "," */
283 sv_setpvs(unknown, "(unknown)");
286 mouse_throw_error(meta, NULL,
287 "Unknown attribute passed to the constructor of %"SVf": %"SVf,
288 mcall0(meta, mouse_name), unknown);
294 mouse_class_initialize_object(pTHX_ SV* const meta, SV* const object, HV* const args, bool const ignore_triggers) {
295 AV* const xc = mouse_get_xc(aTHX_ meta);
296 AV* const attrs = MOUSE_xc_attrall(xc);
297 I32 len = AvFILLp(attrs) + 1;
299 AV* triggers_queue = NULL;
302 assert(meta || object);
304 assert(SvTYPE(args) == SVt_PVHV);
306 if(mg_find((SV*)args, PERL_MAGIC_tied)){
307 croak("You cannot use tied HASH reference as initializing arguments");
310 if(!ignore_triggers){
311 triggers_queue = newAV_mortal();
314 /* for each attribute */
315 for(i = 0; i < len; i++){
316 SV* const attr = MOUSE_av_at(attrs, i);
317 AV* const xa = mouse_get_xa(aTHX_ attr);
319 SV* const slot = MOUSE_xa_slot(xa);
320 U16 const flags = (U16)MOUSE_xa_flags(xa);
321 SV* const init_arg = MOUSE_xa_init_arg(xa);
324 if(SvOK(init_arg) && ( he = hv_fetch_ent(args, init_arg, FALSE, 0U) ) ){
325 SV* value = HeVAL(he);
326 if(flags & MOUSEf_ATTR_HAS_TC){
327 value = mouse_xa_apply_type_constraint(aTHX_ xa, value, flags);
329 value = set_slot(object, slot, value);
330 if(SvROK(value) && flags & MOUSEf_ATTR_IS_WEAK_REF){
331 weaken_slot(object, slot);
333 if(flags & MOUSEf_ATTR_HAS_TRIGGER && triggers_queue){
334 AV* const pair = newAV();
335 av_push(pair, newSVsv( mcall0s(attr, "trigger") ));
336 av_push(pair, newSVsv(value));
338 av_push(triggers_queue, (SV*)pair);
342 else { /* no init arg */
343 if(flags & (MOUSEf_ATTR_HAS_DEFAULT | MOUSEf_ATTR_HAS_BUILDER)){
344 if(!(flags & MOUSEf_ATTR_IS_LAZY)){
345 mouse_xa_set_default(aTHX_ xa, object);
348 else if(flags & MOUSEf_ATTR_IS_REQUIRED) {
349 mouse_throw_error(attr, NULL, "Attribute (%"SVf") is required", slot);
352 } /* for each attribute */
354 if(MOUSE_xc_flags(xc) & MOUSEf_XC_CONSTRUCTOR_IS_STRICT && used < HvUSEDKEYS(args)){
355 mouse_report_unknown_args(aTHX_ meta, attrs, args);
359 len = AvFILLp(triggers_queue) + 1;
360 for(i = 0; i < len; i++){
361 AV* const pair = (AV*)AvARRAY(triggers_queue)[i];
362 SV* const trigger = AvARRAY(pair)[0];
363 SV* const value = AvARRAY(pair)[1];
365 mcall1(object, trigger, value);
369 if(MOUSE_xc_flags(xc) & MOUSEf_XC_IS_ANON){
370 (void)set_slot(object, newSVpvs_flags("__METACLASS__", SVs_TEMP), meta);
376 mouse_initialize_metaclass(pTHX_ SV* const klass) {
377 SV* meta = get_metaclass(klass);
384 mPUSHp("Mouse::Meta::Class", sizeof("Mouse::Meta::Class")-1);
388 call_method("initialize", G_SCALAR);
398 mouse_buildall(pTHX_ AV* const xc, SV* const object, SV* const args) {
399 AV* const buildall = MOUSE_xc_buildall(xc);
400 I32 const len = AvFILLp(buildall) + 1;
402 for(i = 0; i < len; i++){
411 call_sv(AvARRAY(buildall)[i], G_VOID);
413 /* discard a scalar which G_VOID returns */
421 mouse_get_modifier_storage(pTHX_
423 enum mouse_modifier_t const m, SV* const name) {
424 static const char* const keys[] = {
429 SV* const key = sv_2mortal(Perl_newSVpvf(aTHX_ "%s_method_modifiers", keys[m]));
433 must_defined(name, "a method name");
435 table = get_slot(meta, key);
438 /* $meta->{$key} = {} */
439 table = sv_2mortal(newRV_noinc((SV*)newHV()));
440 set_slot(meta, key, table);
443 storage_ref = get_slot(table, name);
446 storage_ref = sv_2mortal(newRV_noinc((SV*)newAV()));
447 set_slot(table, name, storage_ref);
450 if(!IsArrayRef(storage_ref)){
451 croak("Modifier strorage for '%s' is not an ARRAY reference", keys[m]);
455 return (AV*)SvRV(storage_ref);
458 MODULE = Mouse PACKAGE = Mouse
463 mouse_package = newSVpvs_share("package");
464 mouse_namespace = newSVpvs_share("namespace");
465 mouse_methods = newSVpvs_share("methods");
466 mouse_name = newSVpvs_share("name");
467 mouse_coerce = newSVpvs_share("coerce");
469 mouse_get_attribute = newSVpvs_share("get_attribute");
470 mouse_get_attribute_list = newSVpvs_share("get_attribute_list");
472 MOUSE_CALL_BOOT(Mouse__Util);
473 MOUSE_CALL_BOOT(Mouse__Util__TypeConstraints);
474 MOUSE_CALL_BOOT(Mouse__Meta__Method__Accessor__XS);
475 MOUSE_CALL_BOOT(Mouse__Meta__Attribute);
478 MODULE = Mouse PACKAGE = Mouse::Meta::Module
481 INSTALL_SIMPLE_READER_WITH_KEY(Module, name, package);
482 INSTALL_SIMPLE_READER_WITH_KEY(Module, _method_map, methods);
483 INSTALL_SIMPLE_READER_WITH_KEY(Module, _attribute_map, attributes);
489 SV* const package = get_slot(self, mouse_package);
490 if(!(package && SvOK(package))){
491 croak("No package name defined");
493 RETVAL = gv_stashsv(package, GV_ADDMULTI);
498 # ignore extra arguments for extensibility
500 add_method(SV* self, SV* name, SV* code, ...)
503 SV* const package = get_slot(self, mouse_package); /* $self->{package} */
504 SV* const methods = get_slot(self, mouse_methods); /* $self->{methods} */
508 if(!(package && SvOK(package))){
509 croak("No package name defined");
512 must_defined(name, "a method name");
513 must_ref (code, "a CODE reference", SVt_NULL); /* any reftype is OK */
516 if(SvTYPE(SvRV(code_ref)) != SVt_PVCV){
517 SV* sv = code_ref; /* used in tryAMAGICunDEREF */
518 SV** sp = &sv; /* used in tryAMAGICunDEREF */
519 tryAMAGICunDEREF(to_cv); /* try \&{$code} */
520 must_ref(code, "a CODE reference", SVt_PVCV);
524 /* *{$package . '::' . $name} -> *gv */
525 gv = gv_fetchpv(form("%"SVf"::%"SVf, package, name), GV_ADDMULTI, SVt_PVCV);
526 mouse_install_sub(aTHX_ gv, code_ref);
527 (void)set_slot(methods, name, code); /* $self->{methods}{$name} = $code */
530 MODULE = Mouse PACKAGE = Mouse::Meta::Class
533 INSTALL_SIMPLE_READER(Class, roles);
534 INSTALL_SIMPLE_PREDICATE_WITH_KEY(Class, is_anon_class, anon_serial_id);
535 INSTALL_SIMPLE_READER(Class, is_immutable);
536 INSTALL_SIMPLE_READER_WITH_KEY(Class, __strict_constructor, strict_constructor);
538 INSTALL_CLASS_HOLDER(Class, method_metaclass, "Mouse::Meta::Method");
539 INSTALL_CLASS_HOLDER(Class, attribute_metaclass, "Mouse::Meta::Attribute");
540 INSTALL_CLASS_HOLDER(Class, constructor_class, "Mouse::Meta::Method::Constructor::XS");
541 INSTALL_CLASS_HOLDER(Class, destructor_class, "Mouse::Meta::Method::Destructor::XS");
543 newCONSTSUB(gv_stashpvs("Mouse::Meta::Method::Constructor::XS", TRUE), "_generate_constructor",
544 newRV_inc((SV*)get_cvs("Mouse::Object::new", TRUE)));
545 newCONSTSUB(gv_stashpvs("Mouse::Meta::Method::Destructor::XS", TRUE), "_generate_destructor",
546 newRV_inc((SV*)get_cvs("Mouse::Object::DESTROY", TRUE)));
550 linearized_isa(SV* self)
553 SV* const stash_ref = mcall0(self, mouse_namespace); /* $self->namespace */
557 if(!(SvROK(stash_ref) && SvTYPE(SvRV(stash_ref)) == SVt_PVHV)){
558 croak("namespace() didn't return a HASH reference");
560 linearized_isa = mro_get_linear_isa((HV*)SvRV(stash_ref));
561 len = AvFILLp(linearized_isa) + 1;
563 for(i = 0; i < len; i++){
564 PUSHs(AvARRAY(linearized_isa)[i]);
569 get_all_attributes(SV* self)
572 AV* const xc = mouse_get_xc(aTHX_ self);
573 AV* const all_attrs = MOUSE_xc_attrall(xc);
574 I32 const len = AvFILLp(all_attrs) + 1;
578 for(i = 0; i < len; i++){
579 PUSHs( MOUSE_av_at(all_attrs, i) );
584 new_object(SV* meta, ...)
587 AV* const xc = mouse_get_xc(aTHX_ meta);
588 HV* const args = mouse_buildargs(aTHX_ meta, NULL, ax, items);
590 RETVAL = mouse_instance_create(aTHX_ MOUSE_xc_stash(xc));
591 mouse_class_initialize_object(aTHX_ meta, RETVAL, args, FALSE);
597 _initialize_object(SV* meta, SV* object, HV* args, bool ignore_triggers = FALSE)
600 mouse_class_initialize_object(aTHX_ meta, object, args, ignore_triggers);
603 MODULE = Mouse PACKAGE = Mouse::Meta::Role
606 INSTALL_SIMPLE_READER_WITH_KEY(Role, get_roles, roles);
607 INSTALL_SIMPLE_PREDICATE_WITH_KEY(Role, is_anon_role, anon_serial_id);
609 INSTALL_CLASS_HOLDER(Role, method_metaclass, "Mouse::Meta::Role::Method");
612 add_before_modifier(SV* self, SV* name, SV* modifier)
615 av_push(mouse_get_modifier_storage(aTHX_ self, ix, name), newSVsv(modifier));
618 add_before_method_modifier = MOUSE_M_BEFORE
619 add_around_method_modifier = MOUSE_M_AROUND
620 add_after_method_modifier = MOUSE_M_AFTER
623 get_before_modifiers(SV* self, SV* name)
625 get_before_method_modifiers = MOUSE_M_BEFORE
626 get_around_method_modifiers = MOUSE_M_AROUND
627 get_after_method_modifiers = MOUSE_M_AFTER
630 AV* const storage = mouse_get_modifier_storage(aTHX_ self, ix, name);
631 I32 const len = av_len(storage) + 1;
632 if(GIMME_V == G_ARRAY) {
635 for(i = 0; i < len; i++){
636 PUSHs(*av_fetch(storage, i, TRUE));
644 MODULE = Mouse PACKAGE = Mouse::Object
650 SV* const meta = mouse_initialize_metaclass(aTHX_ klass);
651 AV* const xc = mouse_get_xc(aTHX_ meta);
652 UV const flags = MOUSE_xc_flags(xc);
656 if(flags & MOUSEf_XC_HAS_BUILDARGS){
662 for(i = 0; i < items; i++){
667 call_method("BUILDARGS", G_SCALAR);
672 if(!IsHashRef(args)){
673 croak("BUILDARGS did not return a HASH reference");
677 args = newRV_inc((SV*)mouse_buildargs(aTHX_ meta, klass, ax, items));
682 RETVAL = mouse_instance_create(aTHX_ MOUSE_xc_stash(xc));
683 mouse_class_initialize_object(aTHX_ meta, RETVAL, (HV*)SvRV(args), FALSE);
685 mouse_buildall(aTHX_ xc, RETVAL, args);
697 SV* const meta = get_metaclass(object);
701 if(!IsObject(object)){
702 croak("You must not call %s as a class method",
703 ix == 0 ? "DESTROY" : "DEMOLISHALL");
707 AV* const xc = mouse_get_xc(aTHX_ meta);
709 demolishall = MOUSE_xc_demolishall(xc);
711 else { /* The metaclass is already destroyed */
712 AV* const linearized_isa = mro_get_linear_isa(SvSTASH(SvRV(object)));
714 len = AvFILLp(linearized_isa) + 1;
716 demolishall = newAV_mortal();
717 for(i = 0; i < len; i++){
718 SV* const klass = MOUSE_av_at(linearized_isa, i);
719 HV* const st = gv_stashsv(klass, TRUE);
720 GV* const gv = stash_fetchs(st, "DEMOLISH", FALSE);
722 av_push(demolishall, newRV_inc((SV*)GvCV(gv)));
727 len = AvFILLp(demolishall) + 1;
729 GV* const statusvalue = gv_fetchpvs("?", 0, SVt_PV);
731 if(statusvalue){ /* it can be NULL */
732 SAVESPTR(GvSV(statusvalue)); /* local $? */
733 GvSV(statusvalue) = sv_newmortal();
735 SAVESPTR(ERRSV); /* local $@ */
736 ERRSV = newSVpvs_flags("", SVs_TEMP);
738 for(i = 0; i < len; i++){
743 XPUSHs(boolSV(PL_dirty));
746 call_sv(AvARRAY(demolishall)[i], G_VOID | G_EVAL);
748 /* discard a scalar which G_VOID returns */
754 SV* const e = newSVsv(ERRSV);
761 croak(NULL); /* rethrow */
768 BUILDARGS(SV* klass, ...)
771 RETVAL = mouse_buildargs(aTHX_ NULL, klass, ax, items);
778 BUILDALL(SV* self, SV* args)
781 SV* const meta = get_metaclass(self);
782 AV* const xc = mouse_get_xc(aTHX_ meta);
784 must_ref(args, "a HASH reference to BUILDALL", SVt_PVHV);
785 mouse_buildall(aTHX_ xc, self, args);