HFST-SHUFFLE(1)

📦 version 3.17.1, in debian bookworm, debian trixie, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 hfst-shuffle — the "shuffle two transducers" era 💖

okay so bestie, welcome to hfst-shuffle(1), a User Commands girlie living in the HFST family. no cap, this is the tool that shuffles two transducers. that's the whole vibe. let's get into it 💅

✨ NAME ✨

hfst-shuffle — =Shuffle two transducers

(and yes the little = is literally in there, she's iconic like that, we don't question her 🎀)

🌸 SYNOPSIS 🌸

hfst-shuffle [OPTIONS...] [INFILE1 [INFILE2]]

🦋 DESCRIPTION 🦋

Shuffle two transducers. that's it. that's the plot. main character behaviour fr fr.

💜 Common options: 💜

  • -h, --help — prints the help message, the little "hi bestie here's how I work" moment 🫶
  • -V, --version — prints version info, so you can find out exactly which girl you're talking to
  • -v, --verbose — prints verbosely while processing, she will narrate her whole life to you, and honestly? we love that
  • -q, --quiet — only prints fatal erros and requested output. (yes, "erros". the typo is canon. she's been like this since 2018 and we respect her journey 😭)
  • -s, --silent — an alias of --quiet, same energy, different name, twin sister core

🌈 Input/Output options: 🌈

  • -1, --input1=INFILE1 — reads the first input transducer from INFILE1, that's transducer number one, our first queen 👑
  • -2, --input2=INFILE2 — reads the second input transducer from INFILE2, the other half of the duo
  • -C, --do-not-convert — do not allow transducers to be converted into the same type. like, she will not be doing makeovers today, no conversions, periodt
  • -o, --output=OUTFILE — writes the results to OUTFILE, where the magic gets saved 💾
if OUTFILE, or either INFILE1 or INFILE2, is missing or is -, standard streams will be used. so like, the pipes are always open bestie.

INFILE1, INFILE2, or both, must be specified. no inputs, no shuffle, no vibes.

the format of the result depends on the format of INFILE1 and INFILE2 — and lowkey, both should have the same format. matching outfits only, it's giving coordinated 🎀

the operation is applied pairwise for INFILE1 and INFILE2, which must have the same number of transducers. like a dance duo, one partner each, no third-wheeling.

but here's the cute part: if INFILE2 has only one transducer, the operation is applied for each transducer in INFILE1, keeping the second transducer constant. one loyal little constant queen holding it down while the other one gets shuffled through everyone. the way that works? obsessed 💖

⭐ EXAMPLES ⭐

hfst-shuffle -o shuffled.hfst cat.hfst dog.hfst

that's it, that's the whole flex. cat meets dog, they shuffle, shuffled.hfst is born. slay 🐱🐶

🎀 REPORTING BUGS 🎀

found a bug? do NOT suffer in silence bestie, report it:

also, for your scrolling pleasure:

Copyright © 2017 University of Helsinki, License GPLv3: GNU GPL version 3 <http://gnu.org/licenses/gpl.html>

This is free software: you are free to change and redistribute it.

There is NO WARRANTY, to the extent permitted by law. (no warranty bestie, she said what she said 💀)

and that's the whole page!! this manual was brought to you by HFST, dated August 2018, on the HFST-SHUFFLE(1) page. stay shuffled, stay iconic, mwah 💅✨🦋💖

📦 where this page comes from