Czy istnieje szczegółowa dokumentacja API dotycząca powiązania Pythona dla appindicator?


18

Zaczynam mieć problemy z własnym projektem i potrzebuję dobrej dokumentacji na temat modułu appindicator dla Pythona. Co znalazłem do tej pory:

  1. Dokumentacja API na dev.ubuntu.com
  2. Wpis wiki społeczności
  3. Dokumentacja API dotycząca kodu C.
  4. Niezły post na blogu

co jest z nimi nie tak:

  1. Tylko lista bez wyjaśnień na temat argumentów, zwrotów i działania metod
  2. Tylko względy projektowe i tła - niewiele, które pomogłyby w rzeczywistym programowaniu
  3. Rzeczy brakuje modułu Pythona (np. Create_menu_from_desktop)
  4. Wiele użytecznych informacji jest skompresowanych, ale niekompletnych

Tak więc w zasadzie potrzebuję czegoś tak szczegółowego jak 3., ale dla modułu python.

Przykład mojego problemu:

void build_menu_from_desktop (plik_ desktop, profil_ desktop)

Jakie powinny być argumenty i co robi metoda? Domyślam się, że metoda tworzy pozycje menu z pliku „* .desktop”. Ale jeśli tak, to dlaczego potrzebuje więcej argumentów niż tylko ten plik? Z jakich pozycji w pliku pobiera elementy menu? To takie pytania, na które trudno mi znaleźć odpowiedź.


2
Linki 1 i 3 nie działają.
Matt Joiner,

2
... już ...
con-f-use

Odpowiedzi:


7

Tak, zdajemy sobie sprawę, że potrzebujemy dokumentacji w języku Python o odpowiednim poziomie szczegółowości. Taki jest cel projektu Giraffe . Będzie działał z powiązaniami introspekcji GObject, w taki sposób należy pisać nowe aplikacje w języku Python, aby korzystać ze wskaźników aplikacji.

Do tego czasu najlepszym rozwiązaniem jest zanotowana dokumentacja API. Powinno być mniej więcej takie samo, choć „python-ified”.

Build_menu_from_desktop to funkcja wygodna w użyciu, wczytaj wpisy, które w innym przypadku znajdowałyby się na szybkiej liście w Unity . Aby uzyskać te wpisy, których build_menu_from_desktop("/my/path/myfile.desktop", "Unity")użyłbyś do określenia TargetEnvironment.

Dzięki temu możesz mieć różne wpisy w pliku na pulpicie, niektóre nakładają się, a inne nie.


To dotyczy odpowiedzi. Dzięki za poświęcenie czasu. Dlaczego nie docstringi lub doksygen?
con-f-use

1
Używamy gtk-doc. Zasadniczo to samo. Ale nie przenosi się jeszcze na wiązania.
Ted Gould

1
Możesz dostać menu i je tam zmienić, ale nie polecam tego. Gdyby musiały być inne, po prostu zbudowałem menu w normalny sposób ... Naprawdę funkcja ta ma być tylko pomocnikiem w przypadku, gdy chcesz, aby były takie same.
Ted Gould

1
Chciałem tylko sprawdzić, czy są jakieś aktualizacje na temat żyrafy i listy ekspertów ...
con-f-use

1
Jaki jest tego stan? Dlaczego wszystkie odnośniki do dokumentów interfejsu API interfejsu API Google AppIndicator są zepsute? Czy jest jeden żywy?
ulidtko
Korzystając z naszej strony potwierdzasz, że przeczytałeś(-aś) i rozumiesz nasze zasady używania plików cookie i zasady ochrony prywatności.
Licensed under cc by-sa 3.0 with attribution required.