lib/Catalyst/Delta.pod

   1 =head1 Delta changes from 5.7 to 5.8
   2
   3 This is an overview of the user visible changes in 5.8.
   4
   5 =head2 Deprecations
   6
   7 Please see L<Catalyst::Upgrading> for a full description of how changes in the
   8 framework may affect your application.
   9
  10 Below is a brief list of features which have been deprecated in this release:
  11
  12 =over
  13
  14 =item ::[MVC]:: style naming scheme has been deprecated and will warn
  15
  16 =item NEXT is deprecated for all applications and components, use MRO::Compat
  17
  18 =item Dispatcher methods which are an implementation detail made private, public versions now warn.
  19
  20 =item MyApp->plugin method is deprecated, use L<Catalyst::Model::Adaptor> instead.
  21
  22 =item __PACKAGE__->mk_accessors() is supported for backward compatibility only, use Moose attributes instead in new code.
  23
  24 =item Use of Catalyst::Base now warns
  25
  26 =back
  27
  28 =head2 New features
  29
  30 =head3 Dispatcher
  31
  32 =over
  33
  34 =item Fix forwarding to Catalyst::Action objects.
  35
  36 =item Add the dispatch_type method
  37
  38 =back
  39
  40 =head3 Restarter
  41
  42 The development server restarter has been improved to be compatible with
  43 immutable Moose classes, and also to optionally use
  44 L<B::Hooks::OP::Check::StashChange> to handle more complex application layouts
  45 correctly.
  46
  47 =head3 $c->uri_for_action method.
  48
  49 Give a private path to the Catalyst action you want to create a URI for.
  50
  51 =head3 Logging
  52
  53 Log levels have been made additive.
  54
  55 =head3 L<Catalyst::Test>
  56
  57 =over
  58
  59 =item Change to use L<Sub::Exporter>.
  60
  61 =item Support mocking multiple virtual hosts
  62
  63 =item New methods like action_ok and action_redirect to write more compact tests
  64
  65 =back
  66
  67 =head3 Catalyst::Response
  68
  69 =over
  70
  71 =item *
  72
  73 New print method which prints @data to the output stream, separated by $,.
  74 This lets you pass the response object to functions that want to write to an
  75 L<IO::Handle>.
  76
  77 =item *
  78
  79 Added code method as an alias for C<< $res->status >>
  80
  81 =back
  82
  83 =head2 Consequences of the Moose back end
  84
  85 =over
  86
  87 =item *
  88
  89 Components are fully compatible with Moose, and all Moose features, such as
  90 method modifiers, attributes, roles, BUILD and BUILDARGS methods are fully
  91 supported and may be used in components and applications.
  92
  93 =item *
  94
  95 Many reusable extensions which would previously have been plugins or base
  96 classes are better implemented as Moose roles.
  97
  98 =item *
  99
 100 L<MooseX::MethodAttributes::Inheritable> is used to contain action
 101 attributes. This means that attributes are represented in the MOP, and
 102 decouples action creation from attributes.
 103
 104 =item *
 105
 106 There is a reasonable API in Catalyst::Controller for working with
 107 and registering actions, allowing a controller sub-class to replace
 108 subroutine attributes for action declarations with an alternate
 109 syntax.
 110
 111 =item *
 112
 113 Refactored capturing of $app from L<Catalyst::Controller> into
 114 L<Catalyst::Component::ApplicationAttribute> for easier reuse in other
 115 components.
 116
 117 =item *
 118
 119 Your application class is forced to become immutable at the end of compilation.
 120
 121 =back
 122
 123 =head2 Bug fixes
 124
 125 =over
 126
 127 =item *
 128
 129 Don't ignore SIGCHLD while handling requests with the development server, so that
 130 system() and other ways of creating child processes work as expected.
 131
 132 =item *
 133
 134 Fixes for FastCGI when used with IIS 6.0
 135
 136 =item *
 137
 138 Fix a bug in uri_for which could cause it to generate paths with multiple
 139 slashes in them.
 140
 141 =item *
 142
 143 Fix a bug in Catalyst::Stats, stopping garbage being inserted into
 144 the stats if a user calls begin => but no end
 145
 146 =back
 147