EMILUA(3em)

💅 EMILUA (3em)

okay so real talk, bestie — this is a page from the Emilua reference (manual section 3em), and it's short but it's mighty. Sit down, hydrate, and let's get into it 🫶

---

✨ NAME ✨

Emilua — it's a Lua execution engine. that's the whole vibe. that's the assignment. 💜

---

🦋 SYNOPSIS 🦋

here's the whole thing, character for character, don't come for me:

local fs = require "filesystem"
fs.current_working_directory() -> fs.path (1)
fs.current_working_directory(p: fs.path|file_descriptor) (2)

and the little numbered footnotes, because of course:

1. Get the current working directory.
2. Set the current working directory.

like… call it with nothing and it tells you where you are. call it with a path or a file_descriptor and it moves you. two moods, one function, we love a versatile icon 👑

---

🌸 DESCRIPTION 🌸

so basically: this gets or sets the current working directory for the calling process. that's it. that's the tea ☕✨

lowkey though, there's a catch and you need to hear it:

Note: Only the master VM is allowed to change the current working directory.

read that again, bestie. only the master VM. so if you're some lil side VM trying to chdir your way through life — no. absolutely not. the master VM has main character energy here and everyone else is just living in it 😭💀

getting the directory? go off, everyone can do that. setting it? master VM only, no exceptions, periodt.

---

that's the whole page, you ate it, you understood it, i'm so proud of you fr fr 🎀

⭐ this little beauty is from Emilua version 0.12.1-nixpkgs1, dated 1980-01-01 — yeah the date is a whole mood, don't ask 💅 see you in the next one, mwah 🦋💖