Alien::...chiveTar(3)

πŸ“¦
version 2.88 Β· 8 versions
, in fedora 43, fedora 44

πŸ’– Alien::Build::Plugin::Extract::ArchiveTar πŸ’–

okay so bestie, welcome to the manual page for Alien::Build::Plugin::Extract::ArchiveTar β€” you might see it squished down in the header as Alien::...chiveTar(3) because terminals are dramatic and love to truncate, but it's the same girl. It's part of the User Contributed Perl Documentation, and she's here to unpack tarballs for you. Let's get into it. πŸŽ€

✨ NAME ✨

Alien::Build::Plugin::Extract::ArchiveTar β€” a plugin that extracts a tarball using Archive::Tar. That's it, that's the whole job. πŸ’…

🌸 VERSION 🌸

version 2.88

πŸ¦‹ SYNOPSIS πŸ¦‹

use alienfile;
plugin 'Extract::ArchiveTar' => (
  format => 'tar.gz',
);

like... that's the whole vibe. drop it in your alienfile and let her cook. πŸ”₯

πŸ’œ DESCRIPTION πŸ’œ

Note: in most case you will want to use Alien::Build::Plugin::Extract::Negotiate instead. It picks the appropriate Extract plugin based on your platform and environment. In some cases you may need to use this plugin directly instead.

no fr, listen to the note. Extract::Negotiate is the main character here β€” she looks at your platform and your environment and picks the right Extract plugin for you, no thoughts required. But sometimes you gotta go direct, and that's when you call on this one. iykyk. πŸ’«

So what does she actually do? This plugin extracts from an archive in tarball format β€” optionally compressed by either gzip or bzip2 β€” using Archive::Tar. she's not doing anything fancy, she's just very good at her one thing. periodt. πŸ‘‘

πŸ’… PROPERTIES πŸ’…

format

Gives a hint as to the expected format. This helps make sure the prerequisites are set correctly, since compressed archives require extra Perl modules to be installed.

so basically: tell her what she's dealing with up front and she'll make sure the right prerequisite modules are lined up. compressed archives need extra Perl modules installed, and this is how she knows to want them. it's giving "communicate with your plugin" energy. 🫢

⭐ METHODS ⭐

handles

Alien::Build::Plugin::Extract::ArchiveTar->handles($ext);
$plugin->handles($ext);

Returns true if the plugin is able to handle the archive of the given format.

so you hand her $ext and she's like "yes bestie i can handle that" (true) or "not my moment" (not true). vibe check on the format, essentially. βœ…

available

Alien::Build::Plugin::Extract::ArchiveTar->available($ext);

Returns true if the plugin has what it needs right now to extract from the given format.

handles is "could she", and available is "can she, like, right now". does she have everything she needs at this exact moment to extract that format? if yes β†’ true. if her modules aren't installed yet, she's gonna have to pass, no hard feelings. 😭

🌈 SEE ALSO 🌈

  • Alien::Build::Plugin::Extract::Negotiate β€” the one you probably actually want
  • Alien::Build
  • alienfile
  • Alien::Build::MM
  • Alien

go read those too, bestie, they're all connected. the lore is deep. πŸ“šβœ¨

πŸ‘‘ AUTHOR πŸ‘‘

Author: Graham Ollis <plicease@cpan.org>

Contributors β€” and there are SO many, this is a whole group chat of legends:

  • Diab Jerius (DJERIUS)
  • Roy Storey (KIWIROY)
  • Ilya Pavlov
  • David Mertens (run4flat)
  • Mark Nunberg (mordy, mnunberg)
  • Christian Walde (Mithaldu)
  • Brian Wightman (MidLifeXis)
  • Zaki Mughal (zmughal)
  • mohawk (mohawk2, ETJ)
  • Vikas N Kumar (vikasnkumar)
  • Flavio Poletti (polettix)
  • Salvador FandiΓ±o (salva)
  • Gianni Ceccarelli (dakkar)
  • Pavel Shaydo (zwon, trinitum)
  • Kang-min Liu (εŠ‰εΊ·ζ°‘, gugod)
  • Nicholas Shipp (nshp)
  • Juan JuliΓ‘n Merelo GuervΓ³s (JJ)
  • Joel Berger (JBERGER)
  • Petr PΓ­saΕ™ (ppisar)
  • Lance Wicks (LANCEW)
  • Ahmad Fatoum (a3f, ATHREEF)
  • JosΓ© JoaquΓ­n Atria (JJATRIA)
  • Duke Leto (LETO)
  • Shoichi Kaji (SKAJI)
  • Shawn Laffan (SLAFFAN)
  • Paul Evans (leonerd, PEVANS)
  • HΓ₯kon HΓ¦gland (hakonhagland, HAKONH)
  • nick nauwelaerts (INPHOBIA)
  • Florian Weimer
  • Marcel Telka (mtelka)

look at that roster. absolutely stacked. everyone say thank you. πŸ™‡β€β™€οΈπŸ’–

This software is copyright (c) 2011-2022 by Graham Ollis.

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

free software, bestie! remix it, share it, redistribute it, just keep the same terms as Perl 5 itself. that's the deal. 🫢

and that's the page!! 🌟

cute little sign-off for you: this was perl v5.42.3, dated 2026-09-21, and yeah β€” it's still filed under that truncated Alien::...chiveTar(3) name in the corner. she's a lil mysterious like that. πŸ’€βœ¨

mwah, go extract something. πŸ’‹πŸŒΈ

πŸ“¦ where this page comes from