Revision history for CGI::Application.

4.50 Thu Jun 16, 2011

[FEATURES]
Better PSGI support in the core

• run_as_psgi() works like run, but directly returns the expected PSGI response structure
• psgi_app() wraps up all the PSGI bits to call and run the application and return a PSGI code ref:

$psgi_coderef = WebApp->psgi_app({ ... args to new() ... });

[DOCUMENTATION]

• docs for header_props() were improved

[INTERNAL]

• source control management was moved from darcs to git. Those who prefer darcs are are more familiar with it are advised to try the darcs-git.py wrapper for git.
• The test file psgi_app.t is missing from this release and will be added later.

4.31 Wed Jul 29, 2009

[FEATURES]

• html_tmpl_class() now allows setting an an alternate HTML::Template class at a run time. This makes it easy to set the class to be 'HTML::Template::Dumper' for debugging. You can then see and precisely test the Perl data structure that would be sent your template, taking into account the template tokens that are actually set there. (Mark Stosberg)

[DOCUMENTATION]

• More typo fixes (Lyle)

4.21 Sat Jan 3, 2009

[FEATURES]

• This now works:

  $webapp->query($new_query_object); Setting a new query object can be useful in combination with CGI::Application::Server. (Jaldhar Vyas)

[DOCUMENTATION]

• More typo fixes (Lyle)

4.20 Sat Nov 1, 2008

[DOCUMENTATION]

• typo fix (Lyle)

4.19_1 Fri Sep 27, 2008

[FEATURES]

• New 'html_tmpl_class' method allows you to specify an alternative HTML::Template class. This technique will eliminate the need to use a plugin for HTML::Template-compatible classes. See the docs for load_tmpl() for details.

      Thanks to Rhesa Rozendaal for the initial patch, and Mark Stosberg for
      documentation refinements.

[DOCUMENTATION]

• typo fix (George Hartzell)
• Revert back to documenting the use of "$self", not $c, after community feedback.

[INTERNALS]

• Change how default run modes are declared for better compatibility with AutoRunmode and RunmodeDeclare plugins. Thanks Rhesa via RT#39631.

4.11 Sun Aug 10, 2008

No code changes.

[DOCUMENTATION]

• Fix POD syntax issue.

4.10 Tue Jun 17, 2008

This release maintains the same API public from 4.06. Changes since the last stable release include documentation updates and refactors to the internal of CGI::Application.

[DOCUMENTATION]
Several documentation improvements (Mark Stosberg)

• Reformat POD so methods are easier browse on CPAN
• Highlight some specific, common plugins to use
• Mention that we now have two CGI::App specific testing tools to use Test::WWW::Mechanize::CGIApp and Test::WWW::Selenium::CGIApp
• Introduce and recommend CGI::Application::Dispatch
• Consolidated the documentation on error_mode()
• Split out those application methods which are essential from those that are not.
• Use and recommend "$c" instead of "$self" to cut down on typing for something that is abstract anyway, and represented a simple "." in Perl 6.
• Mention CGI::Application::Server for offline website development.
• Update the introduction to clarify that we are a proven, lightweight option.
• Removed the "experimental" flag on the error hook.
• Mention in the second Perl.com article in the "more reading" section.
• Document darcs repo URL. (Suggested by Gabor)

4.07_03 Mon Jun 16, 2008

[INTERNALS]

• The refactor to split up run() in 4.07_01 started to always pass the run mode name as an argument to run modes. The behavior has now been reverted to only pass the run mode name in the AUTOLOAD case. (Mark Stosberg)

[DOCUMENTATION]

• Fix typo in example. Thanks to Lesley Binks.
• document that header_props() can be usefully called with no arguments to return the current headers. Thanks to neuhaus, RT#33992.

4.07_02 Weds Oct 31, 2007

[DOCUMENTATION]

• typo corrections (Evan Zacks)
• The docs for header_type() have been improved, including an example of using CGI::Applicatin::Plugin::Redirect (Mark Stosberg)

[INTERNALS]

• Reverted switch to Class::MOP in 4.07_01, which benchmarking showed to be slower. (Mark Stosberg)
• Beautify the code for sendheaders (Chris Dolan, Mark Stosberg)

4.07_01 Sun Jul 2, 2006

[INTERNALS]

• Switched from using Class::ISA to Class::MOP for introspection. Class::MOP models the way this will be done Perl6, providing the same result. (Mark Stosberg)
• better test diagnostics (rjbs)
• improve test coverage (rjbs)
• improve consistency of checks for false/0len/undef (rjbs)
• split &run up into chunks (not yet finalized). New methods currently include: __get_runmode __get_runmeth __get_body Feedback is welcome on whether these should be exposed to the user, with (possibly) better names. (rjbs)

4.06 Wed Apr 12, 2006

(No code changes)

• Updated tests to work with status codes emitted before and after CGI.pm 3.16. The requirement for CGI.pm 3.16 or newer has been relaxed, so any version of CGI.pm will do. (Rhesa)

4.05 Wed Mar 1, 2006

(No code changes)

• Updated tests for redirects to check for 'Found', not 'Moved'. This correctly matches the standard, and was changed in CGI.pm 3.16. As a result, we now require CGI.pm 3.16 for consistent results.

4.04 Wed Oct 11, 2005

• No code changes since 4.04_02. Declaring stable.

4.04_02 Thu Sep 8, 2005

• Add support for templates stored in file handles and scalarrefs to load_tmpl(). (Jason Purdy)

4.04_01 Wed Aug 31, 2005

• move load_tmpl hook to after we build $tmpl_file so it will always have a (probably) valid file to work with.
• initial support for a default template name in load_tmpl(). That means you can now do this:

my $t = $self->load_tmpl();

      And it will default to a file named after the current run mode with a
      .html extension. 

4.03 Thu Aug 04, 2005

• Fixed important bug introduced in 4.02 in which a mode_param set in a sub-class would have been ignored. A new automated test was added to prevent this regression in the future.

4.02 Sat Jul 30, 2005

• Documented existence of CGI::Application::Plugin::FillInForm.
• path_info option to mode_param now supports negative index numbers to grab the run mode name from the other end of the PATH_INFO. (Thilo Planz)
• Altered how "start_mode" default is set, allowing it to be set through the hook system in the 'init' phase. Existing applications should be unaffected.
• Return value of run_modes() was documented.
• Integrate more examples of using plugins into the documentation.
• 'error' hook was added, which is executed just before error_mode() might be called. An example use of this would be a logging plugin that wants to log that the application died. Although it's unlikely to change, it is marked as experimental for now.

4.01 Tue Jun 14, 2005

NOTE: This release has an important incompatibility from the 4.0 release two days ago. The 'load_tmpl' hook which was just introduced has had it's interface changed. The change allows plug-in authors to affect the parameters passed to the 'new' constructor of the template object, instead of just adding parameters later.

4.0 Fri Jun 10, 2005

This release adds a major new feature of special interest to plugin authors: 'hooks'. This concept helps to create plugins that are more powerful and simpler to use for end users. See the documentation on writing plugins for details.

Special thanks to Cees Hek and Michael Graham for their effort to develop and refine the hook system.

Since the last major release, there has been an explosion of new plugins developed. This is an incomplete list of modules below the 'CGI::Application::Plugin' namespace. Expect more to be added and updated soon with the advent of the hook system:

      ::AnyTemplate - Use any templating system with a unified interface 
      ::Apache - Use Apache::* modules without interference
      ::AutoRunmode - Automatically register runmodes
      ::ConfigAuto - Integration with Config::Auto
      ::Config::Context - Integration with Config::Context
      ::Config::General - Integration with Config::General
      ::Config::Simple - Integration with Config::Simple
      ::CompressGzip - Add Gzip compression 
      ::DBH - Integration with DBI
      ::LogDispatch - Integration with Log::Dispatch
      ::Session - Integration with CGI::Session
      ::Stream - Help stream files to the browser
      ::TT - Use Template::Toolkit as an alternative to HTML::Template
      ::ValidateRM - Integration with Data::FormValidator and HTML::FillInForm

The following additional changes are also present in this release:

• Enhanced tests and documentation for error_mode(). (Rob Kinyon).
• Clarified Plug-in documentation (Timothy Appnel)
• Avoid some warnings when getting run mode from PATH_INFO (Emanuele Zeppieri)
• Use query() object to get PATH_INFO, to workaround bug in IIS web server. (Mark Stosberg)
• Documented return value of header_props()

3.31 Sun Sep 26, 2004

• Documentation clean-ups. No code changes.

3.30 Sun Sep 26, 2004

• Refactored test suite to use Test::More (Gabor Szabo)
• Removed warnings being emitted for documented API calls
• minor code clean-up to load_tmpl() (Emanuele Zeppieri)
  • Support for passing multiple template paths to HTML::Template (Michael Peters)
  • Added error_mode to support trapping runmodes dying (Rob Kinyon)
  • Added Plug-in related documentation. (Mark Stosberg)
  • mode_param() updated to more easily set the run mode from $ENV{PATH_INFO} (Mark Stosberg)

3.22 Fri Feb 13, 2004

• The nocgicarp flag introduced in 3.2 has now been removed due to ill importing side effects. Instead, we now simply use Carp instead of CGI::Carp. You must now explicitly load CGI::Carp if you want it. Any code that used the brief-lived 'nocgicarp' feature will need to be updated.
• Support for run modes named '0'. (Josh Glover)

3.21 Wed Feb 4, 2004

• Updated some header tests to be compatible with old and new versions of CGI.pm, which handled the capitalization of the header differently. (Mark Stosberg)

3.2 Sat Jan 31, 2004

• header_add() has been added to allow setting extra headers, particularly cookies, after header_props has already been called (Cees Hek, Mark Stosberg)
• CGI::Carp is now optional. See docs for details. (Steve Hay)
• Avoid 'unitialized value' warning on redirects (Cees Hek)
• Some tests added (Mark Stosberg)
• Updated documentation to use term "Run Mode" consistently, versus "Run-Mode" with a dash. Run-mode-with-a-dash is dead. Don't revive it. Also added mentions of the CGI::Application wiki and CGI::Application::ValidateRM (Mark Stosberg)
• Fixed typo in cgiapp_postrun documentation (Steve Hay)
• Improved exception handling (Steve Hay)
• delete() method added to remove items stored using param() (Michael Peters)
• 'CGI_APP_RETURN_ONLY' environment variable that is used for testing is now documented (Michael Peters)
• dump_html() is now properly HTML-escaped (podmaster, Brian Cassidy)
• Migrated from Makefile.PL to Build.PL. Either can now be used for installation.
• Updated 'Changes' file to put new releases on top.

3.1 Mon Jun 2 07:54:31 EDT 2003

• Changed dump_html default run mode to be referenced by name instead of sub-ref. This allows dump_html() to be overridden in sub-class.
  • Added current run mode to output of dump() and dump_html(). (Thanks to Mark Stosberg for the suggestion.)
  • Added example of doing an HTTP redirect (suggested by Sam Tregar)
  • Fixed bug where non-CGI.pm query objects couldn't be set at initialization time via the new() method. (Thanks to Steve Hay for the catch.)
• Added header_type("none") to surpress HTTP header output. (Thanks to Steve Comrie for the suggestion.)
• Numerous typos corrected in POD.
• Added cgiapp_postrun() hook. This hook allows run mode output to be "pipelined" through optional filters, modifying the content and HTTP headers if so desired.

3.0 Sat Feb 1 02:27:19 EST 2003

• Changed run_modes() method to allow list of run modes to be designated via an array reference. This will automatically create a run modes table which maps from a run mode to a run mode method of the same name. Bumped major revision number to reflect this significant change in functionality.
• Clarified license for module (GPL or Artistic). Included licenses in distribution package.

2.6 Mon Oct 7 07:34:35 EDT 2002

• Changed the run() method to use Perl's built-in dynamic method call for all run modes, whether by name or by code ref. This is intended to improve run-time performance somewhat. Thanks to Darin McBride for this patch.
• Added new override-able method cgiapp_get_query(). This method is called when CGI::Application first needs access to the CGI query object. By default, this is a CGI.pm object. It is possible to override the cgiapp_get_query() method to return an object of some other module besides CGI.pm, providing that it is sufficiently compatible. Thanks to Eric Andreychek for the suggestion and his help troubleshooting the code.

2.5 Thu Jul 18 07:45:47 EDT 2002

• Changed mailing list address. The new mailing list address. To subscribe: cgiapp-subscribe@lists.erlbaum.net To post message: cgiapp@lists.erlbaum.net

2.4 Sat May 25 13:32:44 EDT 2002

• Modified tmpl_path() to propagate to HTML::Template's PATH parameter. This provides much more useful and intuitive behavior. Thanks to Sam Tregar for the patch!
• Added prerun_mode() method to allow the run mode to be dynamically changed inside the cgiapp_prerun() method. Thanks to Steve Comrie for the suggestion of using a method call for this function. Thanks to many other list members for further refining this idea.
• Refactored some test cases, general code clean-up.
• Refactored POD a bit to make it less intimidating for new users.

2.3 Mon May 6 07:12:09 EDT 2002

• Fixed minor bug in build system for older Perl versions.

2.2 Sun Aug 19 12:20:21 EDT 2001

• Added new module CGI::Application::Mailform as both an example of how to use CGI::Application and a useful (albeit simple) reusable web-based application.
• CGI::Application::Mailform allows the contents of data submitted through HTML forms to be easily sent via email to a specified recipient. This application is intended to be very easy to reuse, yet secure and functional enough to replace some of the most onerous "mailform" scripts which have been floating around the Internet for ages.
• Added cgiapp_prerun() hook, for adding global behaviors before the run mode method is called. The cgiapp_prerun() gets the name of the run mode as a parameter. This would allow the user to perform some action based on the current run mode.

2.1 Sat Aug 11 12:57:49 EDT 2001

• The param() method has been extended to allow multiple parameters to be set at one time, via a hash (or hashref).
• Fixed bug in run() method where a null-string run mode would be considered valid. A zero-length run mode will now result in the start_mode() being called. (Thanks to Mark Stosberg for the two preceding ideas!)
• The run_mode() method now may be called a subsequent time to amend the list of run modes.

2.0 Sun Jun 24 23:01:58 EDT 2001

• Added ability to set mode_param() to use a call-back instance method (specified by subref) instead of a CGI parameter.
• HTML::Template is now only loaded if load_tmpl() is called. (Thanks to Stephen Howard for the two preceding ideas!)
• Run modes may now return scalar-refs in addition to scalars.
• Added new run mode of last resort: "AUTOLOAD". See POD for usage.
• Updated MAJOR REVISION number to 2 -- new functionality deserves it.

1.31 Mon May 28 14:06:16 EDT 2001

• Updated docs to favor new name-based run mode method references.

1.3 Sun May 20 18:48:36 EDT 2001

• Enhanced capabilities for creating general superclasses for your projects.
• All run modes may be referenced by method name, in addition to subref.
• Created cgiapp_init() hook to allow for inherited common behaviors.
• Fixed minor bugs in default values.

1.2 Fri Jul 14 01:49:30 EDT 2000

• Modified load_tmpl() to pass extra params to HTML::Template->new_file().
• Fixed up the docs a bit.
• Minor code clean-up.

1.1 Tue Jul 11 22:59:17 EDT 2000

• Tweaked test.pl to avoid CGI.pm command line debugging interface which requires user to hit CTRL-D to continue
• Added ANNOUNCE file.

1.0 Mon Jul 10 23:47:30 2000

• Release 1.0 complete. Woohoo!

0.01 Mon Jul 3 20:40:30 2000

• original version; created by h2xs 1.19