+++ /dev/null
-use strict;
-use warnings;
-use inc::Module::Install;
-use Module::Install::AuthorRequires;
-use Module::Install::AuthorTests;
-
-perl_version '5.8.1';
-
-name 'Catalyst-Action-REST';
-all_from 'lib/Catalyst/Action/REST.pm';
-
-requires 'Moose' => '1.03';
-requires 'namespace::autoclean';
-requires('Catalyst::Runtime' => '5.80030');
-requires('Params::Validate' => '0.76');
-requires('Module::Pluggable::Object' => undef);
-requires('LWP::UserAgent' => '2.033');
-requires('Class::Inspector' => '1.13');
-requires('URI::Find' => undef);
-requires('MRO::Compat' => '0.10');
-
-requires 'namespace::autoclean';
-test_requires 'Test::More' => '0.88';
-test_requires 'Test::Requires';
-
-author_requires 'Test::Pod' => 1.14;
-author_requires 'Module::Info';
-author_requires 'File::Find::Rule';
-
-author_tests 'xt/';
-
-feature 'JSON (application/json) support',
- -default => 0,
- 'JSON' => '2.12',
- 'JSON::XS' => '2.2222';
-
-author_requires 'JSON' => '2.12';
-author_requires 'JSON::XS' => '2.2222';
-
-feature 'YAML:Syck (for YAML)',
- -default => 0,
- 'YAML::Syck' => '0.67';
-author_requires 'YAML::Syck';
-
-feature 'HTML::Parser (for HTML input)',
- -default => 0,
- 'HTML::Parser' => undef;
-author_requires 'HTML::Parser';
-
-feature 'Data::Taxi (text/x-data-taxi) support (deprecated)',
- -default => 0,
- 'Data::Taxi' => undef;
-
-author_requires 'Data::Taxi';
-
-feature 'Config::General (text/x-config-general) support',
- -default => 0,
- 'Config::General' => undef;
-author_requires 'Config::General';
-
-feature 'PHP::Serialization (text/x-php-serialization) support',
- -default => 0,
- 'PHP::Serialization' => undef;
-author_requires 'PHP::Serialization';
-
-feature 'FreezeThaw (application/x-freezethaw) support',
- -default => 0,
- 'FreezeThaw' => undef;
-author_requires 'FreezeThaw';
-
-feature 'XML::Simple (text/xml) support',
- -default => 0,
- 'XML::Simple' => undef;
-author_requires 'XML::Simple';
-
-auto_install;
-
-if ($Module::Install::AUTHOR) {
- system("pod2text lib/Catalyst/Action/REST.pm > README")
- and die $!;
-}
-
-repository 'git://git.shadowcat.co.uk/catagits/Catalyst-Action-REST.git';
-
-add_metadata( x_authority => 'cpan:BOBTFISH' );
-
-WriteAll;
-
+++ /dev/null
-NAME
- Catalyst::Action::REST - Automated REST Method Dispatching
-
-SYNOPSIS
- sub foo :Local :ActionClass('REST') {
- ... do setup for HTTP method specific handlers ...
- }
-
- sub foo_GET {
- ... do something for GET requests ...
- }
-
- # alternatively use an Action
- sub foo_PUT : Action {
- ... do something for PUT requests ...
- }
-
-DESCRIPTION
- This Action handles doing automatic method dispatching for REST
- requests. It takes a normal Catalyst action, and changes the dispatch to
- append an underscore and method name. First it will try dispatching to
- an action with the generated name, and failing that it will try to
- dispatch to a regular method.
-
- For example, in the synopsis above, calling GET on "/foo" would result
- in the foo_GET method being dispatched.
-
- If a method is requested that is not implemented, this action will
- return a status 405 (Method Not Found). It will populate the "Allow"
- header with the list of implemented request methods. You can override
- this behavior by implementing a custom 405 handler like so:
-
- sub foo_not_implemented {
- ... handle not implemented methods ...
- }
-
- If you do not provide an _OPTIONS subroutine, we will automatically
- respond with a 200 OK. The "Allow" header will be populated with the
- list of implemented request methods. If you do not provide an _HEAD
- either, we will auto dispatch to the _GET one in case it exists.
-
- It is likely that you really want to look at Catalyst::Controller::REST,
- which brings this class together with automatic Serialization of
- requests and responses.
-
- When you use this module, it adds the Catalyst::TraitFor::Request::REST
- role to your request class.
-
-METHODS
- dispatch
- This method overrides the default dispatch mechanism to the
- re-dispatching mechanism described above.
-
-SEE ALSO
- You likely want to look at Catalyst::Controller::REST, which implements
- a sensible set of defaults for a controller doing REST.
-
- This class automatically adds the Catalyst::TraitFor::Request::REST role
- to your request class. If you're writing a web application which
- provides RESTful responses and still needs to accommodate web browsers,
- you may prefer to use Catalyst::TraitFor::Request::REST::ForBrowsers
- instead.
-
- Catalyst::Action::Serialize, Catalyst::Action::Deserialize
-
-TROUBLESHOOTING
- Q: I'm getting a "415 Unsupported Media Type" error. What gives?!
- A: Most likely, you haven't set Content-type equal to
- "application/json", or one of the accepted return formats. You can
- do this by setting it in your query accepted return formats. You can
- do this by setting it in your query string thusly:
- "?content-type=application%2Fjson (where %2F == / uri escaped)."
-
- NOTE Apache will refuse %2F unless configured otherwise. Make sure
- "AllowEncodedSlashes On" is in your httpd.conf file in order for
- this to run smoothly.
-
-AUTHOR
- Adam Jacob <adam@stalecoffee.org>, with lots of help from mst and
- jrockway
-
- Marchex, Inc. paid me while I developed this module.
- (<http://www.marchex.com>)
-
-CONTRIBUTORS
- Tomas Doran (t0m) <bobtfish@bobtfish.net>
-
- John Goulah
-
- Christopher Laco
-
- Daisuke Maki <daisuke@endeworks.jp>
-
- Hans Dieter Pearcey
-
- Brian Phillips <bphillips@cpan.org>
-
- Dave Rolsky <autarch@urth.org>
-
- Luke Saunders
-
- Arthur Axel "fREW" Schmidt <frioux@gmail.com>
-
- J. Shirley <jshirley@gmail.com>
-
- Gavin Henry <ghenry@surevoip.co.uk>
-
- Gerv http://www.gerv.net/
-
- Colin Newell <colin@opusvl.com>
-
- Wallace Reis <wreis@cpan.org>
-
-COPYRIGHT
- Copyright (c) 2006-2012 the above named AUTHOR and CONTRIBUTORS
-
-LICENSE
- You may distribute this code under the same terms as Perl itself.
-
projects / catagits/Catalyst-Action-REST.git / commitdiff