Michael Robinton > Apache-FakeCookie-0.08 > Apache::FakeCookie



Annotate this POD

View/Report Bugs
Module Version: 0.08   Source  


  Apache::FakeCookie - fake request object for debugging


  use Apache::FakeCookie;

  loads into Apache::Cookie namespace


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


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


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

  $cookie->remove('some name');
        for test purposes, same as:
    $cookie = Apache::Cookie->new($r,
        -name   => 'some name',
  $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.

  Store the cookie in local memory.

  Return cookie values from local memory

  $cookies = Apache::Cookie->fetch;     # hash ref
  %cookies = Apache::Cookie->fetch;
  Format the cookie object as a string, 
  same as Apache::Cookie
  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
  Sets or returns time in the same format as Apache::Cookie 
  and CGI::Cookie. See their man pages for details




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


  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,

  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

syntax highlighting: