Test::S...er::Base(3)

📦
version 1.84 · 2 versions
, in fedora 43

💖 NAME 💖

Test::Smoke::Poster::Base — the base class for all the posters that post to CoreSmokeDB. It's the mom friend of the poster family, fr fr. (This whole page is the manual for Test::S...er::Base(3), and honestly? it's giving "backend glue code but make it cute".)

🦋 DESCRIPTION 🦋

Okay so bestie, Test::Smoke::Poster::Base is the base class — it provides all the general methods that the poster subclasses inherit. It does the shared, boring, foundational stuff so the subclasses can just be ✨themselves✨. Main character energy: supporting cast edition.

🎀 Test::Smoke::Poster::Base->new(%arguments); 🎀

Arguments

Named, obviously. (named args supremacy, we love to see it 💅)

  • smokedb_url => $some_url
  • ddir => $smoke_directory
  • jsnfile => $json_file — that's mktest.jsn, btw 👀
  • v => $verbosity

Returns

An instance of the class. A whole new baby poster, born fresh 🫶

Exceptions

None. Zero. Nada. Not a single one. 😌

🌸 $poster->agent_string() 🌸

Class and instance method — it works both ways, versatile queen 👑.

Arguments

None.

Returns

sprintf "Test::Smoke/%s (%s)", $Test::Smoke::VERSION, $class;

Exceptions

None. 💀 nothing can go wrong here.

🦋 $poster->get_json() 🦋

Arguments

None.

Returns

The json string that was stored in "$ddir/$jsnfile". It's literally just sitting there waiting for you, no cap.

Exceptions

File I/O. 😭 yeah, if the file's being weird, this is where you find out.

✨ $poster->json_filename() ✨

Returns the the fully qualified file name of the jsonfile. (yes, "the the" — iconic, we stan a typo that made it into prod 💖)

🔥 $poster->post() 🔥

Post the JSON report to CoreSmokeDB. This is the whole point of the operation, bestie — go send it 📮

Arguments

None.

Returns

The id of the CoreSmokeDB report on success. A little number that means it worked 🎉

Exceptions

HTTP or Test::Smoke::Gateway-application errors. So if the network's being a hater, or the gateway app is having a day, that's where this falls over.

🌈 $poster->queue_this_report() 🌈

Use the new queue mechanism to try to send this report before the next smoke run. Basically: "hey, hold onto this and yeet it out there before the next smoke run happens" 🫡

💜 $poster->_post_data() 💜

Abstract method that should be implemented by the subclass. So like… this one's a placeholder, bestie. It's the vibe, not the implementation. The subclass has to actually do the thing 🙈

Arguments

None.

Returns

The body of the response.

🧚 $poster->_post_data_api() 🧚

Abstract method that should be implemented by the subclass. Same deal as above — it's abstract, it's waiting on the subclass to show up and deliver ⭐

Arguments

None.

Returns

The body of the response.

🍓 $poster->_process_post_result($response_body) 🍓

Process the result of the POST action to CoreSmokeDB. Takes the raw response and makes sense of it — translator era 💅

Arguments

Positional. (not named this time, we're keeping it simple)

  • $response_body — the raw JSON string send by CoreSmokeDB

Returns

The id of the report on success, undef on failure. So like, either you get a cute little id, or you get undef and you simply have to deal with it 😭

(c) 2002-2013, Abe Timmerman <abeltje@cpan.org> All rights reserved.

With contributions from Jarkko Hietaniemi, Merijn Brand, Campo Weijerman, Alan Burlison, Allen Smith, Alain Barbet, Dominic Dunlop, Rich Rauenzahn, David Cantrell. Shoutout to the whole squad 🫶✨

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See:

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. (Translation: it's free, it's hopeful, it promises nothing 🫠)

That's the whole page, bestie! This manual came to you courtesy of perl v5.42.0, dated 2025-07-25 — go forth and post those reports 💅💖

📦 where this page comes from