Existe uma documentação detalhada da API sobre a ligação do python para appindicator?

18

Estou ficando sério com um projeto próprio e preciso de uma boa documentação no módulo appindicator para python. O que eu encontrei até agora:

  1. Documentação da API no dev.ubuntu.com
  2. Entrada do wiki da comunidade
  3. Documentação da API no código C
  4. Nice post do blog

o que há de errado com eles:

  1. Apenas uma lista sem explicações sobre os argumentos, retornos e o que os métodos fazem
  2. Apenas considerações e antecedentes de design - pouco que ajudaria na programação real
  3. Material em falta no módulo python (por exemplo, create_menu_from_desktop)
  4. Muitas informações úteis compactadas, mas não completas

Então, basicamente, preciso de algo tão detalhado quanto 3., mas para o módulo python.

Exemplo no meu problema:

void build_menu_from_desktop (arquivo de área de trabalho, perfil de área de trabalho)

Quais devem ser os argumentos e o que o método faz? Meu palpite é que o método cria entradas de menu a partir de um arquivo '* .desktop'. Mas se sim, por que precisa de mais argumentos do que apenas esse arquivo? De quais entradas do arquivo são retirados os itens de menu? É para perguntas como esta que estou tendo dificuldade em encontrar uma resposta.

confundir
fonte
2
Os links 1 e 3 não funcionam.
precisa
2
... mais ...
con-f-use

Respostas:

7

Sim, percebemos que precisamos da documentação do Python com o nível de detalhe apropriado. Esse é o objetivo do projeto Giraffe . Ele funcionará com as ligações do GObject Introspection, que é a maneira como os novos aplicativos Python devem ser gravados para usar os indicadores de aplicativo.

Até então, a melhor aposta é a documentação da API que você anotou. Deve ser aproximadamente o mesmo, embora seja "python-ified".

O build_menu_from_desktop é uma função de conveniência que utiliza para carregar as entradas que, de outra forma, estariam em algo como uma lista rápida no Unity . Portanto, para obter essas entradas, você usaria build_menu_from_desktop("/my/path/myfile.desktop", "Unity")para especificar o TargetEnvironment.

Isso permite que você tenha entradas diferentes no arquivo da área de trabalho e tenha alguma sobreposição e outras não.

Ted Gould
fonte
Isso responde. Obrigado por reservar um tempo. Por que não docstrings ou doxygen em primeiro lugar?
con-f-use
11
Estamos usando o gtk-doc. Basicamente a mesma coisa. Mas ainda não é transferido para as ligações.
Ted Gould
11
Você pode pegar o menu e alterá-lo lá, mas eu não recomendo isso. Se eles precisarem ser diferentes, eu apenas criaria o menu da maneira normal ... Realmente, a função pretende ser apenas um auxiliar no caso de você querer que sejam iguais.
Ted Gould # 1
11
Só queria verificar se lá está nenhuma atualização sobre Giraffe e qucklists ...
con-f-use
11
Qual é o estado disso? Por que todos os links de documentos da API do AppIndicator podem ser quebrados? Existe um único vivo?
ulidtko