Changes between Version 16 and Version 17 of DeveloperGuidelines/Basics

Timestamp:

08/14/14 04:53:37 (11 years ago)

Author:

Michael Howden

Comment:

--

DeveloperGuidelines/Basics

@@ -116 +116 @@
 * XSLT: http://www.w3schools.com/xsl/default.asp
 * [http://codespeak.net/lxml/tutorial.html lxml Tutorial]
+
+== Debugging ==
+=== Python ===
+* Use the [DeveloperGuidelines/Eclipse Eclipse IDE] to be able to set breakpoints and inspect expressions.
+* WSGI likes print statements to go to {{{sys.stderr}}} not {{{sys.stdout}}}: http://code.google.com/p/modwsgi/wiki/DebuggingTechniques
+* use Web2Py shell: http://www.vimeo.com/879939
+* use [http://ipython.scipy.org/moin/ IPython] for interactive exploration (on Windows, install [http://ipython.scipy.org/moin/PyReadline/Intro PyReadline])
+* use [http://groups.google.com/group/web2py/browse_thread/thread/cc13960a5079b2d5# FirePy] to see logging output to Console (to view with Firebug)
+* Log to a File: http://groups.google.com/group/web2py/browse_thread/thread/e20d0bd2e542aa14
+* Debug Tools: http://docs.python.org/library/debug.html
+* Use [http://stackoverflow.com/questions/2654113/python-how-to-get-the-callers-method-name-in-the-called-method Inspect] to check which function called the one you're troubleshooting:
+{{{
+import inspect
+curframe = inspect.currentframe()
+calframe = inspect.getouterframes(curframe, 2)
+current.log.debug("caller name: %s" % calframe[1][3])
+}}}
+ * Debug SQL Queries:
+{{{
+vi gluon/dal.py
+class BaseAdapter()
+    def select():
+        def response(sql):
+            if "searchphrase" in sql:
+                current.log.debug("Query: %s" % query)
+                current.log.debug("SQL: %s" % sql)
+}}}
+ * Debug Views:
+{{{
+vi gluon/globals.py
+    def write(self, data, escape=True):
+        try:
+            ...All Old Code ...
+        except Exception, error:
+            # Put Eclipse breakpoint on the below line
+            exc_type, exc_value, exc_traceback = sys.exc_info()
+            pass
+}}}
+* [http://aymanh.com/python-debugging-techniques Python Debugging Techniques]
+ * Insert these statements into your code
+  * Get a Python shell up to explore interactively: {{{import code; code.interact(locals=locals()}}}
+  * Get a full stack trace: {{{import pdb; pdb.set_trace()}}}
+* winpdb: http://groups.google.com/group/web2py/msg/ee46125b7c93fdd4
+* WingIDE: http://www.wingware.com/
+ * Using with Web2Py: http://www.wingware.com/doc/howtos/web2py
+* [DeveloperGuidelines/Eclipse Eclipse] IDE
+* Unicode:
+ * "Decode early, Unicode everywhere, Encode late": http://farmdev.com/talks/unicode/
+ * http://boodebr.org/main/python/all-about-python-and-unicode
+* Python Design Patterns:
+ * http://www.youtube.com/watch?v=Er5K_nR5lDQ
+ * http://videolectures.net/youtube_martelli_python/
+
+=== HTML, CSS, and Javascript ===
+
+Each of the major browsers has tools available for viewing HTML page structure and form data, Javascript code, CSS.  Some also support Javascript debugging, including setting breakpoints and viewing values in variables.
+
+* Firefox: Install the [https://addons.mozilla.org/en-US/firefox/addon/firebug/ Firebug] plugin.  Start Firebug by clicking the bug icon in the upper right.  After the tools open in the lower half of the page, load the page you want to debug.
+
+* Chrome: Open the [https://developers.google.com/chrome-developer-tools/ Chrome developer tools] with Chrome menu (three bar icon) -> Tools -> Developer tools.
+
+* Internet Explorer: Open the [http://msdn.microsoft.com/library/ie/bg182326%28v=vs.85%29 IE developer tools] with F12, or Tools (gear icon) -> F12 Developer Tools.  Note that you can test behavior of pages under earlier versions of IE by setting your current IE to behave as earlier versions.  In the developer tools menu bar, click Browser Mode and select the desired version.
+
+Other tools that may be of interest:
+
+* use [http://www.sprymedia.co.uk/article/Visual+Event Visual Event] to see which events are active.
+* use Venkman: http://www.mozilla.org/projects/venkman/
+* use Fiddler for compressed files: http://www.yuiblog.com/blog/2008/06/27/fiddler
+* http://pastebin.me (allows edits of HTML & previews)
+* http://jsfiddle.net (allows edits of JS & previews)
+* http://yura.thinkweb2.com/domlint/
+ * http://www.jslint.com/lint.html
+* IE6 cheatsheet: http://www.virtuosimedia.com/tutorials/ultimate-ie6-cheatsheet-how-to-fix-25-internet-explorer-6-bugs
+
+== Additional Tips ==
+''See:'' DeveloperGuidelines/Tips