3.4. versorted()

natsort.versorted(seq, key=None, reverse=False, as_path=None, alg=0)

Convenience function to sort version numbers.

Convenience function to sort version numbers. This is a wrapper around natsorted(seq, alg=ns.VERSION).

Parameters:

seq : iterable

The sequence to sort.

key : callable, optional

A key used to determine how to sort each element of the sequence. It is not applied recursively. It should accept a single argument and return a single value.

reverse : {True, False}, optional

Return the list in reversed sorted order. The default is False.

as_path : {True, False}, optional

Depreciated as of version 3.5.0 and will become an undocumented keyword-only argument in 4.0.0. Please use the alg argument for all future development. See ns class documentation for details.

alg : ns enum, optional

This option is used to control which algorithm natsort uses when sorting. For details into these options, please see the ns class documentation. The default is ns.FLOAT.

Returns:

out : list

The sorted sequence.

See also

index_versorted
Returns the sorted indexes from versorted.

Examples

Use versorted just like the builtin sorted:

>>> a = ['num4.0.2', 'num3.4.1', 'num3.4.2']
>>> versorted(a)
[u'num3.4.1', u'num3.4.2', u'num4.0.2']