Safe comparisons (total ordering) for any object in Python 3
Project description
In Python 2, it was possible to compare any object:
>>> None > 2 False >>> [] < object() True
But this is no longer true in Python 3:
>>> None > 2 ... TypeError: '>' not supported between instances of 'NoneType' and 'int' >>> [] < object() ... TypeError: '<' not supported between instances of 'list' and 'object'
But there are many cases where it is useful to, for example:
Sort heterogeneous lists (ie, lists that contain many types of object)
Compare objects to None (for example, to find the max(...) of a list where some items may be None)
Write generic functions which will have robust, deterministic behaviour on arbitrary input
safe_cmp provides functions for safely sorting and ordering any value in Python 3. In fancy math terms, safe_cmp implements a total ordering of all values in Python 3 [1].
safe_cmp implements Python 2 compatible safe versions of the ordering functions:
safe_cmp: a Python 2 compatible implementation of cmp for Python 3
safe_sorted: a safe version of sorted(...)
safe_min: a safe version of min(...)
safe_max: a safe version of max(...)
And provides a wrapper - safe_order - which defines a total ordering for any object (for example, heterogeneous_list.sort(key=safe_order)).
Examples
Sorting a heterogeneous list:
>>> from safe_cmp import safe_sorted, safe_order
>>> items = [1, None, "foo", {}, object]
>>> list(safe_sorted(items)) # Using "safe_sorted"
[None, {}, 1, 'foo', object]
>>> items.sort(key=safe_order) # Using "safe_order" with key=
>>> items
[None, {}, 1, 'foo', object]
Finding the max of a list which includes nulls:
>>> from safe_cmp import safe_max
>>> safe_max([1, None, 3, None, 4])
4
The rare situation where Python 2 style cmp is useful:
>>> from safe_cmp import safe_cmp
>>> safe_cmp(None, 1)
-1
>>> safe_cmp(None, None)
0
>>> safe_cmp(1, None)
1
Note: safe_cmp will produce Python 2 compatible results when called with nan:
>>> from safe_cmp import safe_cmp
>>> nan = float("NaN")
>>> safe_cmp(nan, 1)
-1
>>> safe_cmp(1, nan)
1
>>> safe_cmp(nan, nan)
0
As will safe_sorted:
>>> from safe_cmp import safe_sorted
>>> list(safe_sorted([nan, 2, nan, 1]))
[nan, 2, nan, 1]
Performance
Currently safe_cmp methods are currently implemented in Python (in contrast to their unsafe builtin counterparts, which are implemented in C), so performance will notable worse for large comparisons:
In [1]: %timeit safe_max(range(10000000)) 2.8 s ± 42 ms per loop (mean ± std. dev. of 7 runs, 1 loop each) In [2]: %timeit max(range(10000000)) 345 ms ± 6.23 ms per loop (mean ± std. dev. of 7 runs, 1 loop each)
For smaller comparisons, though, the difference will be negligible:
In [1]: %timeit safe_max(1, 2) 682 ns ± 7.12 ns per loop (mean ± std. dev. of 7 runs, 1000000 loops each) In [2]: %timeit max(1, 2) 218 ns ± 6.87 ns per loop (mean ± std. dev. of 7 runs, 1000000 loops each)
If there is interest in performant implementations, however, they will be straight forward to provide.
Additionally, where obvious, performance optimizations have been implemented (for example, caching the result of key= functions).
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file safe_cmp-0.1.1.tar.gz
.
File metadata
- Download URL: safe_cmp-0.1.1.tar.gz
- Upload date:
- Size: 5.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.4.0 requests-toolbelt/0.9.1 tqdm/4.46.0 CPython/3.8.2
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | dd0f984fb9ac4ae95b0d608e8d78801780fdcac432878841b31e27ec93e58114 |
|
MD5 | bdc5ec0ef5ff1f97ac418d64fb5626da |
|
BLAKE2b-256 | 529ec9ad3a175e8b14825a7eb2be4739650669dfcd99c931217ab3401290361a |
Provenance
File details
Details for the file safe_cmp-0.1.1-py3-none-any.whl
.
File metadata
- Download URL: safe_cmp-0.1.1-py3-none-any.whl
- Upload date:
- Size: 5.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.4.0 requests-toolbelt/0.9.1 tqdm/4.46.0 CPython/3.8.2
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0d38f011f25f6434ac453a6bdd1958b0da71181da49bfdfda356e6e5865d8579 |
|
MD5 | 35144d1235dde17e2e8165d937d91f8e |
|
BLAKE2b-256 | 0c752e781123e11431bf99ad2fbf42f8c685e07545f9a610d8756092de9f94e0 |