Me estoy poniendo serio con un proyecto propio y necesito una buena documentación sobre el módulo appindicator para python. Lo que he encontrado hasta ahora:
- Documentación de API en dev.ubuntu.com
- Entrada de wiki comunitaria
- Documentación API en el código C
- Buena publicación de blog
que hay de malo con ellos:
- Solo una lista sin explicaciones sobre los argumentos, los retornos y lo que hacen los métodos
- Solo consideraciones de diseño y antecedentes: poco que ayudaría con la programación real
- Cosas que faltan en el módulo de Python (p. Ej. Create_menu_from_desktop)
- Mucha información útil comprimida pero no completa
Básicamente, necesito algo tan detallado como 3. pero para el módulo de Python.
Ejemplo sobre mi problema:
void build_menu_from_desktop (desktop_file, desktop_profile)
¿Cuáles son los argumentos que se supone que son y qué hace el método? Supongo que el método crea entradas de menú a partir de un archivo '* .desktop'. Pero si es así, ¿por qué necesita más argumentos que solo ese archivo? ¿De qué entradas del archivo toma los elementos del menú? Para preguntas como esta me cuesta un poco encontrar una respuesta.
Respuestas:
Sí, nos damos cuenta de que necesitamos documentación de Python con el nivel de detalle apropiado. Ese es el objetivo del proyecto Giraffe . Funcionará con los enlaces de introspección GObject, que es la forma en que las nuevas aplicaciones Python deben escribirse para usar los indicadores de la aplicación.
Hasta entonces, la mejor apuesta es la documentación de la API que has anotado. Debería ser más o menos lo mismo aunque "pitón-ified".
Build_menu_from_desktop es una función conveniente para cargar las entradas que de otro modo estarían en algo así como una lista rápida en Unity . Entonces, para obtener esas entradas que usaría
build_menu_from_desktop("/my/path/myfile.desktop", "Unity")para especificar el entorno de destino.Esto le permite tener diferentes entradas en el archivo del escritorio y tener algunas superposiciones y otras no.
fuente