NAME

  Apache::FakeCookie - fake request object for debugging

SYNOPSIS

  use Apache::FakeCookie;

  loads into Apache::Cookie namespace

DESCRIPTION

This module assists authors of Apache::* modules write test suites that would use Apache::Cookie without actually having to run and query a server to test the cookie methods. Loaded in the test script after the author's target module is loaded, Apache::FakeCookie

Usage is the same as Apache::Cookie

METHODS

Implements all methods of Apache::Cookie

See man Apache::Cookie for details of usage.

remove -- new method

Delete the given named cookie or the cookie represented by the pointer

  $cookie->remove;

  Apache::Cookie->remove('name required');

  $cookie->remove('some name');
        for test purposes, same as:
    $cookie = Apache::Cookie->new($r,
        -name   => 'some name',
    );
    $cookie->bake;

new

  $cookie = Apache::Cookie->new($r,
        -name    => 'some name',
        -value   => 'my value',
        -expires => 'time or relative time,
        -path    => 'some path',
        -domain  => 'some.domain',
        -secure  => 1,
  );

The Apache request object, $r, is not used and may be undef.

bake

  Store the cookie in local memory.

  $cookie->bake;

fetch

  Return cookie values from local memory

  $cookies = Apache::Cookie->fetch;     # hash ref
  %cookies = Apache::Cookie->fetch;

as_string

  Format the cookie object as a string, 
  same as Apache::Cookie

parse

  The same as fetch unless a cookie string is present.

  $cookies = Apache::Cookie->fetch(raw cookie string);
  %cookies = Apache::Cookie->fetch(raw cookie string)

  Cookie memory is cleared and replaced with the contents
  of the parsed "raw cookie string".

name, value, domain, path, secure

  Get or set the value of the designated cookie.
  These are all just text strings for test use,
  "value" accepts SCALARS, HASHrefs, ARRAYrefs

expires

  Sets or returns time in the same format as Apache::Cookie 
  and CGI::Cookie. See their man pages for details

SEE ALSO

Apache::Cookie(3)

AUTHORS

Michael Robinton michael@bizsystems.com Inspiration and code for subs (expires, expires_calc, parse) from CGI::Util by Lincoln Stein

COPYRIGHT and LICENSE

  Copyright 2003 Michael Robinton, BizSystems.

This module is free software; you can redistribute it and/or modify it under the terms of either:

  a) the GNU General Public License as published by the Free Software
  Foundation; either version 1, or (at your option) any later version,
  
  or

  b) the "Artistic License" which comes with this module.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See either the GNU General Public License or the Artistic License for more details.

You should have received a copy of the Artistic License with this module, in the file ARTISTIC. If not, I'll be glad to provide one.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA