SHADE-JAR(1)

πŸ“¦
version 6.5.1 Β· 5 versions
, in opensuse-leap 16.0

πŸ’… shade-jar β€” bestie's guide to renaming Java namespaces ✨

okay so real talk, this is shade-jar, from the Java Packages Tools girlies, and it's literally the glow-up station for your JAR files. πŸŽ€


🌸 NAME 🌸

shade-jar β€” renames the Java namespace inside a JAR file. that's it, that's the whole vibe. πŸ’–


πŸ¦‹ SYNOPSIS πŸ¦‹

bin/shade-jar orig-namespace shaded-namespace in-jar out-jar

four things, in that order, no cap. ✨


πŸ’œ DESCRIPTION πŸ’œ

okay so shade-jar is the utility for changing JAR file namespaces. basically it goes through and replaces every single occurrence of the given pattern with the given replacement β€” like a find-and-replace but make it fashion. πŸ’…

the replacement happens on class file names and inside the class files themselves. both. she does both. πŸ”₯

and if you've heard people call this "shading" β€” yes bestie, that's exactly what this is. you already knew. iykyk. 🧚


✨ EXAMPLES ✨

shade-jar org.apache.log4j com.example.shaded.log4j
/usr/share/java/log4j.jar lib/shaded-log4j.jar

so what this does: it replaces all occurrences of org.apache.log4j in the JAR file /usr/share/java/log4j.jar with com.example.shaded.log4j, and stores the resulting JAR in lib/shaded-log4j.jar. iconic behaviour, honestly. πŸ‘‘


πŸ’€ BUGS πŸ’€

ngl, currently only class files get shaded. resources are not renamed. 😭 and it's worse β€” neither the contents of resource files nor manifests are processed. so like, know that going in. πŸ™ˆ


🫢 AUTHOR 🫢

Written by Mikolaj Izdebski. thank you king, we appreciate you. 🌈


πŸ“ 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

they want to hear from you fr fr. πŸ¦‹


JAVAPACKAGES Β· version dated 2026-05-28 Β· and that's the whole page, mwah πŸ’‹ stay shady βœ¨πŸ’–