<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="ipython_plugin" xml:lang="pt_BR">
  <info>
    <link type="guide" xref="index#advanced"/>
    <title type="sort">2. Plug-in IPython</title>
    <link type="next" xref="howto_write_a_plugin"/>
    <desc>Quando tudo mais falha</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>Atribuição Compartilhada Igual 3.0 - Creative Commons</p>
    </license>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Enrico Nicoletto</mal:name>
      <mal:email>liverig@gmail.com</mal:email>
      <mal:years>2008.</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Fabrício Godoy</mal:name>
      <mal:email>skarllot@gmail.com</mal:email>
      <mal:years>2008.</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Leonardo Ferreira Fontenelle</mal:name>
      <mal:email>leonardof@gnome.org</mal:email>
      <mal:years>2008.</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Rafael Fontenelle</mal:name>
      <mal:email>rafaelff@gnome.org</mal:email>
      <mal:years>2025.</mal:years>
    </mal:credit>
  </info>
  <title>Plug-in Console IPython</title>
  <p>O plug-in Console IPython permite interação em tempo real com um item selecionado na <link xref="desktop_tree_view"> Visão em Árvore de Aplicativos</link>. Como o plug-in Console IPython é um shell Python interativo, você pode importar quaisquer módulos Python que desejar.</p>

  <note style="tip">
    <p>Certifique-se de ter o pacote standalone IPython instalado no seu sistema. Caso contrário, o plug-in Console IPython não funcionará corretamente.</p>
  </note>
  
  <section id="running_ipython_plugin">
    <title>Executando o plug-in Console IPython</title>
    <p>Para executar o plug-in Console IPython, selecione um dos itens acessíveis listados na Visão em Árvore de Aplicativos - um aplicativo ou um widget. No plug-in, o item selecionado corresponderá à variável 'acc'.</p>
    <p>Pressionar <key>Tab</key> mostra os preenchimentos automático do comando atual no console, o que pode ser útil para descobrir métodos pyatspi.</p>  

  <figure>
    <title>Investigando itens selecionados com o plug-in Console IPython</title>
    <desc>O plug-in Console IPython permite que você investigue métodos, constantes e propriedades relacionadas a um item selecionado na Visão em Árvore de Aplicativos.</desc>
    <media type="image" mime="image/png" width="800" height="500" src="figures/IPython_plugin.png">
      <p>O plug-in Console IPython permite que você investigue métodos, constantes e propriedades relacionadas a um item selecionado na Visão em Árvore de Aplicativos.</p>
    </media>
  </figure>

  <note style="tip">
    <p>Digitar <cmd>help(acc)</cmd> no plug-in Console IPython mostra alguma documentação útil sobre o item acessível selecionado correspondente.</p>
  </note>
  </section>
</page>
