มีเอกสารรายละเอียด API ใน python binding สำหรับ appindicator หรือไม่?


18

ฉันเริ่มเซรุ่มกับโครงการของตัวเองและต้องการเอกสารประกอบที่ดีเกี่ยวกับโมดูล appindicator สำหรับ python สิ่งที่ฉันพบ:

  1. เอกสารประกอบ API บน dev.ubuntu.com
  2. รายการวิกิชุมชน
  3. เอกสารประกอบ API บนรหัส C
  4. โพสต์บล็อกที่ดี

มีอะไรผิดปกติกับพวกเขา:

  1. เพียงแค่รายการที่ไม่มีคำอธิบายเกี่ยวกับข้อโต้แย้งผลตอบแทนและวิธีการทำ
  2. พิจารณาเฉพาะการออกแบบและพื้นหลัง - เล็กน้อยที่จะช่วยในการเขียนโปรแกรมจริง
  3. สิ่งที่ขาดหายไปของโมดูลไพ ธ อน (เช่น create_menu_from_desktop)
  4. ข้อมูลที่มีประโยชน์มากมายถูกบีบอัด แต่ไม่สมบูรณ์

โดยพื้นฐานแล้วฉันต้องการบางสิ่งที่มีรายละเอียดเท่ากับ 3 แต่สำหรับโมดูลหลาม

ตัวอย่างปัญหาของฉัน:

เป็นโมฆะ build_menu_from_desktop (desktop_file, desktop_profile)

อะไรคือข้อโต้แย้งที่ควรจะเป็นและวิธีการทำอะไร? ฉันเดาว่าเป็นวิธีการสร้างรายการเมนูจากไฟล์ '* .desktop' แต่ถ้าเป็นเช่นนั้นเหตุใดจึงต้องมีอาร์กิวเมนต์มากกว่าไฟล์นั้น รายการใดในไฟล์ที่ใช้รายการเมนูจาก มันเป็นคำถามแบบนี้ฉันรู้สึกว่ายากที่จะหาคำตอบ


2
ลิงก์ 1 และ 3 ไม่ทำงาน
Matt Joiner

2
... อีกต่อไป ...
con-f-use

คำตอบ:


7

ใช่เรารู้ว่าเราต้องการเอกสาร Python พร้อมรายละเอียดในระดับที่เหมาะสม นั่นคือเป้าหมายของโครงการยีราฟ มันจะทำงานกับการผูก GObject Introspection ซึ่งเป็นวิธีที่แอพพลิเคชั่น Python ใหม่ควรถูกเขียนขึ้นเพื่อใช้ตัวบ่งชี้แอปพลิเคชัน

จนกว่าจะถึงตอนนั้นทางออกที่ดีที่สุดคือเอกสาร API ที่คุณได้จดบันทึกไว้ มันควรจะเป็นแบบเดียวกันกับ "python-ified"

build_menu_from_desktop คือการใช้ฟังก์ชั่นอำนวยความสะดวกโหลดรายการที่อาจจะอยู่ในสิ่งที่ต้องการด่วนในความสามัคคี ดังนั้นในการรับรายการเหล่านั้นคุณจะต้องใช้build_menu_from_desktop("/my/path/myfile.desktop", "Unity")เพื่อระบุ TargetEnvironment

สิ่งนี้ช่วยให้คุณมีรายการที่แตกต่างกันในไฟล์เดสก์ท็อปและมีการทับซ้อนและบางรายการไม่


นั่นเกี่ยวกับคำตอบมัน ขอบคุณที่สละเวลา ทำไมไม่ทำ docstrings หรือ doxygen ตั้งแต่แรกล่ะ?
con-f-use

1
เรากำลังใช้ gtk-doc โดยพื้นฐานแล้วสิ่งเดียวกัน แต่มันยังไม่ถ่ายโอนไปยังการผูก
Ted Gould

1
คุณสามารถรับเมนูและเปลี่ยนมันได้ แต่ฉันไม่แนะนำ หากพวกเขาต้องการที่แตกต่างกันฉันจะสร้างเมนูตามปกติ ... จริง ๆ แล้วฟังก์ชั่นนี้มีวัตถุประสงค์เพื่อเป็นผู้ช่วยเท่านั้นในกรณีที่คุณต้องการให้พวกเขาเหมือนกัน
Ted Gould

1
เพียงแค่ต้องการตรวจสอบว่ามีการอัปเดตใด ๆ เกี่ยวกับยีราฟและ qucklists ...
con-f-use

1
สถานะของสิ่งนี้คืออะไร ทำไมลิงก์ API เอกสาร AppIndicator API ของ Google ทั้งหมดจึงใช้งานไม่ได้ มีซิงเกิ้ลที่ยังมีชีวิตอยู่ไหม?
ulidtko
โดยการใช้ไซต์ของเรา หมายความว่าคุณได้อ่านและทำความเข้าใจนโยบายคุกกี้และนโยบายความเป็นส่วนตัวของเราแล้ว
Licensed under cc by-sa 3.0 with attribution required.