Coro::Twiggy(3pm)

💖 Coro::Twiggy — the vibe ✨

okay so bestie, welcome to Coro::Twiggy (it lives in the User Contributed Perl Documentation section of the manual, section 3pm, iykyk) — it's the Coro interface for Twiggy, and honestly? she's serving. 🫶

---

🌸 NAME 🌸

Coro::Twiggy — the Coro interface for Twiggy. that's it, that's the name, no notes. 💅

---

✨ SYNOPSIS ✨

here's the whole mood, copied exactly because I do not play with code:

use Coro::Twiggy;
use Plack::Request;
use Coro::AnyEvent;

my $application = sub {
    my ($env) = @_;
    my $req = Plack::Request->new($env);

    Coro::AnyEvent::sleep 10;
    ...
    return [
        200,
        [ 'Content-Type' => 'text/html' ],
        [ 'Twiggy response after 10 seconds' ]
    ]
};

my $server = Coro::Twiggy->new(host => '127.0.0.1', port => 8080);
$server->register_service( $application );

like. she sleeps for 10 seconds mid-request and STILL delivers. main character energy fr fr. 😌🔥

---

🦋 DESCRIPTION 🦋

so the server starts Your application inside an async in a Coro coroutine, and then it takes whatever your app gives back and uses that to respond to the client. simple as that, no cap. ✨

your Application has to return an ARRAYREF with these three things in it:

• the HTTP-code;
• an ARRAYREF that contains the headers for the response;
• an ARRAYREF that contains the body of the response.

💀 real talk: to stop the server, you destroy the server object. that's the move. no shutdown method, just let her go.

---

🎀 METHODS 🎀

🌈 new

Constructor. Returns server. iconic behaviour honestly. 👑

Named arguments:

• host
• port
• service — the PSGI application

💜 register_service

(Re)register the PSGI application. ✨

😭 important: until then, the event server will respond 503 Service Unavailable. so register her before you expect anything cute back, bestie.

---

🧚 VCS 🧚

<https://github.com/unera/coro-twiggy>

go forth and star her, she deserves it. ⭐

---

🌸 AUTHOR 🌸

Dmitry E. Oboukhov, <unera@debian.org> — thank you king, we appreciate you. 🫶

---

👑 COPYRIGHT AND LICENSE 👑

Copyright (C) 2012 by Dmitry E. Oboukhov

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.

so yeah — free software, same terms as Perl itself, Perl version 5.8.8 or any later version you happen to have. slay. 💖

---

and that's the whole page bestie!! 💅 this gorgeous little doc shipped with perl v5.32.0 and was dated 2021-01-09 — so if you're reading this, hi from the past, she ate and left no crumbs. 🎀✨ bye!! 🦋