22 Jan 2008 19:32:16 UTC
- Distribution: MooseX-Compile
- Source (raw)
- Browse (raw)
- How to Contribute
- Issues (3)
- Testers (347 / 613 / 2)
- KwaliteeBus factor: 3
- 91.67% Coverage
- License: unknown
- Activity24 month
- Download (16.2KB)
- MetaCPAN Explorer
- Subscribe to distribution
- This version
- Latest versionNUFFIN יובל קוג'מן (Yuval Kogman)
Take me over?The maintainer of this distribution is looking for someone to take over! If you're interested then please contact them via email.
- HERE BE DRAGONS
- MODUS OPERANDI
- INTERFACE FOR COMPILED MODULES
- SEE ALSO
- VERSION CONTROL
package MyClass; use Moose; # your moose class here
On the command line:
$ mkcompile compile --make-immutable MyClass
Or to always compile:
use MooseX::Compile; # instead of use Moose
This is alpha code.
If you decide to to use it please come by the
#mooseIRC channel on
irc.perl.org(maybe this link works: irc://irc.perl.org/#moose).
Your help in testing this is highly valued, so please feel free to verbally abuse
#mooseuntil things are working properly.
The example in the "SYNOPSIS" will compile
MyClassinto two files,
.pmcfile caches all of the generated code, and the
.mopcfile is a Storable file of the metaclass instance.
MyClassis loaded the next time, Perl will see the
.pmcfile and load that instead. This file will load faster for several reasons:
The metaclass does not need to be loaded, at least until you introspect.
metafor compiled classes will lazy load the already computed metaclass instance from the
.mopcfile. When it is needed the instance will be deserialized and it's class (probably Moose::Meta::Class) will be loaded.
If all your classes are compiled and you don't use introspection in your code, you can then deploy your code without using moose.
This is not a source filter.
Due to the fragility of source filtering in Perl,
MooseX::Compile::Compilerwill not alter the body of the class, but instead prefix it with a preamble that sets up the right environment for it.
This involves temporarily overriding
Moosefrom this module (but not others), and stubbing the sugar with no-ops (the various declarations are thus effectively stripped without altering the source code), amongst other things.
Then the source code of the original class is executed normally, and when the file's lexical scope gets cleaned up then the final pieces of the class are put in place and all the trickery is undone.
Until this point
metais replaced with a mock object that will silently or loudly ignore various method calls depending on their nature. For instance
is a silent no-op, because when the compiler compiled it the class was already immutable, so the loaded version will be immutable too.
On the other hand
will complain because the value of
@ISAis already captured, and changing it is meaningless.
This variable is set at
BEGINfor modules in a
.pmc. This allows you to write conditional code, like:
use if not(our $__mx_is_compiled) metaclass => "Blah"; __PACKAGE__->meta->add_attribute( ... ) unless our $__mx_is_compiled;
If you add a subroutine named
__mx_compile_post_hookto your class it will be called at the end of compilation, allowing you to to diddle the class after loading.
This developer release comes with some serious limitations.
It has so far only been tested with the
Point3Dclasses from the recipe.
No method modifiers are supported yet. We know how and it's going to take a while longer.
Only core, optimized Moose types are guaranteed to work (
Str, etc). Other types may or may not deparse properly.
Roles are not yet supported.
Stuff is definitely going to break. This is just a first release of a fairly complex project, so bear with us =)
There is a fairly long TODO file in the distribution.
Yuval Kogman <firstname.lastname@example.org>
Copyright (c) 2008 Infinity Interactive, Yuval Kogman. All rights reserved This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
2 POD Errors
The following errors were encountered while parsing the POD:
- Around line 242:
'=item' outside of any '=over'
- Around line 257:
You forgot a '=back' before '=head1'
Module Install Instructions
To install MooseX::Compile, copy and paste the appropriate command in to your terminal.
perl -MCPAN -e shell install MooseX::Compile
For more information on module installation, please visit the detailed CPAN module installation guide.