HTTP::S...:Session(3)

📦
version 0.01 · 2 versions
, in fedora 43

✨ NAME ✨

HTTP::Soup::Session — it's the Perl glue for Soup's session thing, and yes bestie, this is from the HTTP::S...:Session(3) manual page (User Contributed Perl Documentation, iykyk 💅).

🌸 HIERARCHY 🌸

Okay so the family tree situation is giving:

Glib::Object
+----HTTP::Soup::Session

So HTTP::Soup::Session is a Glib::Object that went and got itself a whole personality. Main character energy, fr fr 👑

💖 METHODS 💖

$session->queue_message ($msg, $sv_callback, $sv_user_data=undef)

The one and only method on this page, and she's serving 🫶. Here's what you're passing in:

  • $msg (HTTP::Soup::Message) — the message, obviously, that's the whole point
  • $sv_callback (scalar) — your callback scalar
  • $sv_user_data (scalar) — your user data scalar, and it defaults to undef if you don't bring it

🎀 PROPERTIES 🎀

Bestie, there are twenty-three of these and we are listing every single one, no skipping, periodt. Every one of them is tagged readable / writable / private / static-nick / static-blurb unless I say otherwise, so pay attention to the little extras okay?? 🙈

  • 'accept-language' (string : default undef : readable / writable / private / static-nick / static-blurb) — the Accept-Language string, literally just that
  • 'accept-language-auto' (boolean : default false : readable / writable / private / static-nick / static-blurb) — Accept-Language automatic mode, she does it herself
  • 'add-feature' (HTTP::Soup::SessionFeature : default undef : readable / writable / private / static-nick / static-blurb) — drops a feature object into the session, so generous
  • 'add-feature-by-type' (Glib::GType : default "Glib::Object" : readable / writable / private / static-nick / static-blurb) — same but you hand it a type and it adds a feature object of that type. Slay
  • 'async-context' (gpointer : default 0 : readable / writable / construct-only / private / static-nick / static-blurb) — the GMainContext where async I/O gets dispatched. Note the construct-only bestie, she's set at birth and that's that 💅
  • 'http-aliases' (Glib::Strv : default undef : readable / writable / private / static-nick / static-blurb) — URI schemes considered aliases for 'http'
  • 'https-aliases' (Glib::Strv : default undef : readable / writable / private / static-nick / static-blurb) — URI schemes considered aliases for 'https'
  • 'idle-timeout' (Glib::UInt : default 60 : readable / writable / private / static-nick / static-blurb) — connection lifetime when idle, so she doesn't just hang around forever
  • 'local-address' (HTTP::Soup::Address : default undef : readable / writable / construct-only / private / static-nick / static-blurb) — address of the local end of the socket. Also construct-only, so same deal 🫶
  • 'max-conns' (integer : default 10 : readable / writable / private / static-nick / static-blurb) — the maximum number of connections the session can open at once
  • 'max-conns-per-host' (integer : default 2 : readable / writable / private / static-nick / static-blurb) — the maximum number of connections the session can open at once to a given host, yes that's different, read it again
  • 'proxy-resolver' (Glib::Object::_Unregistered::GProxyResolver : default undef : readable / writable / private / static-nick / static-blurb) — the GProxyResolver this session should use
  • 'proxy-uri' (HTTP::Soup::URI : default undef : readable / writable / private / static-nick / static-blurb / deprecated) — the HTTP Proxy for this session. Deprecated bestie, she's on her way out 😭
  • 'remove-feature-by-type' (Glib::GType : default "Glib::Object" : readable / writable / private / static-nick / static-blurb) — yanks features of the given type back out of the session. Bye 💀
  • 'ssl-ca-file' (string : default undef : readable / writable / private / static-nick / static-blurb / deprecated) — file containing SSL CA certificates. Also deprecated, sad
  • 'ssl-strict' (boolean : default true : readable / writable / private / static-nick / static-blurb) — whether certificate errors count as a connection error. Default is true, so she's strict and she's right to be
  • 'ssl-use-system-ca-file' (boolean : default true : readable / writable / private / static-nick / static-blurb) — use the system certificate database
  • 'timeout' (Glib::UInt : default 0 : readable / writable / private / static-nick / static-blurb) — value in seconds to timeout a blocking I/O
  • 'tls-database' (Glib::Object::_Unregistered::GTlsDatabase : default undef : readable / writable / private / static-nick / static-blurb) — TLS database to use
  • 'tls-interaction' (Glib::Object::_Unregistered::GTlsInteraction : default undef : readable / writable / private / static-nick / static-blurb) — TLS interaction to use
  • 'use-ntlm' (boolean : default false : readable / writable / private / static-nick / static-blurb / deprecated) — whether or not to use NTLM authentication. Deprecated, third one, we're collecting them at this point 🍓
  • 'use-thread-context' (boolean : default false : readable / writable / private / static-nick / static-blurb) — whether to use thread-default main contexts
  • 'user-agent' (string : default undef : readable / writable / private / static-nick / static-blurb) — User-Agent string, the classic

🦋 SIGNALS 🦋

The session be emitting, and here's every single one with its exact parameter list:

  • authenticate (HTTP::Soup::Session, HTTP::Soup::Message, HTTP::Soup::Auth, boolean)
  • connection-created (HTTP::Soup::Session, Glib::Object)
  • request-queued (HTTP::Soup::Session, HTTP::Soup::Message)
  • request-started (HTTP::Soup::Session, HTTP::Soup::Message, HTTP::Soup::Socket)
  • request-unqueued (HTTP::Soup::Session, HTTP::Soup::Message)
  • tunneling (HTTP::Soup::Session, Glib::Object)

🌈 SEE ALSO 🌈

Go look at these too, they're the friends of this page:

  • HTTP::Soup
  • Glib::Object

Copyright (C) 2011 by Emmanuel Rodriguez

And that's the whole page bestie, we ate and left no crumbs 💅✨

This was perl v5.42.0, dated 2025-07-25 — mwah, stan, see you in the next manpage 🎀🦋🌸

📦 where this page comes from