xs-src/Mouse.xs

   1 #define  NEED_newSVpvn_flags_GLOBAL
   2 #include "mouse.h"
   3
   4 SV* mouse_package;
   5 SV* mouse_namespace;
   6 SV* mouse_methods;
   7 SV* mouse_name;
   8 SV* mouse_get_attribute;
   9 SV* mouse_get_attribute_list;
  10
  11 #define MOUSE_xc_flags(a)       SvUVX(MOUSE_av_at((a), MOUSE_XC_FLAGS))
  12 #define MOUSE_xc_gen(a)         MOUSE_av_at((a), MOUSE_XC_GEN)
  13 #define MOUSE_xc_stash(a)       ( (HV*)MOUSE_av_at((a), MOUSE_XC_STASH) )
  14 #define MOUSE_xc_attrall(a)     ( (AV*)MOUSE_av_at((a), MOUSE_XC_ATTRALL) )
  15 #define MOUSE_xc_buildall(a)    ( (AV*)MOUSE_av_at((a), MOUSE_XC_BUILDALL) )
  16 #define MOUSE_xc_demolishall(a) ( (AV*)MOUSE_av_at((a), MOUSE_XC_DEMOLISHALL) )
  17
  18 enum mouse_xc_flags_t {
  19     MOUSEf_XC_IS_IMMUTABLE   = 0x0001,
  20     MOUSEf_XC_IS_ANON        = 0x0002,
  21     MOUSEf_XC_HAS_BUILDARGS  = 0x0004,
  22
  23     MOUSEf_XC_HAS_STRICT_CONSTRUCTOR
  24                              = 0x0008,
  25
  26     MOUSEf_XC_mask           = 0xFFFF /* not used */
  27 };
  28
  29 /* Mouse XS Metaclass object */
  30 enum mouse_xc_ix_t{
  31     MOUSE_XC_FLAGS,
  32
  33     MOUSE_XC_GEN,          /* class generation */
  34     MOUSE_XC_STASH,        /* symbol table hash */
  35
  36     MOUSE_XC_ATTRALL,      /* all the attributes */
  37     MOUSE_XC_BUILDALL,     /* all the BUILD methods */
  38     MOUSE_XC_DEMOLISHALL,  /* all the DEMOLISH methods */
  39
  40     MOUSE_XC_last
  41 };
  42
  43 static MGVTBL mouse_xc_vtbl; /* for identity */
  44
  45 static void
  46 mouse_class_push_attribute_list(pTHX_ SV* const metaclass, AV* const attrall, HV* const seen){
  47     dSP;
  48     I32 n;
  49
  50     /* $meta->get_attribute_list */
  51     PUSHMARK(SP);
  52     XPUSHs(metaclass);
  53     PUTBACK;
  54
  55     n = call_sv(mouse_get_attribute_list, G_ARRAY | G_METHOD);
  56     for(NOOP; n > 0; n--){
  57         SV* name;
  58
  59         SPAGAIN;
  60         name = POPs;
  61         PUTBACK;
  62
  63         if(hv_exists_ent(seen, name, 0U)){
  64             continue;
  65         }
  66         (void)hv_store_ent(seen, name, &PL_sv_undef, 0U);
  67
  68         av_push(attrall, newSVsv( mcall1(metaclass, mouse_get_attribute, name) ));
  69     }
  70 }
  71
  72 static int
  73 mouse_class_has_custom_buildargs(pTHX_ HV* const stash) {
  74     XS(XS_Mouse__Object_BUILDARGS); /* prototype */
  75
  76     GV* const buildargs = gv_fetchmeth_autoload(stash, "BUILDARGS", sizeof("BUILDARGS")-1, 0);
  77
  78     return buildargs && CvXSUB(GvCV(buildargs)) != XS_Mouse__Object_BUILDARGS;
  79 }
  80
  81 static void
  82 mouse_class_update_xc(pTHX_ SV* const metaclass PERL_UNUSED_DECL, HV* const stash, AV* const xc) {
  83     AV* const linearized_isa = mro_get_linear_isa(stash);
  84     I32 const len            = AvFILLp(linearized_isa);
  85     I32 i;
  86     U32 flags             = 0x00;
  87     AV* const attrall     = newAV();
  88     AV* const buildall    = newAV();
  89     AV* const demolishall = newAV();
  90     HV* const seen        = newHV(); /* for attributes */
  91
  92     ENTER;
  93     SAVETMPS;
  94
  95     sv_2mortal((SV*)seen);
  96
  97      /* old data will be delete at the end of the perl scope */
  98     av_delete(xc, MOUSE_XC_DEMOLISHALL, 0x00);
  99     av_delete(xc, MOUSE_XC_BUILDALL,    0x00);
 100     av_delete(xc, MOUSE_XC_ATTRALL,     0x00);
 101
 102     SvREFCNT_inc_simple_void_NN(linearized_isa);
 103     sv_2mortal((SV*)linearized_isa);
 104
 105     /* update */
 106
 107     if(predicate_calls(metaclass, "is_immutable")){
 108         flags |= MOUSEf_XC_IS_IMMUTABLE;
 109     }
 110
 111     if(predicate_calls(metaclass, "is_anon_class")){
 112         flags |= MOUSEf_XC_IS_ANON;
 113     }
 114
 115     if(mouse_class_has_custom_buildargs(aTHX_ stash)){
 116         flags |= MOUSEf_XC_HAS_BUILDARGS;
 117     }
 118
 119     if(predicate_calls(metaclass, "_has_strict_constructor")){
 120         flags |= MOUSEf_XC_HAS_STRICT_CONSTRUCTOR;
 121     }
 122
 123     av_store(xc, MOUSE_XC_FLAGS,       newSVuv(flags));
 124     av_store(xc, MOUSE_XC_ATTRALL,     (SV*)attrall);
 125     av_store(xc, MOUSE_XC_BUILDALL,    (SV*)buildall);
 126     av_store(xc, MOUSE_XC_DEMOLISHALL, (SV*)demolishall);
 127
 128     for(i = 0; i < len; i++){
 129         SV* const klass = MOUSE_av_at(linearized_isa, i);
 130         HV* const st    = gv_stashsv(klass, TRUE);
 131         SV* meta;
 132         GV* gv;
 133
 134         gv = stash_fetchs(st, "BUILD", FALSE);
 135         if(gv && GvCVu(gv)){
 136             av_unshift(buildall, 1);
 137             av_store(buildall, 0, newRV_inc((SV*)GvCV(gv)));
 138         }
 139
 140         gv = stash_fetchs(st, "DEMOLISH", FALSE);
 141         if(gv && GvCVu(gv)){
 142             av_push(demolishall, newRV_inc((SV*)GvCV(gv)));
 143         }
 144
 145         /* ATTRIBUTES */
 146         meta = get_metaclass(klass);
 147         if(!SvOK(meta)){
 148             continue; /* skip non-Mouse classes */
 149         }
 150
 151         mouse_class_push_attribute_list(aTHX_ meta, attrall, seen);
 152     }
 153
 154     FREETMPS;
 155     LEAVE;
 156
 157     sv_setuv(MOUSE_xc_gen(xc), mro_get_pkg_gen(stash));
 158 }
 159
 160 static AV*
 161 mouse_get_xc(pTHX_ SV* const metaclass) {
 162     AV* xc;
 163     SV* gen;
 164     HV* stash;
 165     MAGIC* mg;
 166
 167     if(!IsObject(metaclass)){
 168         croak("Not a Mouse metaclass");
 169     }
 170
 171     mg = mouse_mg_find(aTHX_ SvRV(metaclass), &mouse_xc_vtbl, 0x00);
 172     if(!mg){
 173         SV* const package = get_slot(metaclass, mouse_package);
 174         STRLEN len;
 175         const char* const pv = SvPV_const(package, len);
 176
 177         stash = gv_stashpvn(pv, len, TRUE);
 178         xc    = newAV();
 179
 180         mg = sv_magicext(SvRV(metaclass), (SV*)xc, PERL_MAGIC_ext, &mouse_xc_vtbl, pv, len);
 181         SvREFCNT_dec(xc); /* refcnt++ in sv_magicext */
 182
 183         av_extend(xc, MOUSE_XC_last - 1);
 184
 185         av_store(xc, MOUSE_XC_GEN, newSVuv(0U));
 186         av_store(xc, MOUSE_XC_STASH, (SV*)stash);
 187
 188         SvREFCNT_inc_simple_void_NN(stash);
 189     }
 190     else{
 191         xc    = (AV*)MOUSE_mg_obj(mg);
 192
 193         assert(xc);
 194         assert(SvTYPE(xc) == SVt_PVAV);
 195     }
 196
 197     gen   = MOUSE_xc_gen(xc);
 198
 199     if(SvUVX(gen) != 0U && MOUSE_xc_flags(xc) & MOUSEf_XC_IS_IMMUTABLE){
 200         return xc;
 201     }
 202
 203     stash = MOUSE_xc_stash(xc);
 204
 205     if(SvUVX(gen) != mro_get_pkg_gen(stash)){
 206         mouse_class_update_xc(aTHX_ metaclass, stash, xc);
 207     }
 208
 209     return xc;
 210 }
 211
 212 static HV*
 213 mouse_buildargs(pTHX_ SV* metaclass, SV* const klass, I32 ax, I32 items) {
 214     HV* args;
 215
 216     /* shift @_ */
 217     ax++;
 218     items--;
 219
 220     if(items == 1){
 221         SV* const args_ref = ST(0);
 222         if(!IsHashRef(args_ref)){
 223             if(!metaclass){ metaclass = get_metaclass(klass); }
 224             mouse_throw_error(metaclass, NULL, "Single parameters to new() must be a HASH ref");
 225         }
 226         args = newHVhv((HV*)SvRV(args_ref));
 227         sv_2mortal((SV*)args);
 228     }
 229     else{
 230         I32 i;
 231
 232         args = newHV_mortal();
 233
 234         if( (items % 2) != 0 ){
 235             if(!metaclass){ metaclass = get_metaclass(klass); }
 236             mouse_throw_error(metaclass, NULL, "Odd number of parameters to new()");
 237         }
 238
 239         for(i = 0; i < items; i += 2){
 240             (void)hv_store_ent(args, ST(i), newSVsv(ST(i+1)), 0U);
 241         }
 242
 243     }
 244     return args;
 245 }
 246
 247 static void
 248 mouse_report_unmatched_keys(pTHX_ SV* const meta, AV* const attrs, HV* const args) {
 249     HV* const attr_map = newHV_mortal();
 250     I32 const len      = AvFILLp(attrs) + 1;
 251     I32 i;
 252     SV* const unknown = newSVpvs_flags("", SVs_TEMP);
 253     HE* he;
 254
 255     for(i = 0; i < len; i++){
 256         SV* const attr = MOUSE_av_at(attrs, i);
 257         (void)hv_store_ent(attr_map, mcall0(attr, mouse_name), &PL_sv_yes, 0U);
 258     }
 259
 260     hv_iterinit(args);
 261     while((he = hv_iternext(args))){
 262         SV* const key = hv_iterkeysv(he);
 263         if(!hv_exists_ent(attr_map, key, 0U)){
 264             sv_catpvf(unknown, " %"SVf",", key);
 265         }
 266     }
 267     SvCUR(unknown)--; /* chop "," */
 268     mouse_throw_error(meta, NULL,
 269         "Unknown attribute init_arg passed to the constructor of %"SVf": %"SVf,
 270         mcall0(meta, mouse_name), unknown);
 271 }
 272
 273 static void
 274 mouse_class_initialize_object(pTHX_ SV* const meta, SV* const object, HV* const args, bool const ignore_triggers) {
 275     AV* const xc    = mouse_get_xc(aTHX_ meta);
 276     AV* const attrs = MOUSE_xc_attrall(xc);
 277     I32 len         = AvFILLp(attrs) + 1;
 278     I32 i;
 279     I32 used = 0;
 280     AV* triggers_queue = NULL;
 281
 282     assert(meta || object);
 283     assert(args);
 284     assert(SvTYPE(args) == SVt_PVHV);
 285
 286     ENTER;
 287     SAVETMPS;
 288
 289     if(!ignore_triggers){
 290         triggers_queue = newAV_mortal();
 291     }
 292
 293     for(i = 0; i < len; i++){
 294         SV* const attr = MOUSE_av_at(attrs, i);
 295         AV* const xa   = mouse_get_xa(aTHX_ attr);
 296
 297         SV* const slot     = MOUSE_xa_slot(xa);
 298         U16 const flags    = (U16)MOUSE_xa_flags(xa);
 299         SV* const init_arg = MOUSE_xa_init_arg(xa);
 300         HE* he;
 301
 302         if(SvOK(init_arg) && ( he = hv_fetch_ent(args, init_arg, FALSE, 0U) ) ){
 303             SV* value = HeVAL(he);
 304             if(flags & MOUSEf_ATTR_HAS_TC){
 305                 value = mouse_xa_apply_type_constraint(aTHX_ xa, value, flags);
 306             }
 307             set_slot(object, slot, value);
 308             if(SvROK(value) && flags & MOUSEf_ATTR_IS_WEAK_REF){
 309                 weaken_slot(object, slot);
 310             }
 311             if(flags & MOUSEf_ATTR_HAS_TRIGGER && triggers_queue){
 312                 AV* const pair = newAV();
 313                 av_push(pair, newSVsv( mcall0s(attr, "trigger") ));
 314                 av_push(pair, newSVsv(value));
 315
 316                 av_push(triggers_queue, (SV*)pair);
 317             }
 318
 319             used++;
 320         }
 321         else { /* no init arg */
 322             if(flags & (MOUSEf_ATTR_HAS_DEFAULT | MOUSEf_ATTR_HAS_BUILDER)){
 323                 if(!(flags & MOUSEf_ATTR_IS_LAZY)){
 324                     mouse_xa_set_default(aTHX_ xa, object);
 325                 }
 326             }
 327             else if(flags & MOUSEf_ATTR_IS_REQUIRED) {
 328                 mouse_throw_error(attr, NULL, "Attribute (%"SVf") is required", slot);
 329             }
 330         }
 331     } /* for each attributes */
 332
 333     if(triggers_queue){
 334         len = AvFILLp(triggers_queue) + 1;
 335         for(i = 0; i < len; i++){
 336             AV* const pair    = (AV*)AvARRAY(triggers_queue)[i];
 337             SV* const trigger = AvARRAY(pair)[0];
 338             SV* const value   = AvARRAY(pair)[1];
 339
 340             mcall1(object, trigger, value);
 341         }
 342     }
 343
 344     if(MOUSE_xc_flags(xc) & MOUSEf_XC_HAS_STRICT_CONSTRUCTOR && used < HvUSEDKEYS(args)){
 345         mouse_report_unmatched_keys(aTHX_ meta, attrs, args);
 346     }
 347
 348     if(MOUSE_xc_flags(xc) & MOUSEf_XC_IS_ANON){
 349         set_slot(object, newSVpvs_flags("__METACLASS__", SVs_TEMP), meta);
 350     }
 351
 352     FREETMPS;
 353     LEAVE;
 354 }
 355
 356 static SV*
 357 mouse_initialize_metaclass(pTHX_ SV* const klass) {
 358     SV* meta = get_metaclass(klass);
 359
 360     if(!SvOK(meta)){
 361         dSP;
 362         PUSHMARK(SP);
 363
 364         EXTEND(SP, 2);
 365         mPUSHp("Mouse::Meta::Class", sizeof("Mouse::Meta::Class")-1);
 366         PUSHs(klass);
 367         PUTBACK;
 368
 369         call_method("initialize", G_SCALAR);
 370         SPAGAIN;
 371         meta = POPs;
 372         PUTBACK;
 373     }
 374
 375     return meta;
 376 }
 377
 378 static void
 379 mouse_buildall(pTHX_ AV* const xc, SV* const object, SV* const args) {
 380     AV* const buildall = MOUSE_xc_buildall(xc);
 381     I32 const len      = AvFILLp(buildall) + 1;
 382     I32 i;
 383     for(i = 0; i < len; i++){
 384         dSP;
 385
 386         PUSHMARK(SP);
 387         EXTEND(SP, 2);
 388         PUSHs(object);
 389         PUSHs(args);
 390         PUTBACK;
 391
 392         call_sv(AvARRAY(buildall)[i], G_VOID | G_DISCARD);
 393     }
 394 }
 395
 396 MODULE = Mouse  PACKAGE = Mouse
 397
 398 PROTOTYPES: DISABLE
 399
 400 BOOT:
 401     mouse_package   = newSVpvs_share("package");
 402     mouse_namespace = newSVpvs_share("namespace");
 403     mouse_methods   = newSVpvs_share("methods");
 404     mouse_name      = newSVpvs_share("name");
 405
 406     mouse_get_attribute      = newSVpvs_share("get_attribute");
 407     mouse_get_attribute_list = newSVpvs_share("get_attribute_list");
 408
 409     MOUSE_CALL_BOOT(Mouse__Util);
 410     MOUSE_CALL_BOOT(Mouse__Util__TypeConstraints);
 411     MOUSE_CALL_BOOT(Mouse__Meta__Method__Accessor__XS);
 412     MOUSE_CALL_BOOT(Mouse__Meta__Attribute);
 413
 414
 415 MODULE = Mouse  PACKAGE = Mouse::Meta::Module
 416
 417 BOOT:
 418     INSTALL_SIMPLE_READER_WITH_KEY(Module, name, package);
 419     INSTALL_SIMPLE_READER_WITH_KEY(Module, _method_map, methods);
 420     INSTALL_SIMPLE_READER_WITH_KEY(Module, _attribute_map, attributes);
 421
 422 HV*
 423 namespace(SV* self)
 424 CODE:
 425 {
 426     SV* const package = get_slot(self, mouse_package);
 427     if(!(package && SvOK(package))){
 428         croak("No package name defined");
 429     }
 430     RETVAL = gv_stashsv(package, GV_ADDMULTI);
 431 }
 432 OUTPUT:
 433     RETVAL
 434
 435 # ignore extra arguments for extensibility
 436 void
 437 add_method(SV* self, SV* name, SV* code, ...)
 438 CODE:
 439 {
 440     SV* const package = get_slot(self, mouse_package); /* $self->{package} */
 441     SV* const methods = get_slot(self, mouse_methods); /* $self->{methods} */
 442     GV* gv;
 443     SV* code_ref;
 444
 445     if(!(package && SvOK(package))){
 446         croak("No package name defined");
 447     }
 448
 449     SvGETMAGIC(name);
 450     SvGETMAGIC(code);
 451
 452     if(!SvOK(name)){
 453         mouse_throw_error(self, NULL, "You must define a method name");
 454     }
 455     if(!SvROK(code)){
 456         mouse_throw_error(self, NULL, "You must define a CODE reference");
 457     }
 458
 459     code_ref = code;
 460     if(SvTYPE(SvRV(code_ref)) != SVt_PVCV){
 461         SV*  sv = code_ref;  /* used in tryAMAGICunDEREF */
 462         SV** sp = &sv;       /* used in tryAMAGICunDEREF */
 463         tryAMAGICunDEREF(to_cv); /* try \&{$code} */
 464         if(!(SvROK(sv) && SvTYPE(SvRV(sv)) == SVt_PVCV)){
 465             mouse_throw_error(self, NULL, "You must pass a CODE reference to add_method");
 466         }
 467         code_ref = sv;
 468     }
 469
 470     /*  *{$package . '::' . $name} -> *gv */
 471     gv = gv_fetchpv(form("%"SVf"::%"SVf, package, name), GV_ADDMULTI, SVt_PVCV);
 472     if(GvCVu(gv)){ /* delete *slot{gv} to work around "redefine" warning */
 473         SvREFCNT_dec(GvCV(gv));
 474         GvCV(gv) = NULL;
 475     }
 476     sv_setsv_mg((SV*)gv, code_ref); /* *gv = $code_ref */
 477
 478     set_slot(methods, name, code); /* $self->{methods}{$name} = $code */
 479
 480     /* name the CODE ref if it's anonymous */
 481     {
 482         CV* const code_entity = (CV*)SvRV(code_ref);
 483         if(CvANON(code_entity)
 484             && CvGV(code_entity) /* a cv under construction has no gv */ ){
 485
 486             CvGV(code_entity) = gv;
 487             CvANON_off(code_entity);
 488         }
 489     }
 490 }
 491
 492 MODULE = Mouse  PACKAGE = Mouse::Meta::Class
 493
 494 BOOT:
 495     INSTALL_SIMPLE_READER(Class, roles);
 496     INSTALL_SIMPLE_PREDICATE_WITH_KEY(Class, is_anon_class, anon_serial_id);
 497     INSTALL_SIMPLE_READER(Class, is_immutable);
 498     INSTALL_SIMPLE_READER_WITH_KEY(Class, has_strict_constructor, _strict_constructor);
 499
 500     INSTALL_CLASS_HOLDER(Class, method_metaclass,     "Mouse::Meta::Method");
 501     INSTALL_CLASS_HOLDER(Class, attribute_metaclass,  "Mouse::Meta::Attribute");
 502     INSTALL_CLASS_HOLDER(Class, constructor_class,    "Mouse::Meta::Method::Constructor::XS");
 503     INSTALL_CLASS_HOLDER(Class, destructor_class,     "Mouse::Meta::Method::Destructor::XS");
 504
 505     newCONSTSUB(gv_stashpvs("Mouse::Meta::Method::Constructor::XS", TRUE), "_generate_constructor",
 506         newRV_inc((SV*)get_cvs("Mouse::Object::new", TRUE)));
 507     newCONSTSUB(gv_stashpvs("Mouse::Meta::Method::Destructor::XS", TRUE), "_generate_destructor",
 508         newRV_inc((SV*)get_cvs("Mouse::Object::DESTROY", TRUE)));
 509
 510
 511 void
 512 linearized_isa(SV* self)
 513 PPCODE:
 514 {
 515     SV* const stash_ref = mcall0(self, mouse_namespace); /* $self->namespace */
 516     AV* linearized_isa;
 517     I32 len;
 518     I32 i;
 519     if(!(SvROK(stash_ref) && SvTYPE(SvRV(stash_ref)) == SVt_PVHV)){
 520         croak("namespace() didn't return a HASH reference");
 521     }
 522     linearized_isa = mro_get_linear_isa((HV*)SvRV(stash_ref));
 523     len = AvFILLp(linearized_isa) + 1;
 524     EXTEND(SP, len);
 525     for(i = 0; i < len; i++){
 526         PUSHs(AvARRAY(linearized_isa)[i]);
 527     }
 528 }
 529
 530 void
 531 get_all_attributes(SV* self)
 532 PPCODE:
 533 {
 534     AV* const xc        = mouse_get_xc(aTHX_ self);
 535     AV* const all_attrs = MOUSE_xc_attrall(xc);
 536     I32 const len       = AvFILLp(all_attrs) + 1;
 537     I32 i;
 538
 539     EXTEND(SP, len);
 540     for(i = 0; i < len; i++){
 541         PUSHs( MOUSE_av_at(all_attrs, i) );
 542     }
 543 }
 544
 545 SV*
 546 new_object(SV* meta, ...)
 547 CODE:
 548 {
 549     AV* const xc   = mouse_get_xc(aTHX_ meta);
 550     HV* const args = mouse_buildargs(aTHX_ meta, NULL, ax, items);
 551
 552     RETVAL = mouse_instance_create(aTHX_ MOUSE_xc_stash(xc));
 553     mouse_class_initialize_object(aTHX_ meta, RETVAL, args, FALSE);
 554 }
 555 OUTPUT:
 556     RETVAL
 557
 558 void
 559 _initialize_object(SV* meta, SV* object, HV* args, bool ignore_triggers = FALSE)
 560 CODE:
 561 {
 562     mouse_class_initialize_object(aTHX_ meta, object, args, ignore_triggers);
 563 }
 564
 565 MODULE = Mouse  PACKAGE = Mouse::Meta::Role
 566
 567 BOOT:
 568     INSTALL_SIMPLE_READER_WITH_KEY(Role, get_roles, roles);
 569     INSTALL_SIMPLE_PREDICATE_WITH_KEY(Role, is_anon_role, anon_serial_id);
 570
 571     INSTALL_CLASS_HOLDER(Role, method_metaclass,  "Mouse::Meta::Role::Method");
 572
 573 MODULE = Mouse  PACKAGE = Mouse::Object
 574
 575 SV*
 576 new(SV* klass, ...)
 577 CODE:
 578 {
 579     SV* const meta = mouse_initialize_metaclass(aTHX_ klass);
 580     AV* const xc   = mouse_get_xc(aTHX_ meta);
 581     UV const flags = MOUSE_xc_flags(xc);
 582     SV* args;
 583
 584     /* BUILDARGS */
 585     if(flags & MOUSEf_XC_HAS_BUILDARGS){
 586         I32 i;
 587         SPAGAIN;
 588
 589         PUSHMARK(SP);
 590         EXTEND(SP, items);
 591         for(i = 0; i < items; i++){
 592             PUSHs(ST(i));
 593         }
 594         //SP += items;
 595         PUTBACK;
 596         call_method("BUILDARGS", G_SCALAR);
 597         SPAGAIN;
 598         args = POPs;
 599         PUTBACK;
 600
 601         if(!IsHashRef(args)){
 602             croak("BUILDARGS did not return a HASH reference");
 603         }
 604     }
 605     else{
 606         args = newRV_inc((SV*)mouse_buildargs(aTHX_ meta, klass, ax, items));
 607         sv_2mortal(args);
 608     }
 609
 610     /* new_object */
 611     RETVAL = mouse_instance_create(aTHX_ MOUSE_xc_stash(xc));
 612     mouse_class_initialize_object(aTHX_ meta, RETVAL, (HV*)SvRV(args), FALSE);
 613
 614     mouse_buildall(aTHX_ xc, RETVAL, args);
 615 }
 616 OUTPUT:
 617     RETVAL
 618
 619 void
 620 DESTROY(SV* object)
 621 ALIAS:
 622     DESTROY     = 0
 623     DEMOLISHALL = 1
 624 CODE:
 625 {
 626     SV* const meta = get_metaclass(object);
 627     AV* demolishall;
 628     I32 len, i;
 629
 630     PERL_UNUSED_VAR(ix);
 631
 632     if(!IsObject(object)){
 633         croak("You must not call DESTROY as a class method");
 634     }
 635
 636     if(SvOK(meta)){
 637         AV* const xc = mouse_get_xc(aTHX_ meta);
 638
 639         demolishall = MOUSE_xc_demolishall(xc);
 640     }
 641     else { /* The metaclass is already destroyed */
 642         AV* const linearized_isa = mro_get_linear_isa(SvSTASH(SvRV(object)));
 643
 644         len = AvFILLp(linearized_isa) + 1;
 645
 646         demolishall = newAV_mortal();
 647         for(i = 0; i < len; i++){
 648             SV* const klass = MOUSE_av_at(linearized_isa, i);
 649             HV* const st    = gv_stashsv(klass, TRUE);
 650             GV* const gv    = stash_fetchs(st, "DEMOLISH", FALSE);
 651             if(gv && GvCVu(gv)){
 652                 av_push(demolishall, newRV_inc((SV*)GvCV(gv)));
 653             }
 654         }
 655     }
 656
 657     len      = AvFILLp(demolishall) + 1;
 658     if(len > 0){
 659         GV* const statusvalue = gv_fetchpvs("?", 0, SVt_PV);
 660         SAVESPTR(GvSV(statusvalue)); /* local $? */
 661         SAVESPTR(ERRSV); /* local $@ */
 662
 663         GvSV(statusvalue) = sv_newmortal();
 664         ERRSV             = newSVpvs_flags("", SVs_TEMP);
 665         for(i = 0; i < len; i++){
 666             SPAGAIN;
 667
 668             PUSHMARK(SP);
 669             XPUSHs(object);
 670             PUTBACK;
 671
 672             call_sv(AvARRAY(demolishall)[i], G_VOID | G_DISCARD | G_EVAL);
 673             if(SvTRUE(ERRSV)){
 674                 SV* const e = newSVsv(ERRSV);
 675
 676                 FREETMPS;
 677                 LEAVE;
 678
 679                 sv_setsv(ERRSV, e);
 680                 SvREFCNT_dec(e);
 681                 croak(NULL); /* rethrow */
 682             }
 683         }
 684     }
 685 }
 686
 687 HV*
 688 BUILDARGS(SV* klass, ...)
 689 CODE:
 690 {
 691     RETVAL = mouse_buildargs(aTHX_ NULL, klass, ax, items);
 692 }
 693 OUTPUT:
 694     RETVAL
 695
 696
 697 void
 698 BUILDALL(SV* self, SV* args)
 699 CODE:
 700 {
 701     SV* const meta = get_metaclass(self);
 702     AV* const xc   = mouse_get_xc(aTHX_ meta);
 703
 704     if(!IsHashRef(args)){
 705         croak("You must pass a HASH reference to BUILDALL");
 706     }
 707     if(mg_find(SvRV(args), PERL_MAGIC_tied)){
 708         croak("You cannot use tie HASH reference as args");
 709     }
 710     mouse_buildall(aTHX_ xc, self, args);
 711 }