Document that initialize() returns a cached metaclass if it exists.
[gitmo/Class-MOP.git] / MOP.xs
1 /* There's a lot of cases of doubled parens in here like this:
2
3   while ( (he = ...) ) {
4
5 This shuts up warnings from gcc -Wall
6 */
7
8 #include "EXTERN.h"
9 #include "perl.h"
10 #include "XSUB.h"
11
12 #define NEED_newRV_noinc
13 #define NEED_sv_2pv_flags
14 #define NEED_sv_2pv_nolen
15 #include "ppport.h"
16
17 #define DECLARE_KEY(name) SV *key_##name; U32 hash_##name;
18
19 #define PREHASH_KEY_WITH_VALUE(name, value) do { \
20     key_##name = newSVpvs(value); \
21     PERL_HASH(hash_##name, value, sizeof(value) - 1); \
22 } while (0)
23
24 /* this is basically the same as the above macro, except that the value will be
25  * the stringified name. However, we can't just implement this in terms of
26  * PREHASH_KEY_WITH_VALUE as that'd cause macro expansion on the value of
27  * 'name' when it's being passed to the other macro. suggestions on how to make
28  * this more elegant would be much appreciated */
29
30 #define PREHASH_KEY(name) do { \
31     key_##name = newSVpvs(#name); \
32     PERL_HASH(hash_##name, #name, sizeof(#name) - 1); \
33 } while (0)
34
35 DECLARE_KEY(name);
36 DECLARE_KEY(package);
37 DECLARE_KEY(package_name);
38 DECLARE_KEY(body);
39 DECLARE_KEY(package_cache_flag);
40 DECLARE_KEY(methods);
41 DECLARE_KEY(VERSION);
42 DECLARE_KEY(ISA);
43
44 SV *method_metaclass;
45 SV *associated_metaclass;
46 SV *wrap;
47
48
49 #define check_package_cache_flag(stash) mop_check_package_cache_flag(aTHX_ stash)
50 #if PERL_VERSION >= 10
51
52 static UV
53 mop_check_package_cache_flag(pTHX_ HV* stash) {
54     assert(SvTYPE(stash) == SVt_PVHV);
55
56     /* here we're trying to implement a c version of mro::get_pkg_gen($stash),
57      * however the perl core doesn't make it easy for us. It doesn't provide an
58      * api that just does what we want.
59      *
60      * However, we know that the information we want is, inside the core,
61      * available using HvMROMETA(stash)->pkg_gen. Unfortunately, although the
62      * HvMROMETA macro is public, it is implemented using Perl_mro_meta_init,
63      * which is not public and only available inside the core, as the mro
64      * interface as well as the structure returned by mro_meta_init isn't
65      * considered to be stable yet.
66      *
67      * Perl_mro_meta_init isn't declared static, so we could just define it
68      * ourselfs if perls headers don't do that for us, except that won't work
69      * on platforms where symbols need to be explicitly exported when linking
70      * shared libraries.
71      *
72      * So our, hopefully temporary, solution is to be even more evil and
73      * basically reimplement HvMROMETA in a very fragile way that'll blow up
74      * when the relevant parts of the mro implementation in core change.
75      *
76      * :-(
77      *
78      */
79
80     return HvAUX(stash)->xhv_mro_meta
81          ? HvAUX(stash)->xhv_mro_meta->pkg_gen
82          : 0;
83 }
84
85 #else /* pre 5.10.0 */
86
87 static UV
88 mop_check_package_cache_flag(pTHX_ HV *stash) {
89     PERL_UNUSED_ARG(stash);
90     assert(SvTYPE(stash) == SVt_PVHV);
91
92     return PL_sub_generation;
93 }
94 #endif
95
96 #define call0(s, m)  mop_call0(aTHX_ s, m)
97 static SV *
98 mop_call0(pTHX_ SV *const self, SV *const method) {
99     dSP;
100     SV *ret;
101
102     PUSHMARK(SP);
103     XPUSHs(self);
104     PUTBACK;
105
106     call_sv(method, G_SCALAR | G_METHOD);
107
108     SPAGAIN;
109     ret = POPs;
110     PUTBACK;
111
112     return ret;
113 }
114
115 static int
116 get_code_info (SV *coderef, char **pkg, char **name)
117 {
118     if (!SvOK(coderef) || !SvROK(coderef) || SvTYPE(SvRV(coderef)) != SVt_PVCV) {
119         return 0;
120     }
121
122     coderef = SvRV(coderef);
123     /* I think this only gets triggered with a mangled coderef, but if
124        we hit it without the guard, we segfault. The slightly odd return
125        value strikes me as an improvement (mst)
126     */
127 #ifdef isGV_with_GP
128     if ( isGV_with_GP(CvGV(coderef)) ) {
129 #endif
130         *pkg     = HvNAME( GvSTASH(CvGV(coderef)) );
131         *name    = GvNAME( CvGV(coderef) );
132 #ifdef isGV_with_GP
133     } else {
134         *pkg     = "__UNKNOWN__";
135         *name    = "__ANON__";
136     }
137 #endif
138
139     return 1;
140 }
141
142 typedef enum {
143     TYPE_FILTER_NONE,
144     TYPE_FILTER_CODE,
145     TYPE_FILTER_ARRAY,
146     TYPE_FILTER_IO,
147     TYPE_FILTER_HASH,
148     TYPE_FILTER_SCALAR,
149 } type_filter_t;
150
151 static HV *
152 get_all_package_symbols(HV *stash, type_filter_t filter)
153 {
154     HE *he;
155     HV *ret = newHV();
156
157     (void)hv_iterinit(stash);
158
159     if (filter == TYPE_FILTER_NONE) {
160         while ( (he = hv_iternext(stash)) ) {
161             STRLEN keylen;
162             char *key = HePV(he, keylen);
163             if (!hv_store(ret, key, keylen, SvREFCNT_inc(HeVAL(he)), 0)) {
164                 croak("failed to store glob ref");
165             }
166         }
167
168         return ret;
169     }
170
171     while ( (he = hv_iternext(stash)) ) {
172         SV *const gv = HeVAL(he);
173         SV *sv = NULL;
174         char *key;
175         STRLEN keylen;
176         char *package;
177         SV *fq;
178
179         switch( SvTYPE(gv) ) {
180 #ifndef SVt_RV
181             case SVt_RV:
182 #endif
183             case SVt_PV:
184             case SVt_IV:
185                 /* expand the gv into a real typeglob if it
186                  * contains stub functions and we were asked to
187                  * return CODE symbols */
188                 if (filter == TYPE_FILTER_CODE) {
189                     if (SvROK(gv)) {
190                         /* we don't really care about the length,
191                            but that's the API */
192                         key = HePV(he, keylen);
193                         package = HvNAME(stash);
194                         fq = newSVpvf("%s::%s", package, key);
195                         sv = (SV *)get_cv(SvPV_nolen(fq), 0);
196                         break;
197                     }
198
199                     key = HePV(he, keylen);
200                     gv_init((GV *)gv, stash, key, keylen, GV_ADDMULTI);
201                 }
202                 /* fall through */
203             case SVt_PVGV:
204                 switch (filter) {
205                     case TYPE_FILTER_CODE:   sv = (SV *)GvCVu(gv); break;
206                     case TYPE_FILTER_ARRAY:  sv = (SV *)GvAV(gv);  break;
207                     case TYPE_FILTER_IO:     sv = (SV *)GvIO(gv);  break;
208                     case TYPE_FILTER_HASH:   sv = (SV *)GvHV(gv);  break;
209                     case TYPE_FILTER_SCALAR: sv = (SV *)GvSV(gv);  break;
210                     default:
211                         croak("Unknown type");
212                 }
213                 break;
214             default:
215                 continue;
216         }
217
218         if (sv) {
219             char *key = HePV(he, keylen);
220             if (!hv_store(ret, key, keylen, newRV_inc(sv), 0)) {
221                 croak("failed to store symbol ref");
222             }
223         }
224     }
225
226     return ret;
227 }
228
229
230 static void
231 mop_update_method_map(pTHX_ SV *const self, SV *const class_name, HV *const stash, HV *const map) {
232     const char *const class_name_pv = HvNAME(stash); /* must be HvNAME(stash), not SvPV_nolen_const(class_name) */
233     SV   *method_metaclass_name;
234     char *method_name;
235     I32   method_name_len;
236     SV   *coderef;
237     HV   *symbols;
238     dSP;
239
240     symbols = get_all_package_symbols(stash, TYPE_FILTER_CODE);
241
242     (void)hv_iterinit(symbols);
243     while ( (coderef = hv_iternextsv(symbols, &method_name, &method_name_len)) ) {
244         CV *cv = (CV *)SvRV(coderef);
245         char *cvpkg_name;
246         char *cv_name;
247         SV *method_slot;
248         SV *method_object;
249
250         if (!get_code_info(coderef, &cvpkg_name, &cv_name)) {
251             continue;
252         }
253
254         /* this checks to see that the subroutine is actually from our package  */
255         if ( !(strEQ(cvpkg_name, "constant") && strEQ(cv_name, "__ANON__")) ) {
256             if ( strNE(cvpkg_name, class_name_pv) ) {
257                 continue;
258             }
259         }
260
261         method_slot = *hv_fetch(map, method_name, method_name_len, TRUE);
262         if ( SvOK(method_slot) ) {
263             SV *const body = call0(method_slot, key_body); /* $method_object->body() */
264             if ( SvROK(body) && ((CV *) SvRV(body)) == cv ) {
265                 continue;
266             }
267         }
268
269         method_metaclass_name = call0(self, method_metaclass); /* $self->method_metaclass() */
270
271         /*
272             $method_object = $method_metaclass->wrap(
273                 $cv,
274                 associated_metaclass => $self,
275                 package_name         => $class_name,
276                 name                 => $method_name
277             );
278         */
279         ENTER;
280         SAVETMPS;
281
282         PUSHMARK(SP);
283         EXTEND(SP, 8);
284         PUSHs(method_metaclass_name); /* invocant */
285         mPUSHs(newRV_inc((SV *)cv));
286         PUSHs(associated_metaclass);
287         PUSHs(self);
288         PUSHs(key_package_name);
289         PUSHs(class_name);
290         PUSHs(key_name);
291         mPUSHs(newSVpv(method_name, method_name_len));
292         PUTBACK;
293
294         call_sv(wrap, G_SCALAR | G_METHOD);
295         SPAGAIN;
296         method_object = POPs;
297         PUTBACK;
298         /* $map->{$method_name} = $method_object */
299         sv_setsv(method_slot, method_object);
300
301         FREETMPS;
302         LEAVE;
303     }
304 }
305
306 /*
307 get_code_info:
308   Pass in a coderef, returns:
309   [ $pkg_name, $coderef_name ] ie:
310   [ 'Foo::Bar', 'new' ]
311 */
312
313 MODULE = Class::MOP   PACKAGE = Class::MOP
314
315 BOOT:
316     PREHASH_KEY(name);
317     PREHASH_KEY(body);
318     PREHASH_KEY(package);
319     PREHASH_KEY(package_name);
320     PREHASH_KEY(methods);
321     PREHASH_KEY(ISA);
322     PREHASH_KEY(VERSION);
323     PREHASH_KEY_WITH_VALUE(package_cache_flag, "_package_cache_flag");
324
325     method_metaclass     = newSVpvs("method_metaclass");
326     wrap                 = newSVpvs("wrap");
327     associated_metaclass = newSVpvs("associated_metaclass");
328
329
330 PROTOTYPES: DISABLE
331
332 # use prototype here to be compatible with get_code_info from Sub::Identify
333 void
334 get_code_info(coderef)
335     SV *coderef
336     PROTOTYPE: $
337     PREINIT:
338         char *pkg  = NULL;
339         char *name = NULL;
340     PPCODE:
341         if (get_code_info(coderef, &pkg, &name)) {
342             EXTEND(SP, 2);
343             PUSHs(newSVpv(pkg, 0));
344             PUSHs(newSVpv(name, 0));
345         }
346
347 void
348 is_class_loaded(klass=&PL_sv_undef)
349     SV *klass
350     PREINIT:
351         HV *stash;
352         char *key;
353         I32 keylen;
354         GV *gv;
355     PPCODE:
356         if (!SvPOK(klass) || !SvCUR(klass)) {
357             XSRETURN_NO;
358         }
359
360         stash = gv_stashsv(klass, 0);
361         if (!stash) {
362             XSRETURN_NO;
363         }
364
365         if (hv_exists_ent (stash, key_VERSION, hash_VERSION)) {
366             HE *version = hv_fetch_ent(stash, key_VERSION, 0, hash_VERSION);
367             if (version && HeVAL(version) && GvSV(HeVAL(version))) {
368                 XSRETURN_YES;
369             }
370         }
371
372         if (hv_exists_ent (stash, key_ISA, hash_ISA)) {
373             HE *isa = hv_fetch_ent(stash, key_ISA, 0, hash_ISA);
374             if (isa && HeVAL(isa) && GvAV(HeVAL(isa))) {
375                 XSRETURN_YES;
376             }
377         }
378
379         (void)hv_iterinit(stash);
380         while ((gv = (GV *)hv_iternextsv(stash, &key, &keylen))) {
381             if (keylen <= 0) {
382                 continue;
383             }
384
385             if (key[keylen - 1] == ':' && key[keylen - 2] == ':') {
386                 continue;
387             }
388
389             if (!isGV(gv) || GvCV(gv) || GvSV(gv) || GvAV(gv)
390                 || GvHV(gv) || GvIO(gv) || GvFORM(gv)) {
391                 XSRETURN_YES;
392             }
393         }
394
395         XSRETURN_NO;
396
397 MODULE = Class::MOP   PACKAGE = Class::MOP::Package
398
399 void
400 get_all_package_symbols(self, filter=TYPE_FILTER_NONE)
401     SV *self
402     type_filter_t filter
403     PREINIT:
404         HV *stash = NULL;
405         HV *symbols = NULL;
406         register HE *he;
407     PPCODE:
408         if ( ! SvROK(self) ) {
409             die("Cannot call get_all_package_symbols as a class method");
410         }
411
412         if (GIMME_V == G_VOID) {
413             XSRETURN_EMPTY;
414         }
415
416
417         PUTBACK;
418
419         if ( (he = hv_fetch_ent((HV *)SvRV(self), key_package, 0, hash_package)) ) {
420             stash = gv_stashsv(HeVAL(he), 0);
421         }
422
423
424         if (!stash) {
425             switch (GIMME_V) {
426                 case G_SCALAR: XSRETURN_UNDEF; break;
427                 case G_ARRAY:  XSRETURN_EMPTY; break;
428             }
429         }
430
431         symbols = get_all_package_symbols(stash, filter);
432
433         switch (GIMME_V) {
434             case G_SCALAR:
435                 PUSHs(sv_2mortal(newRV_inc((SV *)symbols)));
436                 break;
437             case G_ARRAY:
438                 warn("Class::MOP::Package::get_all_package_symbols in list context is deprecated. use scalar context instead.");
439
440                 EXTEND(SP, HvKEYS(symbols) * 2);
441
442                 while ((he = hv_iternext(symbols))) {
443                     PUSHs(hv_iterkeysv(he));
444                     PUSHs(sv_2mortal(SvREFCNT_inc(HeVAL(he))));
445                 }
446
447                 break;
448             default:
449                 break;
450         }
451
452         SvREFCNT_dec((SV *)symbols);
453
454 void
455 name(self)
456     SV *self
457     PREINIT:
458         register HE *he;
459     PPCODE:
460         if ( ! SvROK(self) ) {
461             die("Cannot call name as a class method");
462         }
463
464         if ( (he = hv_fetch_ent((HV *)SvRV(self), key_package, 0, hash_package)) )
465             XPUSHs(HeVAL(he));
466         else
467             ST(0) = &PL_sv_undef;
468
469 MODULE = Class::MOP   PACKAGE = Class::MOP::Attribute
470
471 void
472 name(self)
473     SV *self
474     PREINIT:
475         register HE *he;
476     PPCODE:
477         if ( ! SvROK(self) ) {
478             die("Cannot call name as a class method");
479         }
480
481         if ( (he = hv_fetch_ent((HV *)SvRV(self), key_name, 0, hash_name)) )
482             XPUSHs(HeVAL(he));
483         else
484             ST(0) = &PL_sv_undef;
485
486 MODULE = Class::MOP   PACKAGE = Class::MOP::Method
487
488 void
489 name(self)
490     SV *self
491     PREINIT:
492         register HE *he;
493     PPCODE:
494         if ( ! SvROK(self) ) {
495             die("Cannot call name as a class method");
496         }
497
498         if ( (he = hv_fetch_ent((HV *)SvRV(self), key_name, 0, hash_name)) )
499             XPUSHs(HeVAL(he));
500         else
501             ST(0) = &PL_sv_undef;
502
503 void
504 package_name(self)
505     SV *self
506     PREINIT:
507         register HE *he;
508     PPCODE:
509         if ( ! SvROK(self) ) {
510             die("Cannot call package_name as a class method");
511         }
512
513         if ( (he = hv_fetch_ent((HV *)SvRV(self), key_package_name, 0, hash_package_name)) )
514             XPUSHs(HeVAL(he));
515         else
516             ST(0) = &PL_sv_undef;
517
518 void
519 body(self)
520     SV *self
521     PREINIT:
522         register HE *he;
523     PPCODE:
524         if ( ! SvROK(self) ) {
525             die("Cannot call body as a class method");
526         }
527
528         if ( (he = hv_fetch_ent((HV *)SvRV(self), key_body, 0, hash_body)) )
529             XPUSHs(HeVAL(he));
530         else
531             ST(0) = &PL_sv_undef;
532
533
534 MODULE = Class::MOP    PACKAGE = Class::MOP::Class
535
536 void
537 get_method_map(self)
538     SV *self
539     PREINIT:
540         HV *const obj        = (HV *)SvRV(self);
541         SV *const class_name = HeVAL( hv_fetch_ent(obj, key_package, 0, hash_package) );
542         HV *const stash      = gv_stashsv(class_name, 0);
543         UV  const current    = check_package_cache_flag(stash);
544         SV *const cache_flag = HeVAL( hv_fetch_ent(obj, key_package_cache_flag, TRUE, hash_package_cache_flag));
545         SV *const map_ref    = HeVAL( hv_fetch_ent(obj, key_methods, TRUE, hash_methods));
546     PPCODE:
547         /* in  $self->{methods} does not yet exist (or got deleted) */
548         if ( !SvROK(map_ref) || SvTYPE(SvRV(map_ref)) != SVt_PVHV ) {
549             SV *new_map_ref = newRV_noinc((SV *)newHV());
550             sv_2mortal(new_map_ref);
551             sv_setsv(map_ref, new_map_ref);
552         }
553
554         if ( !SvOK(cache_flag) || SvUV(cache_flag) != current ) {
555             mop_update_method_map(aTHX_ self, class_name, stash, (HV *)SvRV(map_ref));
556             sv_setuv(cache_flag, check_package_cache_flag(stash)); /* update_cache_flag() */
557         }
558
559         XPUSHs(map_ref);