HTTP::...:Cookie(3pm)

💖 HTTP::CookieMonster::Cookie — the manual, but make it cute 🍪

okay bestie, so this is the Perl doc page for HTTP::...:Cookie(3pm) from the User Contributed Perl Documentation, and we're gonna walk through it together. grab a snack, it's giving cookie lore. 🎀

---

✨ NAME ✨

HTTP::CookieMonster::Cookie — the cookie representation that HTTP::CookieMonster uses, periodt. 🍪

🌸 VERSION 🌸

version 0.11 — yeah she's on 0.11, keep up 💅

🦋 SYNOPSIS 🦋

okay so here's the whole vibe in code, literally verbatim, don't touch:

use HTTP::CookieMonster::Cookie;
my $cookie = HTTP::CookieMonster::Cookie->new(
    key       => 'cookie-name',
    val       => 'cookie-val',
    path      => '/',
    domain    => '.somedomain.org',
    path_spec => 1,
    secure    => 0,
    expires   => 1376081877
);

use WWW::Mechanize;
use HTTP::CookieMonster;

my $mech = WWW::Mechanize->new;
my $monster = HTTP::CookieMonster->new( cookie_jar => $mech->cookie_jar );
$monster->set_cookie( $cookie );

$mech->get('https://example.com');    # passes $cookie in request

so you make a cookie, you hand it to the monster, the monster stuffs it in mechanize's cookie jar, and then the request just… carries it. no cap. ✨

💜 DESCRIPTION 💜

so the whole point of this module is that HTTP::CookieMonster uses it to represent the cookies it finds chilling in an HTTP::Cookies cookie_jar. and to keep things familiar — because who wants to learn a whole new vocabulary — the method names were deliberately chosen to mirror the positional parameter names laid out in the $cookie_jar->scan( \&callback ) documentation. iykyk. 🫶

real talk though: being not intimately familiar with the HTTP cookie spec, the author did not force any validation or default values onto any of the attributes. so please be aware — the burden is on you, the user, to provide "correct" data if you're using this module directly. it's giving trust falls. 🙈

there are some sample values below, but if you want a better idea of what's actually required? try visiting a few sites and dumping their cookies. field research, bestie. 🔥

use Data::Printer;
my $mech = WWW::Mechanize->new;
$mech->get( 'http://www.google.ca' );
my $monster = HTTP::CookieMonster->new( cookie_jar => $mech->cookie_jar );
p $monster->all_cookies;

---

⭐ version ⭐

$cookie->version( 0 );

🍓 key 🍓

The name of the cookie. that's it, that's the whole job.

$cookie->key( "session_id" );

🧚 val 🧚

The value of the cookie. iconic.

$cookie->val( "random_stuff" );

If you are creating a new cookie, you should escape the value first. do not skip this step bestie, it's for your own good 💅

use URI::Escape qw( uri_escape );
$cookie->value( uri_escape( 'random_stuff' ) );

🌈 path 🌈

$cookie->path( "/" );

💖 domain 💖

$cookie->domain( ".google.ca" );

🌸 port 🌸

(yes, she exists. that's the whole note. slay.)

🎀 path_spec 🎀

$cookie->path_spec( 1 );

💅 secure 💅

$cookie->secure( 1 );

🔥 expires 🔥

$cookie->expires( 1407696193 );

💀 discard 💀

(also just vibing here on her own. no example given, no example needed.)

👑 hash 👑

$cookie->hash( { HttpOnly => undef } );

---

🦋 SEE ALSO 🦋

This is mainly useful for creating cookies to be used by LWP::UserAgent and WWW::Mechanize classes. If you need to create cookies to set via headers, have a look at Cookie::Baker. go give them a lil visit 🫶

✨ AUTHOR ✨

Olaf Alders <olaf@wundercounter.com> — thank you king 👑

🌈 COPYRIGHT AND LICENSE 🌈

This software is copyright (c) 2012 by Olaf Alders.

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

---

and that's the whole page, no notes. 💖

so this doc was rendered up by perl v5.36.0 on 2022-10-14, and it lives in the HTTP::...:Cookie(3pm) manual page from the User Contributed Perl Documentation. mwah, slay, go forth and cookie responsibly 🍪✨💅