官术网_书友最值得收藏!

首頁 >

Plone 3 Products Development Cookbook

Accessing an IPython powered shell

IPython, a Python shell on steroids, provides an interactive environment for programmers, enriching and easing their experience during the development and debugging stages of the project. Some of its highlighted features are:

  • Object introspection
  • Code introspection
  • Documentation introspection (%pdoc magic command)
  • Input history, persistent across sessions
  • Tab auto-completion

Note

To learn more about IPython visit the project website at: http://ipython.scipy.org/moin.

These and more of its features will be quite useful to get used to Plone's code and to get to know better its API and documentation. IPython's particular mode to write doctests will also be a great help when working with them (refer to Creating doctests with IPython in Chapter 4 for more details about this).

How to do it…

To take full advantage of IPython inside Zope, we will create a new executable file in the bin directory: ipzope. To do so, we will add some lines in the buildout.cfg file:

  1. Include a new [ipzope] part at the bottom of the file: 
    [ipzope] 
# an IPython Shell for interactive use with zope running. 
# you also need to put  
# https://svn.plone.org/svn/collective/dotipython/trunk/
# ipy_profile_zope.py 
# to your $HOME/.ipython directory for the following to work. 
recipe = zc.recipe.egg 
eggs = 
    ipython 
    ${instance:eggs} 
initialization = 
    import sys, os 
    os.environ["SOFTWARE_HOME"] = "${zope2:location}/lib/python" 
    os.environ["INSTANCE_HOME"] = "${instance:location}" 
    sys.argv[1:1] = "-p zope".split() 
extra-paths = ${zope2:location}/lib/python 
scripts = ipython=ipzope
  2. Add the just created ipzope to the parts definition at the top of the file: 
    parts = 
    zope2 
    productdistros 
    instance 
    zopepy 
    plonesite 
 ipzope
  3. Install Python required modules (just for Windows): On Windows, you will need the PyReadline and ctypes packages. The easiest way to install PyReadline is to use the binary installer available at https://launchpad.net/pyreadline/+download. Download ctypes from http://python.net/crew/theller/ctypes and install it.
  4. Build your instance. Finally, build again the Zope instance to let it know that IPython is available: 
    ./bin/buildout

How it works…

Once built the new improved instance, we can run it in a special mode (when run in this mode, Zope won't listen to any port but to the direct console input) to get access to an IPython-powered shell:

./bin/ipzope

The first time you run ipzope, a new IPython profile directory will be created in your home folder. You'll be notified of this as shown in the following screenshot:

How it works…

In Linux, you can find this new folder at $HOME/.ipython. In Windows, it will be created in %userprofile%\_ipython (notice the underscore instead of a dot).

There's more…

To get used to ipzope and IPython facilities, we will launch ipzope and play around with our Plone site by setting some properties in its error_log tool:

  1. Open an IPython shell by running ./bin/ipzope.
  2. Write portal.error_log.get and then press the Tab key to get the list of error_log's available methods beginning with get.
  3. Check the results of getProperties by running portal.error_log.getProperties().
  4. After this, you should see that setProperties method is the one to use. But what is the syntax? Try %pdoc to get its docstring: %pdoc portal.error_log.setProperties.
  5. Was this helpful? Not really, so let's try with a different one. Try %psource to get the source code: %psource portal.error_log.setProperties.
  6. Great! So we now know how to pass the parameters to the previously mentioned setProperties method. Go ahead and clean the ignored_exceptions property by running portal.error_log.setProperties(20, True, ()).
  7. Done. Sure? Let's check: portal.error_log.getProperties().
  8. Don't forget to save the changes (that is, commit): utils.commit().
  9. Although we are working in a standalone Zope instance (ipzope doesn't listen to any port), it is always worthwhile to synchronize our session with changes other people might have made while we were working by using utils.sync().
    There's more…

Now, if you close the IPython session (by pressing Ctrl + D) and launch your Zope instance to open the Plone site in a browser, you'll see your changes at http://localhost:8080/plone/prefs_error_log_form.

Note

More information about IPython can be found at: http://ipython.scipy.org/moin/.

See also

  1. Creating doctests with IPython
主站蜘蛛池模板： 柳林县| 会昌县| 东辽县| 丹寨县| 瓮安县| 英德市| 兴山县| 鄂伦春自治旗| 合江县| 仁寿县| 公安县| 图们市| 安达市| 阿拉尔市| 汕尾市| 兖州市| 海门市| 万盛区| 休宁县| 盐边县| 福州市| 玉树县| 吉安县| 定远县| 通海县| 辛集市| 龙州县| 察雅县| 明星| 石狮市| 永兴县| 施甸县| 新和县| 公主岭市| 舒城县| 稻城县| 阿勒泰市| 新疆| 宣化县| 阿巴嘎旗| 武平县|