summaryrefslogtreecommitdiffstats
path: root/HACKING.rst
diff options
context:
space:
mode:
authorZhongyue Luo <zhongyue.nah@intel.com>2013-02-04 10:07:08 +0800
committerZhongyue Luo <zhongyue.nah@intel.com>2013-02-04 11:12:25 +0800
commit896295844a527327b0cd86b10244f403b31f155f (patch)
treeac6c8c32db1115885fe01fa5af775a6d73480a33 /HACKING.rst
parentee955d272ab4eef2e8371f2e460454058ce7e46c (diff)
downloadnova-896295844a527327b0cd86b10244f403b31f155f.tar.gz
nova-896295844a527327b0cd86b10244f403b31f155f.tar.xz
nova-896295844a527327b0cd86b10244f403b31f155f.zip
Update HACKING.rst per recent changes
Added "is not" usage with examples * https://review.openstack.org/#/c/20865/ Fixed "not in" usage description * https://review.openstack.org/#/c/20875/ Fixed some "not X in Y" corner cases. Change-Id: I7534ef73e6fd525fd8f4bee594a4b37524699c08
Diffstat (limited to 'HACKING.rst')
-rw-r--r--HACKING.rst13
1 files changed, 10 insertions, 3 deletions
diff --git a/HACKING.rst b/HACKING.rst
index 54e3b3275..213495832 100644
--- a/HACKING.rst
+++ b/HACKING.rst
@@ -28,16 +28,23 @@ General
mylist = Foo().list() # OKAY, does not shadow built-in
+- Use the "is not" operator when testing for unequal identities. Example::
-- Use the "not in" operator for collection membership evaluation. Example::
+ if not X is Y: # BAD, intended behavior is ambiguous
+ pass
+
+ if X is not Y: # OKAY, intuitive
+ pass
+
+- Use the "not in" operator for evaluating membership in a collection. Example::
- if not X in Y: # BAD, hard to understand
+ if not X in Y: # BAD, intended behavior is ambiguous
pass
if X not in Y: # OKAY, intuitive
pass
- if not (X in Y or X is Z): # OKAY, still better than all those 'not's
+ if not (X in Y or X in Z): # OKAY, still better than all those 'not's
pass