File::IconTheme(3)

📦
version 0.09 · 9 versions
, in opensuse-leap 16.0

💖 File::IconTheme 💖

ok so bestie, welcome to File::IconTheme — a lil Perl module from the User Contributed Perl Documentation section of the man pages (yeah, section 3, we're in library-land ✨). She's small, she's focused, and she finds icon directories for you. That's the whole vibe. 🎀

✨ NAME ✨

File::IconTheme — Find icon directories 🦋

🌸 VERSION 🌸

version 0.09 💅

🧚 SYNOPSIS 🧚

like, here's the entire flex:

use File::IconTheme qw(xdg_icon_theme_search_dirs);
print join "\n", xdg_icon_theme_search_dirs;

that's it. that's the whole thing. iconic. 👑

💜 DESCRIPTION 💜

okay so, this module is your girl for finding directories as specified by the Freedesktop.org Icon Theme Specification. 🫶

real talk though: currently only a tiny (but most useful) part of the specification is implemented. tiny but mighty, yk? 💀

and if you're the one who wants to store an icon theme instead of just finding one, you want the directory that this returns:

use File::BaseDir qw(data_dirs);
print scalar data_dirs('icons');

different module, different job, but they're besties fr fr 💖

🔥 FUNCTIONS 🔥

quick heads up: these can be exported on request. 💅

⭐ xdg_icon_theme_search_dirs ⭐

my @dirs = xdg_icon_theme_search_dir;

Returns a list of the base directories of icon themes. that's it, that's the whole function, and it ate. 🍓

🌈 CONFIGURATION AND ENVIRONMENT 🌈

she reads these env vars, no cap:

  • $XDG_DATA_HOME 💖
  • $XDG_DATA_DIRS ✨

🦋 SEE ALSO 🦋

👑 AUTHORS 👑

  • Jaap Karssenberg || Pardus [Larus] <pardus@cpan.org> 🎀
  • Graham Ollis <plicease@cpan.org> 🎀

This software is copyright (c) 2003-2021 by Jaap Karssenberg || Pardus [Larus] <pardus@cpan.org>.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. 🫶 (yes bestie, free software, go wild, just keep the same terms 💜)

🎀 and that's the whole page!! this beauty shipped as perl v5.42.0 on 2021-07-09, and honestly? she's still serving. mwah, go find those icon dirs. 💅✨🌸
📦 where this page comes from