Changes between Version 1 and Version 2 of PythonGuidelines

Timestamp:

Mar 7, 2010, 5:02:36 PM (15 years ago)

Author:

Chris Jerdonek

Comment:

Minor updates. Added a FIXME to include upgrade instructions.

PythonGuidelines

@@ -5 +5 @@
  * Most of the Python code is in [http://trac.webkit.org/browser/trunk/WebKitTools/Scripts/webkitpy WebKitTools/Scripts/webkitpy]. 
  * [http://trac.webkit.org/browser/trunk/WebKitTools/Scripts WebKitTools/Scripts] also contains some Python code in the form of end-user scripts.  Generally, we try to keep as much of the code in webkitpy as possible since this allows the code to be organized more nicely, for unit tests to be in companion files, etc.
- * Unit test files are in correspondence with modules.  A unit test module has the name module_unittest.py, if module.py is the name of the module.
+ * Unit test files are in correspondence with modules.  For example, if module.py is the name of a module, its unit test file would be module_unittest.py and would lie in the same directory.
  * Informally, we try to follow [http://www.python.org/dev/peps/pep-0008/ PEP8].
  * We put all third-party Python code in [http://trac.webkit.org/browser/trunk/WebKitTools/Scripts/webkitpy webkitpy/thirdparty].
  * [http://trac.webkit.org/browser/trunk/WebKitTools/Scripts/test-webkitpy Scripts/test-webkitpy] unit tests the Python code.
- * WebKit uses Python 2.4.
+ * Most of WebKit's Python scripts require Python 2.5 to run.
+
+== Upgrading Python ==
+
+FIXME: fill in this section.
 
 == Mac OS X Snow Leopard ==
+
+(This section may not be necessary.  WebKit is still discussing what Python versions we need to support.)
 
 Python 2.4 is not officially installed or supported on Snow Leopard (Mac OS X 10.6).  Because of this, you may need to install Python 2.4 yourself.  After installing [http://guide.macports.org/ MacPorts], you should be able to install Python 2.4 and python_select as follows (roughly).  python_select allows you to quickly go back and forth between Python versions: