Rooba
/
bidict
mirror of https://github.com/jab/bidict.git
1
1
Fork 0
Code Issues Packages Projects Releases Wiki Activity

docs tweaks

This commit is contained in:
jab 2015-07-10 01:34:03 +00:00
parent cac7771046
commit ea545c7bf8
1 changed files with 6 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
docs/caveat-none-slice.rst.inc
View File

@ -23,17 +23,14 @@ so it can't tell whether you wrote
referring to an inverse mapping,
or
``b[None:]``,
referring to a forward mapping.
or for that matter
``b[:]``,
which wouldn't be meaningful at all.
referring to a forward mapping
(or for that matter ``b[:]``).
In this case,
lacking any known good alternatives,
bidict currently throws a :class:`TypeError`,
which unfairly puts the burden of disambiguation on the user
for something that was unambiguous to the user in the first place.
Sometimes Python syntax hacks have their limits.
The upshot of this is
if you will be storing ``None`` as a key (or value) in a bidict,
@ -44,5 +41,7 @@ Instead you have to do something like::
>>> b.inv[None]
'foo'
Suggestions for better ways to handle this edge case
would be gratefully received.
Ideas have been explored to make this edge case work
but no robust solutions have been found.
The limits of Python syntax hacks.
Faugh!