4. natsort API¶

Standard API
Convenience Functions

4.1. Standard API ¶

4.1.1. `natsorted()`¶

4.1.2. The `ns` enum ¶

4.1.3. `natsort_key()`¶

4.1.4. `natsort_keygen()`¶

4.2. Convenience Functions ¶

4.2.1. `realsorted()`¶

4.2.2. `humansorted()`¶

4.2.3. `index_natsorted()`¶

4.2.4. `index_realsorted()`¶

4.2.5. `index_humansorted()`¶

4.2.6. `order_by_index()`¶

4.2.7. Help With Bytes On Python 3 ¶

The official stance of natsort is to not support bytes for sorting; there is just too much that can go wrong when trying to automate conversion between bytes and str. But rather than completely give up on bytes, natsort provides three functions that make it easy to quickly decode bytes to str so that sorting is possible.

4.2.8. Help With Creating Function Keys ¶

If you need to create a complicated key argument to (for example) natsorted() that is actually multiple functions called one after the other, the following function can help you easily perform this action. It is used internally to natsort, and has been exposed publically for the convenience of the user.