File: ipython_plugin.page

package info (click to toggle)
accerciser 3.48.0-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 6,944 kB
  • sloc: python: 10,674; javascript: 163; xml: 94; makefile: 49; sh: 2
file content (72 lines) | stat: -rw-r--r-- 2,541 bytes parent folder | download | duplicates (10)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="ipython_plugin">
  <info>
    <link type="guide" xref="index#advanced" />
    <title type="sort">2. IPython Plugin</title>
    <link type="next" xref="howto_write_a_plugin" />
    <desc>
      When all else fails
    </desc>
    <credit type="author">
      <name>Eitan Isaacson</name>
      <email>eitan@ascender.com</email>
    </credit>
    <credit type="author">
      <name>Peter Parente</name>
      <email>pparent@us.ibm.com</email>
    </credit>
    <credit type="author">
      <name>Aline Bessa</name>
      <email>alibezz@gmail.com</email>
    </credit>
    <license>
      <p>Creative Commons Share Alike 3.0</p>
    </license>
  </info>
  <title> IPython Console Plugin</title>
  <p>
    The IPython Console Plugin allows real-time interaction with a selected item in the <link xref="desktop_tree_view">
    Application Tree View</link>. Since the IPython Console Plugin is an interactive Python shell, you can import any Python
    modules you want.
  </p>

  <note style="tip">
    <p>
      Make sure you have the standalone package IPython installed in your system. Otherwise, the IPython Console Plugin will
      not work properly.
    </p>
  </note>
  
  <section id="running_ipython_plugin">
    <title>Running the IPython Console Plugin</title>
    <p>
      To run the IPython Console Plugin, select one of the accessible items
      listed in the Application Tree View - either an application or a widget. In the plugin, the
      selected item will correspond to the variable 'acc'. 
    </p>
    <p>     
      Pressing <key>Tab</key> shows completions for the current command in the console,
      what can be useful for discovering pyatspi methods.
    </p>  

  <figure>
    <title>Investigating selected items with the IPython Console Plugin</title>
    <desc>
      The IPython Console Plugin lets you investigate methods, constants, and properties
      related to a selected item in the Application Tree View. 
    </desc>
    <media type="image" mime="image/png" width="800" height="500" src="figures/IPython_plugin.png">
      <p>
       The IPython Console Plugin lets you investigate methods, constants, and properties
       related to a selected item in the Application Tree View. 
      </p>
    </media>
  </figure>

  <note style="tip">
    <p>
      Typing <cmd>help(acc)</cmd> in the IPython Console Plugin shows some useful documentation
      about the corresponding selected accessible item.
    </p>
  </note>
  </section>
</page>