Config:...or::File(3)

💖 NAME 💖

okay bestie, this is the manual page for Config::Generator::File(3) — yep, from the User Contributed Perl Documentation — and the name line is literally:

Config::Generator::File - Config::Generator file support

periodt. now let’s get into it ✨

🌈 DESCRIPTION 🌈

This module lowkey makes handling files, directories, and symbolic links way easier 🫶. The whole goal is to do all the file-related operations through this module so there’s a consistent vibe when dealing with the Config::Generator variables: $NoAction, $RootDir, and $Verbosity. no cap, consistency is the main character here 💅.

On top of that, it can generate rpm-compatible spec file snippets, and the yacg command can use a "manifest" file to record which files it actually created. This is required so you can “clean out the junk” — see yacg’s --clean option. it’s giving tidy little filesystem goblin energy 🧚

✨ FUNCTIONS ✨

This module provides the following functions — and bestie, none of them are exported by default 🙈:

• ensure_directory(PATH) — make sure the given PATH is a directory 💖
• ensure_file(PATH, CONTENTS) — make sure the given PATH is a file with the given CONTENTS ✨
• ensure_symlink(PATH, TARGET) — make sure the given PATH is a symbolic link with the given TARGET 🎀
• ensure_mode(PATH, MODE) — make sure the given PATH has the given numerical MODE 🔥
• ensure_user(PATH, USER) — make sure the given PATH is owned by the given USER 👑
• ensure_group(PATH, GROUP) — make sure the given PATH is owned by the given GROUP 🌸
• files_manifest() — return the list of all the files that have been manipulated by this module 🦋
• files_spec() — return the list of all the files that have been manipulated by this module, in a format compatible with rpm’s spec %files 💅
• handle_manifest(PATH, CLEAN) — write the list of all the files that have been manipulated by this module in a "manifest" file at the given PATH; if CLEAN is true, also remove all the files and directories that were in the previous manifest and are not present anymore 🧹
• handle_spec(PATH) — write the list of all the files that have been manipulated by this module in a "spec" file at the given PATH ⭐

👑 AUTHOR 👑

Lionel Cons <http://cern.ch/lionel.cons>

Copyright (C) CERN 2013-2016

and the cute little footer sign-off bestie: this page is from perl v5.32.1, dated 2019-07-26 — bye, stay slay, go touch some files 💜