EMILUA(3em)

💖 NAME 💖

Emilua — the Lua execution engine. Yes bestie, this is the EMILUA(3em) manual page, and we're about to get into some fs.copy energy. 🎀

🦋 SYNOPSIS 🦋

local fs = require "filesystem"
fs.copy(from: fs.path, to: fs.path[, opts: table])

🌸 DESCRIPTION 🌸

Okay so the full tea is over at https://en.cppreference.com/w/cpp/filesystem/copy. Go read that if you need the deep lore, iykyk. 💅

🎀 opts 🎀

Here's the whole menu for the opts table, no skips. ✨

• existing — "skip" | "overwrite" | "update" | nil — behavior when the file already exists.
  • nil — report an error. 😭
  • "skip" — keep the existing file, without reporting an error. 💖
  • "overwrite" — replace the existing file. 🔥
  • "update" — replace the existing file only if it is older than the file being copied. ⏳
• recursive — boolean = false
  • false — skip subdirectories. 🙈
  • true — recursively copy subdirectories and their content. 🌀
• symlinks — "copy" | "skip" | nil
  • nil — follow symlinks. 👀
  • "copy" — copy symlinks as symlinks, not as the files they point to. 🪞
  • "skip" — ignore symlinks. 🚫
• copy — "directories_only" | "create_symlinks" | "create_hardlinks" | nil
  • nil — copy file content. 📄
  • "directories_only" — copy the directory structure, but do not copy any non-directory files. 📁
  • "create_symlinks" — instead of creating copies of files, create symlinks pointing to the originals. 🔗
  • "create_hardlinks" — instead of creating copies of files, create hardlinks that resolve to the same files as the originals. 🧲

Bestie, that's the whole page. Stay iconic. 💅✨

This page was brought to you by source/version Emilua 0.12.1-nixpkgs1, dated 1980-01-01. 🎀👑