Gibt es eine detaillierte API-Dokumentation zur Python-Bindung für appindicator?

18

Ich werde ernsthaft mit einem eigenen Projekt und benötige eine gute Dokumentation zum Appindicator-Modul für Python. Was ich bisher gefunden habe:

  1. API-Dokumentation auf dev.ubuntu.com
  2. Community Wiki Eintrag
  3. API-Dokumentation zum C-Code
  4. Schöner Blogbeitrag

Was stimmt mit denen nicht:

  1. Nur eine Liste ohne Erklärungen zu den Argumenten, Ergebnissen und der Funktionsweise der Methoden
  2. Nur Überlegungen zum Design und Hintergründe - wenig, was bei der tatsächlichen Programmierung helfen würde
  3. Was das Python-Modul vermisst (zB create_menu_from_desktop)
  4. Viele nützliche Informationen komprimiert, aber nicht vollständig

Also brauche ich im Grunde etwas so Detailliertes wie 3. Aber für das Python-Modul.

Beispiel zu meinem Problem:

void build_menu_from_desktop (desktop_file, desktop_profile)

Was sollen die Argumente sein und was macht die Methode? Ich vermute, die Methode erstellt Menüeinträge aus einer '* .desktop'-Datei. Aber wenn ja, warum braucht es mehr Argumente als nur diese Datei? Aus welchen Einträgen in der Datei stammen die Menüpunkte? Es sind Fragen wie diese, für die es mir schwer fällt, eine Antwort zu finden.

verwechseln
quelle
2
Die Links 1 und 3 funktionieren nicht.
Matt Joiner
2
... mehr ...
con-f-use

Antworten:

7

Ja, wir stellen fest, dass wir eine Python-Dokumentation mit dem entsprechenden Detaillierungsgrad benötigen. Das ist das Ziel des Giraffenprojekts . Es funktioniert mit den GObject Introspection-Bindungen. Auf diese Weise sollten neue Python-Anwendungen geschrieben werden, um die Anwendungsindikatoren zu verwenden.

Bis dahin ist die API-Dokumentation, die Sie notiert haben, die beste Wahl. Es sollte ungefähr das gleiche sein, obwohl "Python-ified".

Das build_menu_from_desktop ist eine praktische Funktion, mit der Sie die Einträge laden können, die sich ansonsten in einer Art Quicklist in Unity befinden würden . Um diese Einträge zu erhalten, müssen Sie build_menu_from_desktop("/my/path/myfile.desktop", "Unity")die Zielumgebung angeben.

Dies ermöglicht es Ihnen, unterschiedliche Einträge in der Desktop-Datei zu haben und einige zu überlappen und andere nicht.

Ted Gould
quelle
Das etwa beantwortet es. Danke, dass Sie sich die Zeit genommen haben. Warum nicht gleich Docstrings oder Sauerstoff?
con-f-use
1
Wir benutzen gtk-doc. Im Grunde das Gleiche. Es überträgt sich aber noch nicht auf die Bindungen.
Ted Gould
1
Sie könnten das Menü erhalten und dort ändern, aber ich würde das nicht empfehlen. Wenn sie unterschiedlich sein müssen, würde ich das Menü einfach auf die normale Art und Weise erstellen ... Eigentlich ist die Funktion nur als Helfer gedacht, wenn Sie möchten, dass sie gleich sind.
Ted Gould
1
Ich wollte nur prüfen, ob es Updates zu Giraffe und Qucklisten gibt ...
con-f-use
1
Wie ist der Stand der Dinge? Warum sind alle googleable AppIndicator API-Dokumentverknüpfungen defekt? Gibt es einen einzigen am Leben?
Ulidtko