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

✨ NAME ✨

WWW::Search::Jobserve — it's the backend for searching www.jobserve.com, bestie 💖

(also hi, this is a 3pm perl manual page, from the User Contributed Perl Documentation crew 🫶)

---

🌈 SYNOPSIS 🌈

okay so here's the whole vibe, copy-paste ready:

use WWW::Search;
my $oSearch = new WWW::Search('Jobserve');
my $sQuery = WWW::Search::escape_query("(Fast Food Operative) and PERL");
$oSearch->native_query($sQuery, { job_category => 'it' });
while (my $oResult = $oSearch->next_result())
  {
    print $oResult->url, "\n";
    print $oResult->title, "\n";
    print $oResult->description, "\n";
  }

like, look at her go 🦋

---

💅 DESCRIPTION 💅

So WWW::Search::Jobserve is a Jobserve specialisation of WWW::Search. She handles the whole thing: making the searches, retrieving them, and interpreting the Jobserve searches over at http://www.jobserve.com. no cap, that's literally the job 💖

And this class exports no public interface — every single bit of interaction has to go through WWW::Search objects. that's the rule, periodt ✨

---

🎀 NOTES 🎀

she can query both the UK site and the Australian site, more on that below, keep reading bestie 👑

The search will terminate unless "job_category" is set in the native_query options. so like… set it. pls. 🙈

Results come ordered Best Match first — unless you pass 'job_order' => 'DateTime', then it's giving timestamp energy ⭐

---

🌸 OPTIONS 🌸

Parameters Available:

job_category job_type job_lookahead job_order jobserve_site

🍓 Job Category

Job Categories must be specified by setting "job_category" in the native_query options:

$oSearch->native_query($sQuery, { job_category => 'it' });

The value of this is simply the prefix you see jobserve insert into the url once you've clicked beyond the front page. E.g.

http://www.it.jobserve.com            { job_category => 'it' }
http://www.engineering.jobserve.com   { job_category => 'engineering' }

etc. — you get it, you see the pattern, it's giving very obvious 🧚

🦋 Job Type

Job Types are (Any|Contract|Permanent). To specifically search for one contract type, set 'job_type' => (*|C|P) to the query options:

$oSearch->native_query($sQuery, { job_type => 'C',  job_category => 'it' } );

The search defaults to "All" ✨

🌟 Days Ahead

Choices of how many days to look ahead are (5|4|3|2|1|0). To specifically search for x working days ahead, set 'job_lookahead' => (5|4|3|2|1|0) to the query options:

$oSearch->native_query($sQuery, { job_lookahead => '2', job_category => 'it' } );

The search defaults to 5 👑

💜 Result Order

Choices of how to order results are (Best Match|Latest Job). To alter the result order, set 'job_order' => (Rank|DateTime) to the query options:

$oSearch->native_query($sQuery, { job_order => 'DateTime', job_category => 'it' } );

The search defaults to "Best Match". 💖

🎀 Different Jobserve Sites

There are currently two Jobserve websites supported by this module namely United Kingdom and Australia.

The search will default to the UK site unless the parameter, 'jobserve_site' => (uk|au) is set in the query options:

$oSearch->native_query($sQuery, { jobserve_site => 'au', job_category => 'it' } );

The search defaults to "uk" 🇬🇧

🌈 Invocation

Invoke all parameters like so:

$oSearch->native_query($sQuery, { job_category  => 'it',
                                  job_type      => 'C',
                                  job_lookahead => '2',
                                  job_order     => 'DateTime',
                                  jobserve_site => 'au', } );

look at all those params living their best life together, iconic 😭

---

⭐ SEE ALSO ⭐

To make new back-ends, see WWW::Search. that's where the real ones go 🫶

---

💀 BUGS 💀

Doubt it. Please tell me if you find any! Better still have a go at fixing them. 😤

(ngl that's the most confident bugs section I've ever read and honestly? respect 👑)

---

🍓 AUTHOR 🍓

"WWW::Search::Jobserve" was written by Andy Pritchard (pilchkinstein@hotmail.com).

"WWW::Search::Jobserve" is maintained by Andy Pritchard

shoutout to Andy, fr fr 🌸

---

🧚 LEGALESE 🧚

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.

okay bestie this one is ALL CAPS for a reason — no promises, no guarantees, use at your own risk 💅

---

🌈 VERSION HISTORY 🌈

1.02

Altered parse_tree for cases where another href link is inserted before the job title and link 🦋

1.01

Altered POD and added a README ✨

1.00

Released to the public. 🎉

---

and that's the whole page babes 💖 this one's living in perl v5.30.3, dated 2020-09-10, and it's filed under WWW::S...observe(3pm) in the User Contributed Perl Documentation. go forth and search those jobs, you absolute main character 🌟👑