Revision history for Perl extension Aspect 0.97_03 Fri 20 May 2011 - Simplified if_true to true and ::If to ::True - Expanded XS acceleration to more classes and methods - Completed reasonable thorough main documentation for Aspect.pm - Prohibit usage of the highest pointcut to one per advice declaration due to implementation complexity and unclear semantics. - Added Advice::Point::Static for the cflow point details in line with AspectJ's idea of "static parts" of join points. - Removed deprecated Aspect::AdviceContext now it is no longer needed by the cflow pointcut. - Pointcut logic operations & | ! now validate their children - The cflow declarator is now documented everywhere as single param, defaulting to an "enclosing" accessor, which is accelerated. - Added specific accelerated Aspect::Point::pointcut method - Move Aspect::Pointcut::Highest::Cleanup into its own module file 0.97_02 Wed 18 May 2011 - Removed the barely document, untested and rarely used append_param(s) - Added an improved SYNOPSIS and generally improving main POD - Added limited XS acceleration if Class::XSAccessor 1.08 installed. - Remove the use of test recursion in preparation for XS vs PP copying 0.97_01 Thu 24 Mar 2011 - Now all standard keys have their own methods, remove the weird automagic from the AUTOLOAD method. - Some more minor performance tweaks - Removed excessive exception method from begin advice - Moved proceed to the specific method it is used - Renamed run_original to proceed, keeping the original as an alias 0.96 Thu 24 Mar 2011 - Updating copyright year - Moved exception method away from a slow generic implementation - Moved original method away from slow generic implementation - Moved type method away from slow generic implementation - Rewrote return_value method into a much faster version - Removed get_value method, AUTOLOAD now reads the value directly 0.95 Mon 13 Dec 2010 - Fixed #57528 ([PATCH] Fix spelling error - Fixed #57417 Bad return value in list context 0.94 Fri 10 Dec 2010 - CPAN Testers is happy, moving to production release 0.93_02 Fri 10 Dec 2010 - Applied the fix from 0.93_01 to an additional place it was occuring in Aspect::Pointcut::Throwing. - Corrected the Aspect::Advice::Around documentation to refer to $_->run_original instead of $_->proceed until the proceed method actually works like that. 0.93_01 Thu 9 Dec 2010 - This contains a potential fix for the 5.13.6 breakage to be confirmed by CPAN Testers. 0.92 Wed 21 Jul 2010 - Correcting bad link to search.cpan 0.91 Tue 20 Jul 2010 - Updating to Module::Install::DSL 1.00 - The bundled libraries now use the new $_ mechanism to use the point context object. - Expanding the documentation and modernising it to match the API changes in the last few releases. 0.90 Thu 27 May 2010 - Updating to Module::Install::DSL 0.97 - Upgraded the old method-based match_run run-time context testing interface to a newer compiled_runtime context testing interface. The new interface cooks the run-time tests down to a single compiled perl condition where possible, and a set of nested function calls where strings cannot be used. The function calls alone are faster than methods, and the functions have no parameters, making them faster still. Tests that can be compiled all the way down to a string are even faster, because they avoid Perl's expensive function calls, and get even faster because Perl's opcode optimisations get a much better shot at improving the generated code. - Upgraded the weave-time mechanism to work using compiled code in the same fashion as the run-time code. This should make the weave costs (the time to scan the entire namespace) much lower as well. - Expanded out the POD documentation to cover the entire namespace tree. 0.45 Mon 10 May 2010 - Updating to Module::Install::DSL 0.96 - More performance tuning of the namespace scanner in match_all. - A wide range of cleanups, improvements and expansions to the previously existing documentation. This includes full documentation for the entire Aspect::Pointcut tree. - Renamed the new API for join point contexts from Aspect::Context to Aspect::Point. - Aspect libraries in namespaces other than Aspect::Library:: can now be used as long as the module inherits from the (empty) identifying base class Aspect::Library. All libraries that currently inherit from Aspect::Modular automatically inherit from the new Aspect::Library as well. - Started work on third-generation optimiser for Aspect::Pointcut. This functionality will be hidden until it is complete enough to use. 0.44 Mon 15 Feb 2010 - Adam Kennedy - Inlined and reimplemented a stripped down and faster replacement for the functionality provided by Devel::Symdump to make match_all significantly faster and remove potential issues with Devel::Symdump on Mac OS 5.10.0 0.43 Thu 28 Jan 2010 - Adam Kennedy - Fixed a pointcut optimisation problem where we were currying away call checking in complex nested pointcuts where runtime pointcuts needed to retain the call checking to limit the run-time checks to an appropriate subset of the total number of functions hooked. - More elements of what will ultimately become the pointcut context are passed through to the curried pointcut tests (in preparation for moving to a File::Find::Rule-like string-eval-compiled form of the pointcut. 0.42 Wed 20 Jan 2010 - Adam Kennedy - Began the implementation of the new Aspect::Context tree - Generated advice hook code now cheats for speed and blesses context objects directly into the advice-specific Aspect::Context class, which should be safe now the contexts have a dumb constructor. - Pointcut matching now correctly ignores exported Aspect functions. - Added in initial stub for Aspect::Library (the renaming of Aspect::Modular). - Moved Aspect::Advice::Hook to Aspect::Hook to provide Advice/Hook class symmetry, and make it no longer an Advice subclass. - Removed temporary debugging code in Aspect::Library::Breakpoint that slipped through into production 0.41 Wed 20 Jan 2010 - Adam Kennedy - So few pointcuts care about the sub name at run-time that it doesn't make sense to pass it as a separate parameter to match_run. Include it in the run-time HASH instead. - Normalise changes to return_value inside the advice code, rather than after it by using the ->{wantarray} context attribute to know when that normalisation is needed. This allows us to cheat in the hook code and use ->{return_value} directly, which is significantly faster than calling ->return_value. 0.40 Tue 19 Jan 2010 - Adam Kennedy - Added experimental Aspect::Library::Throwing pointcut - Only nested pointcuts containing only call() would curry away. Now nested mixed pointcuts curry out as well. - Nested And|Or pointcuts curry to faster flat 3+ element And|Or 0.39 Tue 19 Jan 2010 - Adam Kennedy - All hook code is now generated in a single namespace - Added the Aspect::Library::Wantarray pointcut 0.38 Tue 19 Jan 2010 - Adam Kennedy - Added experimental support for the "highest" pointcut. - Added experimental support for the Breakpoint reusable library. 0.37 Wed 13 Jan 2010 - Adam Kennedy - Added support for "Aspect ':legacy'", which will cause the Aspect module to export functions with their original behaviours. Only the original aspect/before/after/call/cflow functions are exported and after() advice applies the same behaviour as the equivalent new-API advice function after_returning(). - To prevent hassles with Exporter (and since we need Sub::Install anyway to implement :legacy) replace all uses of Exporter with a trivial hand-rolled equivalent using Sub::Install. - Added the Aspect::Pointcut::If pointcut to match Java's equivalent if PointCut primitive. Unfortunately, since it's going to be a bit to hard to actually use "if" in a function, we will use "if_true" instead. - Added Sub::Uplevel to the list of untouchables to prevent infinite circular loops. 0.36 Wed 13 Jan 2010 - Adam Kennedy - WARNING: THIS RELEASE CONTAINS API CHANGES. To retain compatibility with previous releases, you should change all of your after() calls to after_returning() calls. - The after () advice now traps BOTH orginary return values and exceptions, as per the AspectJ implementation. - To provide a more consistent naming of pointcuts (in preparation for adding more of them) renamed the logical pointcut classes to remove the "Op" part of the class name. - Bumped Test::Exception dependency to 0.29, since it has some Sub::Uplevel fixes, and we use that heavily. 0.35 Mon 11 Jan 2010 - Adam Kennedy - Adding initial support for exceptions, with after_throwing 0.34 Sun 10 Jan 2010 - Adam Kennedy - Adding Aspect::Advice::AfterReturning before we implement exception support in the main ::After advice. 0.33 Fri 8 Jan 2010 - Adam Kennedy - Added Test::NoWarnings to all of the tests - Refactoring advice testing into one test per advice type - Testing now covers more combinations of cases, including for around() - Fixed bug in return values for listwise before () calls - Calls to run_original for advice called in void context now correctly runs the underlying hooked method in void context as well. - When called in after() or around() advice, proceed will throw an exception. - Removed some of the author tests I don't care about as much. 0.32 Thu 7 Jan 2010 - Adam Kennedy - The actual term "forever" is meaningless. Reversed the flag to be used as "lexical" instead. 0.31 Thu 7 Jan 2010 - Adam Kennedy - Removed the loading of Aspect::Library::Memoize and Aspect::Library::TestClass in 01_compile.t which was causing installation failure. 0.30 Thu 7 Jan 2010 - Adam Kennedy - Extended the forever currying support to the overall Aspect itself, and upgraded the regular Library classes to implement it properly. - Renamed the term "forever" to a more simple "global" name. - Moved Aspect::Library::Memoize into a seperate distribution to remove the Memoize dependency, which isn't 100% reliable. 0.29 Wed 6 Jan 2010 - Adam Kennedy - Added "forever currying" support. If advice is created in void context we never add the $out_of_scope hook, and as a result we don't need to save the advice object at all (and just let it immediately destroy). As well as removing the need for a bunch of the nasty curried objects, we remove an unnecesary if () test for every single call (to non-lexical hooks). 0.28 Wed 6 Jan 2010 - Adam Kennedy - Implemented Pointcut currying. The pointcut objects will optimise themselves down to just the section that should run if we assume the function was hooked correctly. This not only makes the hooks much more efficient in working out if they need to fire, but it also fixes a major bug with negative call pointcuts always causing all functions to not fire. - Resolved RT #36527 - Minor doc bug s/Profiled/Profiler/ - Moved Aspect::Library::Listenable into it's own distribution - Migrated all the tests from Test::Class to normal Test::More - Various code clean up and simplification, with less exporting - Added missing Task::Weaken dependency - Fixed, hopefully, the "variables will not remain shared" but by moving from using pure named hook functions to assigning anonymous subroutines to the typeglob instead. - Pointcuts now boolify (quickly) to true, and don't stringify to a Data::Dumper debugging spew any more. - Implemted the internals needed to support AndOp and OrOp pointcuts with more than 2 elements, so that in future long chained collections of & or | pointcuts will collapse down into a single object, instead of building as giant nested trees of boolean pairs. 0.27 Sun 3 Jan 2010 - Adam Kennedy - Various micro-optimisation of Aspect::AdviceContext which would normally be somewhat pointless, but is useful in this case when an Aspect hook is applied to something which is in the hot loop for some program. - Added a test script to specifically hunt down the problems with variable sharing in string-eval'ed closures. 0.26 Thu 31 Dec 2009 - Adam Kennedy - With the primary internals refactoring completely, we now start a series of commits to remove excessive abstractions, and to alter others to more appropriate abstractions (still without changing any of the APIs) - Cleaning up and refactoring the Aspect/Advice constructor code in Aspect.pm - Removed the weird Aspect::Advice->new( type, code, pointcut ) for a more conventional ->new setup. - Attempt to load Sub::Uplevel earlier (before we load Exporter) so there is an increased likelyhood that we don't have to reload Exporter later. - Removed redundant references to Hook::LexWrap from the POD, and removed the "Convert to Sub::Uplevel" item from the TO DO list. - Rewrote the Pointcut family of classes to have a simpler structure which should be faster. Some now use blessed ARRAYs as a preparatory step for allowing the AndOp/OrOp pointcuts to have more than just two elements (and to allow enable certain optimisation strategies down the line). - Removed the faulty Aspect::Pointcut::BinOp abstraction entirely. It was causing boolean and/or operations to always run both sides, so unlike the overloaded expression they were created from, they would never shortcut. This is now resolved, and the an/or pointcut elements now shortcut properly. 0.25 Thu 31 Dec 2009 - Adam Kennedy - Debundled various out-of-date testing libraries, and reverted to more conventional build_requires dependencies now that our downstream packaging systems have the ability to consume them. - Since the code documents the Aspect::Advice->install method as private (and it is undocumented) rename to ->_install as a precursor to changing it's behaviour at an API level. - Now that the descope execution of the closure hook is able to be trusted, we no longer need the Aspect::Cleanup DESTROY-time self-execution magick. - Added the ->wantarray property to the AdviceContext object. This is provided as a convenience to the user (since the wantarray) function works properly inside the advice code. It's main use is for some AspectContext internals. - Added wantarray context test, which uncovered a bug where void-context calls were incorrectly running the advice in scalar context. 0.24 Wed 30 Dec 2009 - Adam Kennedy - Changes file now uses tabs (to make it less annoying for me) :) - Moved the inline Aspect::Hook::LexWrap::Cleanup class into it's own dedicated Aspect::Cleanup class. - Merged Advice-specific hooks from Aspect::Hook::Lexwrap into the advice classes. - Removed the now-redundant Aspect::Hook::Lexwrap entirely - Simplified the Aspect::AdviceContext constructor to make it faster - Logically merged the code-generated functionality from ->install and the Hook::LexWrap-inspired ->hook methods for each Advice class. This removes a lot of guess work and double handling from the main execution path, and should be significantly faster. - With the code merged, pushed the scope exit flag outside the symbol table iteration in the installer. Instead of a large array of separate exit-tracking objects, we can instead use one single shared lexical hook that works via mixed depth closure Magick. - Only call wantarray once per hook execution and share the result therafter as a variable. Saves two function calls per hook. 0.23 Thu 24 Dec 2009 - Adam Kennedy - Removed the concept of a standalone Aspect::Weaver class - Each Aspect::Advice:: subclass now does most of the setup for the weaving individually, with similar but slightly different implementations. This adds some duplication of code, but removes a lot of architectural complexity. It should make the creation of new types of Advice simpler. - Corrected the versions of the test libs (which went out of sync) - The Hook::LexWrap wrap function is now split into Advice-specific hooks before and after, duplicating some code but making each type simpler and faster. 0.22 Mon 21 Dec 2009 - Adam Kennedy - Part one of an upcoming series of major upgrades - Migrating to Sub::Uplevel to remove our custom CORE::GLOBAL::caller 0.21 Tue 21 Jul 2009 - Adam Kennedy - Bumped the version to 0.21 so the Hook::LexWrap module indexes 0.16 Tue 19 May 2009 - Adam Kennedy - Moved out Aspect::Library::Profiler into a standalone distribution 0.15 Thu Jul 24 23:02:11 CEST 2008 (Marcel Gruenauer ) - fixed version in all modules. *sigh* 0.14 Thu Jul 24 22:46:43 CEST 2008 (Marcel Gruenauer ) - fixed dist style 0.13 Thu Jul 24 18:22:15 CEST 2008 (Marcel Gruenauer ) - Made sure every module has a $VERSION - updated MANIFEST and MANIFEST.SKIP - removed META.yml as it is being generated by Module::Install - added requirements to Makefile.PL - converted Makefile.PL to use Module::Install - Aspect::Hook::LexWrap now uses warnings and strict; some changes were necessary for those to go through - fixed POD error in Aspect::Modular - added spaces where necessary to avoid having the template's start_tag in the code - renamed t/all_tests.t to t/01_all.t - added t/perlcriticrc - added .shipit - set version to 0.13 - updated MANIFEST - updated t/perlcriticrc 0.12 Sat, 24 Mar 2007 00:00:00 +0100 (Ran Eilam ) - You can now attach advice to subs in main:: package, see Advice tests - Made everything easier to install by including dependencies required for testing - Added __always_fire option to Listenable - Listenable: You can now let listeners receive any parameters, not just the event, see the test object_listener - Modified our hack on Hook::LexWrap so it does not ignore prototypes, see Advice tests - Removed old warning from Makefile.PL 0.11 Tue, 03 Aug 2004 00:00:00 +0100 (Ran Eilam ) - Fixed problem in upgrading from 0.08, CPAN.pm was getting confused on Advice and Modular, because they had no version numbers, and undef is smaller than 0.08. (merlyn) - Lowered dependency on Test::Class to 0.03 0.10 Fri, 30 Jul 2004 00:00:00 +0100 (Ran Eilam ) - No longer a developer release - Added Listenable reusable aspect - Added subject_params() support for TestClass library aspect 0.09_03 Tue, 06 Jul 2004 00:00:00 +0100 (Ran Eilam ) - Added Carp::Heavy to list of untouchables in Weaver.pm, to avoid Carp dumping core - Test::Class aspect allows for customizing IUT through init_subject_state 0.09_02 Sat, 06 Mar 2004 00:00:00 +0100 (Ran Eilam ) - AdviceContext now has the original code, so you can do AspectJ-style around advice. You can call the original code from before or after advice. Added AdviceContext::run_original. - Memoize can memoize in any context, not just scalar, again - Added Test::Class helper aspect - Started using Devel::Symdump 0.09_01 Sat, 06 Mar 2004 00:00:00 +0100 (Ran Eilam ) - Released for review by participants in YAPC::Israel 2004 - New syntax is incompatible with old - New maintainer, Ran Eilam - Control flow pointcut: cflow(), done according to Marcel's design - Advice context trapping for control flow pointcuts - Use Test::Class for unit tests - Wormhole reusable aspect - Added prototypes so you can dispense with parentheses - Removed return/around pointcuts, added after advice - Removed attribute interface - Added a mutated version of Hook::LexWrap with support for appending/removing arguments - Moved reusable aspects to Aspect::Library - regression: Aspect exported subs generate join points again 0.07 Wed, 31 Jul 2002 22:42:27 +0200 (Marcel Gruenauer ) - The distribution has been adapted for use with perl5.8.0. C is now a core module, but there was a problem with context (wantarray) handling with Aspect::Memoize. Sorry about the perl 5.6.x users, but this is bleeding-edge stuff, so you're expected to use the very latest gear. Anyway, you can still get an earlier version (up to 0.07) from CPAN, which will work with perl 5.6.x. - Aspect::Memoize is now intended for subroutines returning scalars only. That is, if the sub is called in list context, it will still only memoize, and return, a memoized scalar. Void context obviously doesn't matter when it comes to memoization; subroutines returning lists are something I have to think about. - Tests now use Test::More 0.07 Fri, 15 Mar 2002 09:04:51 +0100 (Marcel Gruenauer ) - symbols exported from Aspect.pm now don't generate join points. So I added Aspect::import() and modified Aspect::JoinPoint::enum() to check for %Aspect::exp_syms. 0.06 Fri, 26 Oct 2001 16:42:51 +0200 (Marcel Gruenauer ) - added around() function to Aspect.pm - added Aspect::Profiled - added Aspect::Attribute interface to creating advice - made Aspect::Advice's enable() and disable() return $self - added cookbook example program callflow_attr.pl - added cookbook recipes for bounds checking and change tracking, plus sample programs 0.05 Thu, 11 Oct 2001 09:44:50 +0200 (Marcel Gruenauer ) - removed dependency on Data::Denter 0.04 Mon, 01 Oct 2001 18:33:00 +0200 (Marcel Gruenauer ) - removed the patched Hook::LexWrap now that 0.20 is out which fixes all the problems of 0.10 - added documentation (a recurring theme, never finishes) 0.03 Sun, 30 Sep 2001 19:43:56 +0200 (Marcel Gruenauer ) - added documentation - Included a patched Hook::LexWrap that fixes a bug with wantarray preservation in subroutine wrappers. Will be removed if and when Damian approves of the patch or otherwise fixes the bug. 0.02 Fri, 28 Sep 2001 12:59:06 +0200 (Marcel Gruenauer ) - added documentation - added '$::thisjp' global variable - added modular memoization aspect: Aspect::Memoize - added modular tracing aspect: Aspect::Trace 0.01 Fri, 28 Sep 2001 10:36:08 +0200 (Marcel Gruenauer ) - original version