NAME¶

Test::Path::Router - A testing module for testing routes

VERSION¶

version 0.15

SYNOPSIS¶

  use Test::More plan => 1;
  use Test::Path::Router;
  my $router = Path::Router->new;
  # ... define some routes
  path_ok($router, 'admin/remove_user/56', '... this is a valid path');
  path_is($router,
      'admin/edit_user/5',
      {
          controller => 'admin',
          action     => 'edit_user',
          id         => 5,
      },
  '... the path and mapping match');
  mapping_ok($router, {
      controller => 'admin',
      action     => 'edit_user',
      id         => 5,
  }, '... this maps to a valid path');
  mapping_is($router,
      {
          controller => 'admin',
          action     => 'edit_user',
          id         => 5,
      },
      'admin/edit_user/5',
  '... the mapping and path match');
  routes_ok($router, {
      'admin' => {
          controller => 'admin',
          action     => 'index',
      },
      'admin/add_user' => {
          controller => 'admin',
          action     => 'add_user',
      },
      'admin/edit_user/5' => {
          controller => 'admin',
          action     => 'edit_user',
          id         => 5,
      }
  },
  "... our routes are valid");

DESCRIPTION¶

This module helps in testing out your path routes, to make sure they are valid.

EXPORTED FUNCTIONS¶

path_ok ($router, $path, ?$message)

path_not_ok ($router, $path, ?$message)

path_is ($router, $path, $mapping, ?$message)

mapping_ok ($router, $mapping, ?$message)

mapping_not_ok ($router, $mapping, ?$message)

mapping_is ($router, $mapping, $path, ?$message)

routes_ok ($router, \%test_routes, ?$message)

This test function will accept a set of %test_routes which will get checked against your $router instance. This will check to be sure that all paths in %test_routes procude the expected mappings, and that all mappings also produce the expected paths. It basically assures you that your paths are roundtrippable, so that you can be confident in them.

BUGS¶

All complex software has bugs lurking in it, and this module is no exception. If you find a bug please either email me, or add the bug to cpan-RT.

AUTHOR¶

Stevan Little <stevan@cpan.org>

COPYRIGHT AND LICENSE¶

Copyright 2008-2011 Infinity Interactive, Inc.

<http://www.iinteractive.com>

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

AUTHOR¶

Stevan Little <stevan@cpan.org>

COPYRIGHT AND LICENSE¶

This software is copyright (c) 2016 by Infinity Interactive.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.