Existe-t-il une documentation API détaillée sur la liaison python pour appindicator?

18

Je deviens sérieux avec mon propre projet et j'ai besoin d'une bonne documentation sur le module appindicator pour python. Ce que j'ai trouvé jusqu'à présent:

  1. Documentation API sur dev.ubuntu.com
  2. Entrée wiki communautaire
  3. Documentation API sur le code C
  4. Bon article de blog

Qu'est-ce qui ne va pas avec eux:

  1. Juste une liste sans explications sur les arguments, les retours et sur ce que font les méthodes
  2. Uniquement des considérations et des arrière-plans de conception - peu qui pourraient aider à la programmation réelle
  3. Truc manquant le module python a (par exemple create_menu_from_desktop)
  4. Beaucoup d'informations utiles compressées mais pas complètes

Donc, fondamentalement, j'ai besoin de quelque chose d'aussi détaillé que 3. mais pour le module python.

Exemple sur mon problème:

void build_menu_from_desktop (desktop_file, desktop_profile)

Quels sont les arguments censés être et que fait la méthode? Je suppose que la méthode crée des entrées de menu à partir d'un fichier '* .desktop'. Mais si c'est le cas, pourquoi a-t-il besoin de plus d'arguments que ce seul fichier? De quelles entrées du fichier prend-il les éléments de menu? Ce sont des questions comme celle-ci que j'ai un peu de mal à trouver une réponse.

embrouiller
la source
2
Les liens 1 et 3 ne fonctionnent pas.
Matt Joiner
2
... plus ...
con-f-use

Réponses:

7

Oui, nous réalisons que nous avons besoin d'une documentation Python avec le niveau de détail approprié. Tel est l'objectif du projet Giraffe . Il fonctionnera avec les liaisons GObject Introspection, ce qui est la façon dont les nouvelles applications Python doivent être écrites pour utiliser les indicateurs d'application.

Jusque-là, le meilleur pari est la documentation API que vous avez notée. Il devrait être à peu près le même si "python-ified".

Le build_menu_from_desktop est une fonction de commodité qui permet de charger les entrées qui seraient autrement dans quelque chose comme une liste rapide dans Unity . Donc, pour obtenir ces entrées, vous utiliseriez build_menu_from_desktop("/my/path/myfile.desktop", "Unity")pour spécifier le TargetEnvironment.

Cela vous permet d'avoir différentes entrées dans le fichier de bureau et d'avoir des chevauchements et d'autres non.

Ted Gould
la source
Cela répond à cela. Merci de prendre le temps. Pourquoi pas docstrings ou doxygen en premier lieu?
con-f-use
1
Nous utilisons gtk-doc. Fondamentalement, la même chose. Mais il n'est pas encore transféré aux fixations.
Ted Gould
1
Vous pouvez obtenir le menu et les modifier, mais je ne le recommanderais pas. S'ils doivent être différents, je construirais simplement le menu de la manière normale ... Vraiment, la fonction n'est destinée qu'à être une aide dans le cas où vous souhaitez qu'ils soient les mêmes.
Ted Gould
1
Je voulais juste vérifier s'il y avait des mises à jour sur Giraffe et qucklists ...
con-f-use
1
Quel est l'état de tout ça? Pourquoi tous les liens de documentation de l'API AppIndicator googleable sont-ils rompus? Y en a-t-il un seul vivant?
ulidtko