X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=TODO;h=a36cf246683692d0cc1137d47e024eaafeeeafa1;hb=18b28ba887282651b2c4e3cf4cf2e8cc49e05d9e;hp=242c278eda5d4a7e224721974e35f14f8b36969e;hpb=17265e0312d2a6d73d81e310f99cd7889f94b21b;p=gitmo%2FMoose.git diff --git a/TODO b/TODO index 242c278..a36cf24 100644 --- a/TODO +++ b/TODO @@ -1,4 +1,14 @@ -== Todo for 2.0200 +== Todo for 2.0400 + +=== RT Tickets + +RT#59478/RT#63000 - 0+ overload causes NV conversion on == on perls before +5.14 - this causes comparisons to fail when the number can't fit in an NV +without precision loss. I'd like to fix this in a more general way (forcing +anyone else who might be using == on tc objects to do weird things isn't very +good), although it's hard to test to see what actually works. + +== Todo for 2.0600 === Revise MetaRole API to reunify class/role metaroles: @@ -24,11 +34,292 @@ role_attribute, role_method, etc. key. The common case will be that the metaroles are intended for the consuming class, but we should allow for metaroles on the role's metaobjects as well. -=== Remove a bunch of deprecated crap +=== Deprecate old-style Moose extensions + +Moose extensions that work by calling Moose->init_meta(metaclass => +'Some::Custom::Metaclass', ...) during their own init_meta should be +deprecated, so they can be removed later (this should fix the issues with +init_meta generation in Moose::Exporter, see RT51561) + +This needs to wait until the previous fix gets in, since it will hopefully eliminate the need to write custom init_meta methods entirely. + +=== Attributes in roles need to be able to participate in role composition + +Right now, this fails with no decent workaround: + + package R1; + use Moose::Role; + has foo => (is => 'ro'); + + package R2; + use Moose::Role; + with 'R1'; + requires 'foo'; + + package C; + use Moose; + with 'R2'; + +Role attributes really need to be able to participate in role-role combination. +This should also fix "with 'Role1', 'Role2'" being broken when Role1 implements +a method as an accessor and Role2 requires that method, but at least in that +case you can split it into two 'with' statements with minimal loss of +functionality. + +=== Method modifiers in roles should silently add 'requires' for them + +This shouldn't be a functionality change, just a better error message (and +better introspectability). This shouldn't happen if the role already contains a +method by that name, so it'll depend on the previous fix going in (so "has foo +=> (is => 'ro'); around foo => sub { }" doesn't produce a 'requires' entry). + +=== Add overloading support + +or at least, don't break existing overloading support + +This shouldn't treat the overloading stuff as actual methods, since that's just +an implementation detail, but we should provide an API for add_overload, +get_overload, get_overload_list, etc. In particular, this would allow +namespace::autoclean to not break things. + +Also, MooseX::Role::WithOverloading should probably be cored. + +This should probably also wait for the metarole unification fix, to avoid the +::WithOverloading stuff being too insane. + + +== Todo for later + +=== has +foo in roles + +There's no actual reason for this not to work, and it gets asked often enough +that we really should just do it at some point. + +=== Actual API for metaclass extensions + +Right now, the only way to bundle multiple metaclass traits is via +Moose::Exporter. This is unhelpful if you want to apply the extension to a +metaclass object rather than a class you're actually writing. We should come up +with an API for doing this. + +=== MooseX::NonMoose in core + +I think all of the actual issues are solved at this point. The only issue is +the (necessary) implementation weirdness - it sets up multiple inheritance +between the non-Moose class and Moose::Object, and it installs a custom +constructor method at 'extends' time (although perhaps this could be solved by +moving some of the logic back into Moose::Object::new?). Other than that, it +handles everything transparently as far as I can tell. + +=== Fix attribute and method metaclass compatibility + +So i got this wrong when rewriting it last year - right now, metaclass compat +checks the default attribute and method metaclasses, which is wrong. This means +that if a parent class does "use MooseX::FollowPBP", then attributes declared +in a subclass will get PBP-style accessors, which is quite surprising. + +On the other hand, sometimes metaclasses might need to be able to say "I'm +going to assume that all of my attributes at least inherit from this custom +class", so we might need to split it into "default specified by the user" and +"default specified by the metaclass" and only do compat checking on the second? +I'm not actually sure this is a valid use case though. + +Something that probably should be taken into account though is attributes and +methods that extend existing attributes or methods from a superclass should +inherit the metaclass of the existing one. Also not sure if this is correct, +but something to think about. + +=== Rename a bunch of the public API methods + +Right now the public API is kind of a mess - we have things like get_method vs +find_method_by_name (you almost always want to use the latter), there being no +has_method equivalent that checks superclasses, get_method_list being public +but only returning method names, while _get_local_methods is private (returning +method objects), and yet neither of those looks at superclasses, and basically +none of this naming follows any kind of consistent pattern. + +What we really need is a consistent and easy to remember API where the method +that people would think to use first is the method that they actually mean. +Something like renaming find_method_by_name to find_method, and get_method to +find_local_method or something along those lines. + +=== use Sub::Identify instead of doing our own thing with get_code_info + +No idea why we stopped using Sub::Identify in the past, but there's no reason +not to do this. We have a bug fix in our version (the isGV_with_GP thing), so +this should be submitted to Sub::Identify first. + +=== Move method modifiers out to an external module + +Class::Method::Modifiers uses a different method for doing method modifiers, +which I'm not sure why we aren't using in Moose right now. Optionally using +Class::Method::Modifiers::Fast would be even better - it uses Data::Util to +implement XS method modifiers, which could help things a lot. + +=== Move type constraints out to an external module + +There's nothing about our type constraint system that requires being tied to +Moose - it's conceptually an entirely separate system that Moose just happens +to use. Splitting it out into its own thing (that Moose could extend to add +things like role types) would make things conceptually a lot cleaner, and would +let people interested in just the type system have that. + +=== Merge Class::MOP and Moose + +This is a long term goal, but would allow for a lot of things to be cleaned up. +There's a bunch of stuff that's duplicated, and other stuff that's not +implemented as well as it could be (Class::MOP::Method::Wrapped should be a +role, for instance). + + +== Things to contemplate + +=== Does applying metaroles really need to reinitialize the metaclass? + +Seems like the logic that's actually necessary is already contained in +rebless_instance, and not reinitializing means that existing attributes and +methods won't be blown away when metaroles are applied. + +=== Do we want to core namespace::autoclean behavior somehow? + +This would add Variable::Magic as a required XS dep (not a huge deal at the +moment, since Sub::Name is also a required XS dep, but it'd be nice for Moose +to be able to be pure perl again at some point in the future, and I'm not sure +what the relative chances of Sub::Name vs Variable::Magic making it into core +are). If we enabled it by default, this would also break things for people who +have introduced Moose into legacy-ish systems where roles are faked using +exporters (since those imported methods would be cleaned). + +If we decide we want this, we may want to core it as an option first ("use +Moose -clean" or so), and move to making it the default later. + +=== Fix the error system + +oh god it's terrible + +More specifically, we really want exception objects. + +=== Should using -excludes with a role add 'requires' for excluded methods? + +It seems to make sense, since otherwise you're violating the role's API +contract. + + +== TODO test summary + +Note that some of these are fairly old, and may not be things we actually want +to do anymore. + +=== t/basics/basic_class_setup.t + +Imports aren't automatically cleaned. Need to think about bringing +namespace::autoclean functionality into core. + +=== t/bugs/create_anon_recursion.t + +Loading Moose::Meta::Class (or probably a lot of other metaclasses) before +loading Moose or Class::MOP causes issues (the bootstrapping gets confused). + +=== t/bugs/handles_foreign_class_bug.t + +There should be a warning when delegated methods override 'new' (and possibly +others?). + +=== t/bugs/role_caller.t + +Role methods should be cloned into classes on composition so that using +caller(0) in a role method uses the class's package, not the role's. + +=== t/cmop/metaclass_incompatibility.t + +If a child class is created before a parent class, metaclass compatibility +checks won't run on the child when the parent is created, and so the child +could end up with an incompatible metaclass. + +=== t/cmop/modify_parent_method.t + +Modifying parent class methods after a child class has already wrapped them +with a method modifier will cause the child class method to retain the original +method that it wrapped, not the new one it was replaced with. + +=== t/immutable/inline_close_over.t + +Initializers and custom error classes still close over metaobjects. +Initializers do it because the initializer has to be passed in the attribute +metaobject as a parameter, and custom error classes can't be automatically +inlined. + +=== t/metaclasses/moose_exporter_trait_aliases.t + +Renamed imports aren't cleaned on unimport. For instance: + + package Foo; + use Moose has => { -as => 'my_has' }; + no Moose; + # Foo still contains my_has + +=== t/metaclasses/reinitialize.t + +Special method types can't have method metaroles applied. Applying a method +metarole to a class doesn't apply that role to things like constructors, +accessors, etc. + +=== t/roles/compose_overloading.t + +Overload methods aren't composed during role composition (this is detailed +above - Add overloading support). + +=== t/roles/method_modifiers.t + +Method modifiers in roles don't support the regex form of method selection. + +=== t/roles/role_compose_requires.t + +Accessors for attributes defined in roles don't satisfy role method +requirements (this is detailed above - Attributes in roles need to be able to +participate in role composition). + +=== t/todo_tests/exception_reflects_failed_constraint.t + +Type constraint failures should indicate which ancestor constraint failed - +subtype 'Foo', as 'Str', where { length < 5 } should mention Str when passed an +arrayref, but not when passed the string "ArrayRef". + +=== t/todo_tests/moose_and_threads.t + +On 5.8, the type constraint name parser isn't thread safe. + +=== t/todo_tests/replacing_super_methods.t + +Modifying parent class methods after a child class has already wrapped them +with a override will cause 'super' in the child class to call the original +parent class method, not the one it was overridden with. + +=== t/todo_tests/required_role_accessors.t + +Role attribute accessors don't satisfy requires from roles they consume. + +=== t/todo_tests/role_insertion_order.t + +Roles don't preserve attribute insertion_order. + +=== t/todo_tests/various_role_features.t + +* Role attribute accessors don't satisfy requires from roles they consume. +* Role combination should produce a conflict when one role has an actual method + and the other role has an accessor. +* Role attribute accessors should not override methods in the class the role is + applied to. +* Role attribute accessors should be delegated when a class does + handles => 'Role'. +* Delegating to a role doesn't make $class->does('Role') true. +* Method modifier in a role doesn't create a method requirement. +* Role->meta->has_method('attr_accessor') is false. + +=== t/type_constraints/type_names.t + +Type constraint object constructors don't validate the type name provided. -See Moose::Manual::Delta for a list. Some of this is important to make merging -Class::MOP into Moose core much easier. Other is just removing complexity -needed to support ancient APIs. == Old todo (does anyone look at this?) @@ -105,6 +396,80 @@ over there.. in that other object [13:32] mst etc. [13:53] stevan hmm +----------------------------------------------------------- +-- Type Constraints refactor +----------------------------------------------------------- + +- add support for locally scoped TC + +This would borrow from MooseX::TypeLibrary to prefix the TC with the name +of the package. It would then be accesible from the outside as the fully +scoped name, but the local attributes would use it first. (this would need support +in the registry for this). + +- look into sugar extensions + +Use roles as sugar layer function providers (ala MooseX::AttributeHelpers). This +would allow custom metaclasses to provide roles to extend the sugar syntax with. + +(NOTE: Talk to phaylon a bit more on this) + +- allow a switch of some kind to optionally turn TC checking off at runtime + +The type checks can get expensive and some people have suggested that allowing +the checks to be turned off would be helpful for deploying into performance +intensive systems. Perhaps this can actually be done as an option to make_immutable? + +- misc. minor bits + +* make the errors for TCs use ->message +* look into localizing the messages too +* make ANON TCs be lazy, so they can possibly be subsituted for the real thing later +* make ANON TCs more introspectable +* add this ... + +# +# Type Definition +# +subtype 'Username', + from 'Str', + where { (/[a-z][a-z0-9]+/i or fail('Invalid character(s)')) + and (length($_) >= 5 or fail('Too short (less than 5 chars)')) + } +on_fail { MyException->throw(value => $_[0], message => $_[1]) }; + +# fail() will just return false unless the call is made via +$tc->check_or_fail($value); + +* and then something like this: + +subtype Foo => as Bar => where { ... } => scoped => -global; +subtype Foo => as Bar => where { ... } => scoped => -local; + +# or + +subtype Foo => as Bar => where { ... } => in __PACKAGE__ ; + +# or (not sure if it would be possible) + +my $Foo = subtype Bar => where { ... }; + +# ---------- + +[17:10] stevan: it should do it if I pass coerce => 1 as part of the attribute definition +[17:12] autarch: what I am not 100% sure of is how to tell it to deep coerce and when to not +[17:13] cause a basic coerce is from A to B +[17:13] hmm +[17:13] which is valid for collection types too +[17:13] deep coercion is what you are asking for +[17:13] yeah +[17:13] so perhaps we add deep_coerce => 1 +[17:13] which will do it +[17:13] that's fine for me +[17:13] k + +coerce_deeply => 1 # reads better + ------------------------------------------------------------------------------- INTERNALS -------------------------------------------------------------------------------