My favorite python ide is Eclipse + Pydev. Pydev is a good eclipse plugin to make develop with python efficiently. But you will find its Autoformat (code format) feature is too simple to make things work.
I worked with some python newbie, they are just learning python and don’t know what is PEP08 (Style Guide for Python Code). Usually, they are experts in some other languages like C++, Java or C# with powerful IDE. They rely on code completion and code format feature too much. When they use Eclipse + Pydev, the source code they written is terrible…
I searched python code formatter (beautifier) for a long time. Unfortunately, there is no good product or tool to do that. Finally, the tool which is the closest to what I want is PythonTidy. This script format your code to fulfill PEP08 and it can be customized to satisfy the coding standard in your team.
The problem is PythonTidy is a standalone script to run it. This is not very convenient for us to use it. We must make pydev to integrated with PythonTidy to enhance its code format feature.
Basically, the pydev is a extensible tool to make us integrated PythonTidy easily. You can write some Jython script to extend pydev if you familiar with Java and Eclipse also. I wrote a simple script to make PythonTidy work while we press Ctrl+Shift+F.
If you want to use it, save the code below in somewhere you want as pyedit_pythontidy.py (pyedit_ is required).
This code is public domain.
The original author is Bear Huang (http://bear330.wordpress.com/).
from org.python.pydev.editor import PyEdit #@UnresolvedImport
cmd = 'command string'
editor = PyEdit
assert cmd is not None
assert editor is not None
if cmd == 'onCreateActions':
# from org.eclipse.jface.action import Action
from org.python.pydev.editor.actions import PyAction
from org.python.pydev.core.docutils import PySelection
from java.lang import Runnable
from org.eclipse.swt.widgets import Display
from org.eclipse.jface.text import IDocument
from org.eclipse.jface.text import TextSelection
from java.io import FileWriter
FORMAT_ACTION_DEFINITION_ID = "org.python.pydev.editor.actions.pyFormatStd"
FORMAT_ACTION_ID = "org.python.pydev.editor.actions.navigation.pyFormatStd"
def __init__(self, *args, **kws):
PyAction.__init__(self, *args, **kws)
ps = PySelection(editor)
doc = ps.getDoc()
startLine = ps.getStartLineIndex()
p1 = tempfile.mktemp()
p2 = tempfile.mktemp()
f1 = FileWriter(p1)
formatAll = False
if ps.getTextSelection().getLength() == 0:
# format all.
c = doc.get()
formatAll = True
# format selection.
#c = ps.getSelectedText()
print "Format selected text is not supported yet."
# A kind of solution is to insert a special comment in
# front and end of selection text, pythontidy it, and
# extract text according that comment.
os.system('PythonTidy.py "%s" "%s"' % (p1, p2))
f2 = open(p2, "r")
result = f2.read()
if startLine >= doc.getNumberOfLines():
startLine = doc.getNumberOfLines() - 1
#doc.replace(doc.getLineOffset(startLine), 0, result)
sel = TextSelection(doc, doc.getLineOffset(startLine), 0)
except java.lang.Exception, e:
act = PythonTidyAction()
'''Helper class that implements a Runnable (just so that we
can pass it to the Java side). It simply calls some callable.
def __init__(self, c):
self.callable = c
@param callable: the callable that will be run in the UI
Next, go to eclipse pydev preferences page to specify the script location:
Now, you can simply press Ctrl+Shift+F while edit python code.
(Format selected text is not supported yet, this is because I am too lazy to implement it in this time. If I have time and wish to do that, I will publish it as soon as posible.)
Any contributions are appreciated.