JOSE-JWS-FMT(1)

📦
version 15 · 13 versions
, in arch rolling

💅 jose-jws-fmt — like, the JWS glow-up page

okay so bestie, welcome to jose-jws-fmt from the JOSE manual set (yes, the JOSE-JWS-FMT(1) one, that's her full name 🎀). She's a little icon whose entire personality is: taking a JWS and converting it between serialization formats. That's it. That's the gig. And she ate. ✨

✨ NAME ✨

jose-jws-fmt — converts a JWS between serialization formats 🔁

🦋 SYNOPSIS 🦋

jose jws fmt -i JWS [-I PAY] [-o JWS] [-O PAY] [-c]

literally the whole vibe in one line, no cap 💜

🌸 OVERVIEW 🌸

So the jose jws fmt command converts a JWS into alternative serialization formats, and honestly the way that it can do this is giving main character energy. For example, it can:

  1. Attach payload to a detached JWS. 🫶
  2. Detach payload from a JWS. 💀
  3. Convert JWS Compact Serialization to JWS JSON Serialization. 🔥
  4. Convert JWS JSON Serialization to JWS Compact Serialization. 🔥

periodt. four little tricks, all iconic. ✨

💅 OPTIONS 💅

  • -i JSON, --input=JSON — parse JWS from JSON, bestie 🎀
  • -i FILE, --input=FILE — read JWS from FILE, slay
  • -i -, --input=- — read JWS from standard input (yes, the - is doing the work here, iykyk) 👀
  • -I FILE, --detached=FILE — read decoded payload from FILE 🌸
  • -I -, --detached=- — read decoded payload from standard input 🫶
  • -o FILE, --output=FILE — write JWS to FILE ⭐
  • -o -, --output=- — write JWS to stdout (default, so if you don't say anything she just does it 💅)
  • -O FILE, --detach=FILE — detach payload and decode to FILE 🦋
  • -O -, --detach=- — detach payload and decode to standard output 💜
  • -c, --compact — output JWS using compact serialization, the cute little one-liner format 🎀

🌈 EXAMPLES 🌈

attach payload to a detached JWS and emit JWS Compact Serialization, lowkey my favorite move:
$ jose jws fmt -i msg.jws -I msg.txt -o compact.jws -c
detach payload from a JWS, the reverse glow-up:
$ jose jws fmt -i msg.jws -o detached.jws -O msg.txt

👑 AUTHOR 👑

Nathaniel McCallum <npmccallum@redhat.com> — the legend who made her, fr fr 🫶

🧚 SEE ALSO 🧚

jose-jws-sig(1), jose-jws-ver(1) — her besties, go say hi 💖

mwah 💋 this page is from the JOSE manual, dated 06/09/2026, and yes she's still JOSE-JWS-FMT(1) in the footer, iconic behavior, no notes. 🌟

📦 where this page comes from