NATSORT(1)

💅 NATSORT(1) — the natsort girlies' guide ✨

okay so bestie, welcome to natsort 🦋 this is the manual page for natsort 8.4.0, and it's genuinely one of those lil tools that just works and makes your life better. natural sort!! no more file10 before file2!! we love to see it 💖

🌸 NAME 🌸

natsort — manual page for natsort 8.4.0 ✨

🎀 SYNOPSIS 🎀

natsort [-h] [--version] [-p] [-f LOW HIGH] [-F LOW HIGH] [-e EXCLUDE]
        [-r] [-t {int,float,real,f,i,r}] [--nosign] [-s] [--noexp] [-l]
        [entries ...]

💫 DESCRIPTION 💫

Performs a natural sort on entries given on the command-line. that's the whole vibe, honestly 👑

Arguments are read from sys.argv. yep, straight from there, no cap 🫶

🧚 positional arguments:

• entries — the entries to sort. taken from stdin if nothing is given on the command line. so like, if you're feeling lazy you can just pipe stuff in, it's fine, we support you 💜

✨ options:

• -h, --help — show this help message and exit. the classic. the icon 🌈
• --version — show program's version number and exit. short, sweet, slay 🎀
• -p, --paths — interpret the input as file paths. okay so ngl this is not strictly necessary to sort all file paths, but bestie listen: in cases where there are OS-generated file paths like "Folder/" and "Folder (1)/", you need this option to make the paths sorted in the order you expect ("Folder/" before "Folder (1)/"). that's the tea ☕
• -f, --filter _LOW_ _HIGH_ — used for keeping only the entries that have a number falling in the given range. filtering but make it cute 🍓
• -F, --reverse-filter _LOW_ _HIGH_ — used for excluding the entries that have a number falling in the given range. the opposite of the one above, iconic behaviour 💅
• -e, --exclude _EXCLUDE_ — used to exclude an entry that contains a specific number. bye bye specific numbers 👋
• -r, --reverse — returns in reversed order. sometimes you just wanna go backwards, and honestly? valid 🙈
• -t, --number-type, --number_type {int,float,real,f,i,r} — choose the type of number to search for. "float" will search for floating-point numbers. "int" will only search for integers. "real" is a shortcut for "float" with --sign. "i" is a synonym for "int", "f" is a synonym for "float", and "r" is a synonym for "real". the default is int ⭐
• --nosign — do not consider "+" or "-" as part of a number, i.e. do not take sign into consideration. this is the default 🦋
• -s, --sign — consider "+" or "-" as part of a number, i.e. take sign into consideration. the default is unsigned 🔥
• --noexp — do not consider an exponential as part of a number, i.e. 1e4 would be considered as 1, "e", and 4, not as 10000. this only effects the --number-type=float. heads up bestie, it's exponent-free from here on out 💀
• -l, --locale — causes natsort to use locale-aware sorting. you will get the best results if you install PyICU 👑

okay tiny reminder: --nosign and --noexp and --sign are all real flags with real consequences, and -l really does want PyICU for best results — that's straight from the page, not me guessing 💖

🫶 sign-off 🫶

this lil beauty is natsort 8.4.0, dated July 2023 — go forth and sort naturally, bestie, you're literally the main character of your own directory 🌟💜