ZPLUG-RENAME-TO(5)

🌸 ZPLUG-RENAME-TO(5) 🌸

okay bestie, welcome to the zplug-rename-to page from the ZPLUG Manual 💖 this is a section-5 file (that's the file formats and conventions girlies, iykyk) and it's literally just about one tiny little tag that does one big slay thing: renaming stuff. let's get into it 🫶

---

✨ NAME ✨

zplug-rename-to — specify the filename you want to rename to 🎀

---

🌈 SYNOPSIS 🌈

zplug "username/reponame", rename-to:a.sh

just so we're all on the same page: the word package means the string that looks like this: "username/reponame". that's it, that's the whole format, periodt 💅

---

🦋 DESCRIPTION 🦋

so like. when you use the rename-to tag, you get to rename the package to whatever you want it to be instead. it's giving glow-up. it's giving rebrand. iconic.

⚠️ heads up though: this is only valid with as:command. if you're not using as:command, this tag is not gonna do anything for you, no cap.

here's the vibe check on what values it takes:

• Possible values — (rename) ✨
• Default value — (none) 🙈

💜 one more thing 💜

besides all that, you can use the zstyle command to change the default value... but ngl, it's impractical. so like, don't. but you can. your call bestie 🍓

---

🧚 EXAMPLES 🧚

Renaming fzf-bin to fzf — the classic. look at her go:

$ zplug ´junegunn/fzf-bin´, \
    from:gh-r, \
    as:command, \
    rename-to:fzf, \
    use:´*darwin*amd64*´

Renaming a command with the string captured with the use tag — okay this one is so clever, it grabs the captured bit and uses it as the new name:

zplug ´b4b4r07/httpstat´, \
    as:command, \
    use:´(*).sh´, \
    rename-to:´$1´

see that $1? that's the capture from use:´(*).sh´ flowing straight into the rename. chef's kiss 😭👑

---

👀 SEE ALSO 👀

• zplug(1)

---

📚 FURTHER DOCUMENTATION 📚

the references live over on the official wiki page if you wanna get started with zplug fr fr. fair warning though — the wiki may perhaps be overwhelming for first-time users. it's a lot. take your time, hydrate, you got this 💖

---

👑 AUTHORS 👑

zplug was originally written by Masaki Ishiyama (a.k.a @b4b4r07) ⭐ and many people have contributed to it — shoutout to the whole squad 🫶

---

📝 COPYING 📝

Copyright (C) 2015-2016 Masaki Ishiyama

MIT License — slay, permissive, use it freely bestie 💅

---

🐛 REPORTING BUGS 🐛

found a bug? report bugs to the zplug issues. don't suffer in silence, that's not the vibe 💀

---

ZPLUG Manual 🌸 12/28/2016 🌸 ZPLUG-RENAME-TO(5)

okay that's the whole page!! go forth and rename things, bestie — you're the main character of your own dotfiles 💖✨🦋