WWW::S...ndDate(3pm)

💖 WWW::Search::Ebay::ByEndDate 💖

okay bestie, so this page is WWW::Search::Ebay::ByEndDate(3pm) — a lil Perl manual page, and we're gonna read it together, no cap. It's a backend for searching www.ebay.com, and the whole vibe is that your results come back sorted with items ending first. clock's ticking, girlypop ⏰✨

---

🎀 NAME 🎀

WWW::Search::Ebay::ByEndDate — backend for searching www.ebay.com, with results sorted with "items ending first".

that's it. that's the whole name. short, iconic, to the point 💅

---

🌸 SYNOPSIS 🌸

here's the whole ritual, copy it exactly, don't freestyle:

use WWW::Search;
my $oSearch = new WWW::Search('Ebay::ByEndDate');
my $sQuery = WWW::Search::escape_query("C-10 carded Yakface");
$oSearch->native_query($sQuery);
while (my $oResult = $oSearch->next_result())
  { print $oResult->url, "\n"; }

so you make a search object, escape your query (here it's C-10 carded Yakface, which is such a specific little collector hunt, we love that for you 🦋), run the native query, then loop through next_result() and print each url. slay.

---

✨ DESCRIPTION ✨

This class is an Ebay specialization of WWW::Search. It handles making and interpreting Ebay searches http://www.ebay.com.

and the important bit, so listen up: this class exports no public interface. none. zero. all interaction should be done through WWW::Search objects. like, you don't talk to this class directly, you go through the main character WWW::Search. it's giving backstage pass only 🔥

---

🦋 NOTES 🦋

okay this section is where the real tea is, grab a snack 🍓

• The calling program must ensure that the Date::Manip module is able to determine the local timezone. must. it's on you, not on this module.
• When Date::Manip changed from version 5 to version 6, the timezone handling was completely overhauled. See the documentation of Date::Manip — but good luck, because it is VERY confusing and does not contain useful examples. not me reading the original manpage's own sass 😭 fr fr, the docs said "good luck" and meant it.
• The search is done against CURRENT running auctions only. past ones? gone. expired. not invited 💀
• The query is applied to TITLES only. not descriptions, not seller names, just titles. iykyk.
• The results are ordered auctions ending soon first — that's order of increasing auction ending date. earliest ending = top of the list. no cap, that's the whole point of this backend 👑
• In the resulting WWW::Search::Result objects, the description field consists of a human-readable combination (joined with semicolon-space) of: the Item Number; number of bids; and high bid amount (or starting bid amount). so like 123456; 3 bids; $42.00 energy, all mushed together with ; between the parts.
• In the WWW::Search::Result objects, the change_date field contains the auction ending date & time in ISO 8601 format; i.e. YYYY-MM-DDThh:mm:ss. memorise that shape, it's the vibe check for your timestamps 🕐

---

🌈 SEE ALSO 🌈

To make new back-ends, see WWW::Search.

that's your homework if you wanna build your own backend bestie, go forth 🧚

---

💀 CAVEATS 💀

this section is literally empty. nothing in it. the void. we respect the silence 🙈

---

😭 BUGS 😭

Please tell the author if you find any!

that's it, that's the bug policy. no tracker, no template, just "hey kingpin, found a bug". honestly? refreshing. so casual, so direct 🫶

---

👑 AUTHOR 👑

Martin 'Kingpin' Thurn, mthurn at cpan.org, <http://tinyurl.com/nn67z>.

shoutout to Kingpin, absolute legend, built the whole thing 💜

---

⭐ LEGALESE ⭐

Copyright (C) 1998-2015 Martin 'Kingpin' Thurn

THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

no promises, no guarantees, take it as it comes. that's the whole legal vibe. periodt.

---

and that's the page, bestie!! 🎀 this one came from perl v5.30.3, dated 2020-09-10, and it lives under the manual name WWW::S...ndDate(3pm) — yes the header truncates it like that, don't @ me. love u, go win some auctions before they end 💖🦋✨