Changes between Version 11 and Version 12 of PythonGuidelines

Timestamp:

Apr 3, 2010 1:19:59 PM (14 years ago)

Author:

Chris Jerdonek

Comment:

Added a style section.

PythonGuidelines

@@ -28 +28 @@
   * webkitpy/python24/: code that needs to work under Python 2.4 (currently just the version-checking code)
   * [http://trac.webkit.org/browser/trunk/WebKitTools/Scripts/webkitpy webkitpy/thirdparty/]: all third-party code in webkitpy
+
+== Style ==
+
+For discussion purposes, here are some style guidelines to consider in addition to [http://www.python.org/dev/peps/pep-0008/ PEP8]:
+
+ * Prefer single quotes to double quotes.  Use double quotes only if the string contains single quotes (or if you are using "triple double quotes").  This makes cutting and pasting from the console easier since Python itself behaves this way when rendering string values to the console.
+ * Order `from` and `import` statements by the name of the leading module instead of putting all `from` statements before `import` statements:
+{{{
+# Correct:
+import logging
+from optparse import OptionParser
+import sys
+
+# Incorrect:
+from optparse import OptionParser
+import logging
+import sys
+}}}
+ This keeps the ordering the same when chaning a `from` statement to an `import` statement, or vice versa.
 
 == Upgrading from Python 2.3 or Python 2.4 ==