PN(1)

🦋 PN(1) — the pn page, but make it make sense

okay so real talk: this is pn from section 1 of the General Commands Manual, and she is a whole command-line tool for phone number manipulation 💅 bestie you're gonna love her.

---

✨ NAME ✨

pn — a command-line tool for phone number manipulation 🎀

---

🌸 SYNOPSIS 🌸

pn COMMAND [OPTIONS] INPUT

like. command first. then options. then the actual input. that's the vibe 👑

---

💖 COMMANDS 💖

• valid — tests whether the phone number you passed as INPUT is a valid number or a valid short number ✨. Returns 0 (SUCCESS) if the number is valid, 1 (ERROR) otherwise. Valid options here: -c, -v (verbose, default off).
• info — displays informations about the phone number given as INPUT 🧚 valid option: -c only.
• format — formats the telephone number given as INPUT to the standard you specify (E164 by default 😌), result lands on stdout. Valid options: -c, -f.
• find — finds phone number(s) inside some text given as INPUT, result on stdout (one line per number found 🔍). Valid options: -c, -f, -l.
• dialout — formats the phone number given as INPUT in e164 format, for out-of-country dialing purposes 🌈 valid options: -c, -l.

---

🔥 OPTIONS 🔥

• -c COUNTRY-CODE — if you set this, the phone number(s) in INPUT get treated as if they were dialed from the country given by the 2 uppercase letters COUNTRY-CODE (e.g. "FR", "US", ...) 🌍 if you don't set it, pn goes looking for numbers in the international format instead. no cap.
• -f FORMAT — sets the phone number output format. FORMAT has to be one of e164, int (international), nat (national), or teluri (RFC3966 tel URI) 🎀 the default value is e164.
• -l LENIENCY — sets the phone number search leniency in INPUT. LENIENCY has to be one of these icons-only-iykyk levels:
  • possible — phone numbers accepted are possible, but not necessarily valid 🙈
  • valid (default value) — phone numbers accepted are possible and valid ✨ numbers written in national format must have their national-prefix present if it's usually written for a number of this type. read that twice, it matters.
  • strict — phone numbers accepted are valid and grouped in a possible way for this locale 💅 for example, a US number written as "65 02 53 00 00" and "650253 0000" are not accepted at this leniency level, whereas "650 253 0000", "650 2530000" or "6502530000" are. also: numbers with more than one / symbol in the national significant number get dropped at this level 💀
  • exact — phone numbers accepted are valid and grouped the same way that we would have formatted it, or as a single block 🎯 for example, a US number written as "650 2530000" is not accepted at this leniency level, whereas "650 253 0000" or "6502530000" are. numbers with more than one / symbol are also dropped at this level 🫶

(see https://javadoc.io/doc/com.googlecode.libphonenumber/libphonenumber/8.4.1 for more details — yes it's a libphonenumber thing, go read it, it ate 👑

---

👑 RETURN STATUS 👑

pn returns 0 on successful operations, and 1 if an error occurred (option error, parsing error) 😭 that's it, that's the whole status situation.

---

🍓 AUTHOR 🍓

Camille Oudot <camille.oudot@orange.com> — icon, legend, the blueprint 💜

---

lowkey a heads up bestie: pn only exists on this page as section 1 of the General Commands Manual — and the footer is just PN(1) again with no version or date attached anywhere 🙈 so if you were waiting for a copyright line… there isn't one. bye bestie, go format some numbers 🌸🦋✨