WWW::F...Friends(3pm)

💖 WWW::F...Friends — a k!ller lil Perl module, no cap 💖

okay bestie, sit down, hydrate, because we're talking about WWW::Facebook::API::Friends (that's the WWW::F...Friends(3pm) page, she's from the User Contributed Perl Documentation collection 💅). it's the friends part of the Facebook API wrapper, and honestly? it's giving "small module, big heart."

---

✨ NAME ✨

WWW::Facebook::API::Friends — Facebook Friends 🫶

like. that's her. that's the whole vibe. friends. 💖

---

🌸 SYNOPSIS 🌸

use WWW::Facebook::API;

that's it. that's the whole synopsis. one line. iconic behavior, honestly. you pull in the parent module and the friends stuff comes along for the ride 🎀

---

🦋 DESCRIPTION 🦋

Methods for accessing friends with WWW::Facebook::API ✨

literally what it says on the tin, babe. this module is the friend-shaped doorway into the Facebook API. you don't use it alone, you use it through WWW::Facebook::API, and then it does friend stuff for you. obsessed. 👑

---

🎀 SUBROUTINES/METHODS 🎀

base 💜

Returns the WWW::Facebook::API base object.

like, the parent object. the momager. the main character of the whole WWW::Facebook::API operation. this method hands her to you. 🌈

new 💖

Constructor.

yes bestie, you guessed it, it constructs. makes a new one. build-a-bear energy but for objects. 🧚

get(flid => 'id') 🌸

The friends.get method of the Facebook API:

$response = $client->friends->get();
$response = $client->friends->get(flid => '23432');

call it with no args, get everybody. pass a flid and it's like "okay, just this one then" 💅

get_app_users() ⭐

The friends.getAppUsers method of the Facebook API:

$response = $client->friends->get_app_users;

the friends who are also using the app. your actual people. the ones who showed up. 🫶

are_friends( uids1 => [ ... ], uids2 => [ ... ] ) 🦋

The friends.areFriends method of the Facebook API. The two arguments are array refs that make up an associative array:

$response
    = $client->friends->are_friends( uids1 => [1,7,8], uids2 => [2,3,4] );

See the Facebook API Documentation for more information.

so you give it two array refs of uids, and it pairs them up into an associative array and checks the friendship status. like a vibe check but for whether you two are mutuals 😭 the actual semantics live in the Facebook API docs, so go read those, i'm not gonna make stuff up fr fr.

get_lists() 💜

The friends.getLists method of the Facebook API:

$response = $client->friends->get_lists;

your friend lists!! the curated ones!! the "close friends" of it all 🎀

get_mutual_friends( %params ) 🔥

The friends.getMutualFriends method of the Facebook API:

$response = $client->friends->get_mutual_friends(
    target_uid => $target_uid,
    source_uid => $source_uid,
);

mutuals. MUTUALS bestie. you pass target_uid and source_uid and it tells you who you both know. the most important information in the entire social graph, lowkey. 💅

---

💀 DIAGNOSTICS 💀

None.

nothing. zero. the silence is deafening. 🙈

---

🌈 CONFIGURATION AND ENVIRONMENT 🌈

WWW::Facebook::API::Friends requires no configuration files or environment variables.

no config files, no env vars, no setup arc. it just works. we love a low-maintenance queen 👑

---

🧚 DEPENDENCIES 🧚

See WWW::Facebook::API

go look at the parent module, she's got the whole dependency situation handled 💖

---

🍓 INCOMPATIBILITIES 🍓

None reported.

nobody's said anything. so far so good ✨

---

💅 BUGS AND LIMITATIONS 💅

No bugs have been reported.

Please report any bugs or feature requests to bug-www-facebook-api@rt.cpan.org, or through the web interface at <http://rt.cpan.org>.

okay so like, no bugs reported, which is great, but if you DO find one — or you're like "bestie this needs a feature" — email bug-www-facebook-api@rt.cpan.org or hit the web interface at <http://rt.cpan.org>. don't suffer in silence, that's not the vibe 🫶

---

👑 AUTHOR 👑

David Romano "<unobe@cpan.org>"

the icon. the legend. the moment. we stan 🌟

---

💖 LICENSE AND COPYRIGHT 💖

Copyright (c) 2007-2010, David Romano "<unobe@cpan.org>". All rights reserved.

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

free software, same terms as Perl itself, go peep perlartistic for the full tea 🎀

---

⚠️ DISCLAIMER OF WARRANTY ⚠️

okay this part is ALL CAPS in the original and that's because it MEANS it. i'm keeping every word, bestie. read it. feel it. it's giving legal, but make it real. 😭

BECAUSE THIS SOFTWARE IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE SOFTWARE, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE SOFTWARE "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION.

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE SOFTWARE AS PERMITTED BY THE ABOVE LICENSE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

---

and that's the whole page bestie!! this lil write-up comes to you courtesy of perl v5.34.0, dated 2022-06-28, and she lives at WWW::F...Friends(3pm) in the User Contributed Perl Documentation. mwah. go make some friends. 💋✨💖