HFST-SFSTPL2FST(1)

💖 HFST-SFSTPL2FST(1) 💖

okay bestie, sit down, hydrate, and let me tell you about a little tool from the HFST family (that's the User Commands crew, section 1, iykyk) that is genuinely so useful it's not even funny. it's called hfst-sfstpl2fst and it's about to become your new hyperfixation. 🦋

---

✨ NAME ✨

hfst-sfstpl2fst — =Compile a file written with SFST programming language into a transducer.

yes the = is in there. it came like that. we don't ask questions, we just vibe. 💅

---

🎀 SYNOPSIS 🎀

hfst-sfstpl2fst (alias hfst-calculate) [OPTIONS...] [INFILE]

she also answers to hfst-calculate, so if you call her that, she will respond. main character with two names energy fr fr. 👑

---

🌸 DESCRIPTION 🌸

Compile a file written with SFST programming language into a transducer. that's the whole thing. that's the job. you give her SFST source, she hands you back a transducer, and honestly? slay. 💖

💫 Common options:

• -h, --help — Print help message. she tells you how she works. communication queen.
• -V, --version — Print version info. so you know exactly which era of her you're dealing with.
• -v, --verbose — Print verbosely while processing. she narrates. no thoughts, just updates.
• -q, --quiet — Only print fatal erros and requested output. (yes, "erros". typo is canon, we keep it, periodt.) she goes silent mode but still screams if something's fatal.
• -s, --silent — Alias of --quiet. same girl, different name tag.

📁 Input/Output options:

• -i, --input=INFILE — Read input from INFILE. hand her the file, she reads it.
• -o, --output=OUTFILE — Write output transducer to OUTFILE. she writes it back out. give and take, it's giving healthy relationship. 🫶

🔤 String and format options:

• -f, --format=FMT — Write result in FMT format.

If OUTFILE or INFILE is missing or -, standard streams will be used. so you can absolutely pipe her into things, she loves that.

FMT must be one of the following: {foma, sfst, openfst-tropical, openfst-log}

pick one of those four. not five. not "whatever feels right". those four. 🎀

---

🔥 EXAMPLES 🔥

1. the a-through-z machine

echo "[a-z]*" | hfst-sfstpl2fst -f foma > az.foma

create a foma transducer accepting any number of consecutive characters between a and z, inclusive. any number!! including zero!! she's flexible like that. ✨

2. the double-a to b machine

echo "a:b (a:<>)+" > ab.sfst-pl ; hfst-sfstpl2fst -f openfst-tropical \
-i ab.sfst-pl -o ab.tropical

create a tropical OpenFst transducer that accepts two or more consecutive a's and maps them into string "b". two or more, bestie, she said what she said. 🌈

---

😭 REPORTING BUGS 😭

found a bug? do NOT suffer in silence, that's not the vibe.

• Report bugs to <hfst-bugs@helsinki.fi> — the email address, it's right there, use it 🫶
• or directly to our bug tracker at: <https://github.com/hfst/hfst/issues>

hfst-sfstpl2fst home page: <https://github.com/hfst/hfst/wiki/HfstSfstPl2Fst>

General help using HFST software: <https://github.com/hfst/hfst/wiki>

---

👑 COPYRIGHT 👑

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. like... none. zero. the audacity of software, honestly. 💀 but hey, it's free, so.

---

so yeah — that's hfst-sfstpl2fst, compiled straight from SFST source into a transducer, four whole formats, one iconic alias. this page came from the HFST crew and it's dated August 2018, and it lives in section HFST-SFSTPL2FST(1) of the manual. go make something beautiful with it. mwah. 💖✨🎀