MVN_FILE(7)

💖 MVN_FILE 💖

okay so this is a page from the Java Packages Tools manual, section 7, and it's literally all about mvn_file — the macro that tells your Maven artifacts where to live. bestie, let's get into it 🦋

---

✨ NAME ✨

mvn_file — set installation location(s) for Maven artifact(s) 🎀

---

🌸 SYNOPSIS 🌸

%mvn_file artifact-coordinates primary-file [secondary-file ...]

---

💅 DESCRIPTION 💅

So the mvn_file macro is the girl who adds instructions for artifact installation into the XMvn reactor configuration. She's the one controlling where artifact files actually sit in the file system. (And like, the exact meaning of "artifact location" depends on whichever particular XMvn repository implementation you're installing into, so don't come for her, she's doing her best 🫶)

Here's the tea though: the artifact coordinates you specify must match at least one artifact. If they don't? Behavior is unspecified. Like, undefined. Chaos. We don't do that. 😭

But also — the opposite is fine! You can absolutely specify artifact coordinates that match multiple artifacts, so one single call to mvn_file can affect the installation of more than one artifact. Efficiency queen 👑

---

🧚 OPERANDS 🧚

• artifact-coordinates — These specify which artifact(s) this rule applies to. The format is:

groupId:artifactId[:extension[:classifier]][:version]

If you specify extension, then you must also specify version too — no skipping steps. And if any part is omitted or is equal to an empty string, it matches any string. Wildcards and brace expansions are supported in each part. For more info, go read the XMvn Configuration Reference (iykyk).

• primary-file — The primary location of the artifact file. This operand gets passed directly to the XMvn installer, so its exact meaning is specific to whichever repository implementation is used to install that artifact. Backreferences are supported in the form @n, where n is an integer corresponding to a brace in artifact-coordinates. ✨
• secondary-file — The secondary location of the artifact file. And there can be any number of these (zero or more, fr fr). Just like the primary, these operands are passed directly to the XMvn installer, and their exact meaning is specific to the particular repository implementation used to install the given artifact. Backreferences are supported in the form @n, where n is an integer corresponding to a brace in artifact-coordinates. 🌈

---

👑 AUTHOR 👑

Originally written by Mikolaj Izdebski. Versions 3.0.0 and later were written by Stanislav Ochotnicky. Legends only 💜

---

🙈 REPORTING BUGS 🙈

Found a bug? Don't suffer in silence bestie, report it through the Java Packages Tools issue tracker at Github:

https://github.com/fedora-java/javapackages/issues

---

⭐ SEE ALSO ⭐

gradle_build(7), mvn_alias(7), mvn_build(7), mvn_compat_version(7), mvn_config(7), mvn_package(7), xmvn(1). Go read those too, they're all part of the same iconic friend group 🎀

---

and that's the whole page, no cap! this was JAVAPACKAGES, dated 2025-09-19, and it's MVN_FILE(7) — slay, bye 💅✨