Gooey: เปลี่ยนโปรแกรมคอนโซล Python 3 เป็นแอปพลิเคชัน GUI

ลองใช้เครื่องมือของเราเพื่อกำจัดปัญหา

Gooey: เปลี่ยนโปรแกรมคอนโซล Python 3 เป็นแอปพลิเคชัน GUI

เหนอะหนะ

เปลี่ยน (เกือบ) โปรแกรมคอนโซล Python 3 ให้เป็นแอปพลิเคชัน GUI ด้วยบรรทัดเดียว



เริ่มต้นอย่างรวดเร็ว

คำแนะนำในการติดตั้ง

วิธีที่ง่ายที่สุดในการติดตั้ง Gooey คือผ่าน |_+_|

|_+_|

หรือคุณสามารถติดตั้ง Gooey ได้โดยการโคลนโปรเจ็กต์ไปยังไดเร็กทอรีในเครื่องของคุณ

|_+_|

วิ่ง |_+_|

|_+_|

การใช้งาน

Gooey แนบมากับโค้ดของคุณผ่านตัวตกแต่งอย่างง่าย ไม่ว่าวิธีใดจะมี |_+_| ของคุณ การประกาศ (โดยปกติคือ |_+_|)

|_+_|

สไตล์และการทำงานที่แตกต่างกันสามารถกำหนดค่าได้โดยการส่งอาร์กิวเมนต์ไปยังมัณฑนากร

|_+_|

ดู: มันทำงานอย่างไร ส่วนสำหรับรายละเอียดในแต่ละตัวเลือก

Gooey จะพยายามอย่างดีที่สุดเพื่อเลือกค่าเริ่มต้นของวิดเจ็ตที่เหมาะสมเพื่อแสดงใน GUI อย่างไรก็ตาม หากต้องการการปรับแต่งเพิ่มเติม คุณสามารถใช้ดรอปอินแทนที่ |_+_| แทนที่ |_+_| ซึ่งช่วยให้คุณควบคุมได้ว่าจะให้วิดเจ็ตใดแสดงใน GUI ดู: GooeyParser

|_+_|

ตัวอย่าง

Gooey ดาวน์โหลดและติดตั้ง? ยอดเยี่ยม! ต้องการเห็นมันในการดำเนินการ? ตรงไปที่ Examples Repository เพื่อดาวน์โหลดสคริปต์ตัวอย่างบางส่วนที่พร้อมใช้งาน พวกเขาจะพาคุณชมเลย์เอาต์ วิดเจ็ต และคุณสมบัติต่างๆ ของ Gooey อย่างรวดเร็ว

ดาวน์โหลดโดยตรง

มันคืออะไร?

Gooey แปลงแอปพลิเคชันคอนโซลของคุณให้เป็นแอปพลิเคชัน GUI ที่เป็นมิตรกับผู้ใช้ปลายทาง ช่วยให้คุณมุ่งเน้นไปที่การสร้างโปรแกรมที่แข็งแกร่งและกำหนดค่าได้ด้วยวิธีที่คุ้นเคย โดยไม่ต้องกังวลว่าผู้ใช้ทั่วไปจะนำเสนอและโต้ตอบกับมันอย่างไร

ทำไม

เพราะเท่าที่เรารักพรอมต์คำสั่ง ส่วนที่เหลือของโลกก็มองมันเหมือนโบราณวัตถุที่น่าเกลียดจากต้นยุค 80 ยิ่งไปกว่านั้น บ่อยครั้งที่โปรแกรมไม่จำเป็นต้องทำมากกว่าหนึ่งสิ่ง และนั่นหมายถึงการให้ตัวเลือก ซึ่งก่อนหน้านี้หมายถึงการสร้าง GUI หรือพยายามอธิบายวิธีจัดหาอาร์กิวเมนต์ให้กับ Console Application Gooey ถูกสร้างขึ้นเพื่อ (หวังว่าจะ) แก้ปัญหาเหล่านั้น ทำให้โปรแกรมใช้งานง่ายและดูสวยงาม!

สำหรับใคร?

หากคุณกำลังสร้างยูทิลิตี้สำหรับตัวคุณเอง โปรแกรมเมอร์คนอื่นๆ หรือบางอย่างที่สร้างผลลัพธ์ที่คุณต้องการจับภาพและไพพ์ไปยังแอปพลิเคชันคอนโซลอื่น (เช่น *nix Philosophy utils) Gooey อาจไม่ใช่เครื่องมือสำหรับคุณ อย่างไรก็ตาม หากคุณกำลังสร้างสคริปต์แบบ 'เรียกใช้และเสร็จสิ้น' แบบทั่วสำนักงาน สิ่งที่ขุดบิตจากจุด A ไปยังจุด B หรือสิ่งที่กำหนดเป้าหมายไปยังผู้ที่ไม่ใช่โปรแกรมเมอร์ Gooey เป็นเครื่องมือที่สมบูรณ์แบบสำหรับ งาน. มันช่วยให้คุณสร้างแอปพลิเคชั่นที่ซับซ้อนได้ตามที่ใจคุณต้องการในขณะที่รับด้าน GUI ฟรี

มันทำงานอย่างไร?

Gooey แนบมากับโค้ดของคุณผ่านตัวตกแต่งอย่างง่าย ไม่ว่าวิธีใดจะมี |_+_| ของคุณ ประกาศ

|_+_|

ในขณะรันไทม์ จะแยกวิเคราะห์สคริปต์ Python ของคุณสำหรับการอ้างอิงถึง |_+_| ทั้งหมด (ปัจจุบันยังไม่สนับสนุน |_+_| ที่เก่ากว่า) การอ้างอิงเหล่านี้จะถูกแยกออก แล้วกำหนด |_+_| ขึ้นอยู่กับ |_+_| พวกเขาจัดหาและในที่สุดก็ใช้ประกอบ GUI

การแมป:

Gooey พยายามอย่างเต็มที่ที่จะเลือกค่าเริ่มต้นที่เหมาะสมตามตัวเลือกที่พบ ปัจจุบัน |_+_| ถูกแมปกับ |_+_| ต่อไปนี้ ส่วนประกอบ

การดำเนินการของ Parserวิดเจ็ตตัวอย่าง
เก็บข้อความCtrl
store_constช่องทำเครื่องหมาย
store_trueช่องทำเครื่องหมาย
store_Falseช่องทำเครื่องหมาย
รุ่นช่องทำเครื่องหมาย
ผนวกข้อความCtrl
นับหล่นลง
กลุ่มพิเศษร่วมกันเรดิโอกรุ๊ป
ทางเลือกหล่นลง

GooeyParser

หากค่าเริ่มต้นข้างต้นไม่ได้ตัดออก คุณสามารถควบคุมประเภทวิดเจ็ตได้โดยใช้ดรอปอิน |_+_| แทนที่ |_+_|. สิ่งนี้ให้อาร์กิวเมนต์คำหลักเพิ่มเติม |_+_| ซึ่งคุณสามารถระบุชื่อส่วนประกอบที่คุณต้องการแสดงได้ ส่วนที่ดีที่สุด? คุณไม่จำเป็นต้องเปลี่ยน |_+_| ใดๆ ของคุณ รหัสที่จะใช้ วางลงในและคุณก็พร้อมที่จะไป

ตัวอย่าง:

|_+_|

จากที่กล่าวมาข้างต้น Gooey จะเลือก |_+_| แบบปกติ เป็นประเภทวิดเจ็ตดังนี้:

อย่างไรก็ตาม โดยใส่ |_+_| และจัดหา |_+_| ชื่อ คุณสามารถแสดงที่เป็นมิตรต่อผู้ใช้มากขึ้น |_+_|

|_+_|

วิดเจ็ตที่กำหนดเอง:

วิดเจ็ตตัวอย่าง
DirChooser, FileChooser, MultiFileChooser, FileSaver, MultiFileSaver

ตัวเลือกวันที่/ตัวเลือกเวลา

โปรดทราบว่าสำหรับวิดเจ็ตทั้งสองนี้ ค่าที่ส่งไปยังแอปพลิเคชันจะอยู่ในรูปแบบ ISO เสมอ ในขณะที่ค่าที่แปลเป็นภาษาท้องถิ่นอาจปรากฏในบางส่วนของ GUI ทั้งนี้ขึ้นอยู่กับการตั้งค่าของผู้ใช้ปลายทาง

ฟิลด์รหัสผ่าน

กล่องรายการ ภาพ
กล่องกาเครื่องหมายบล็อก ภาพ
กล่อง InlineCheck เริ่มต้นอาจดูไม่เหมาะหากมีบล็อกข้อความช่วยเหลือขนาดใหญ่ |_+_| ย้ายบล็อกข้อความไปยังตำแหน่งปกติและจัดเตรียม |_+_| แบบสั้น สำหรับแสดงถัดจากส่วนควบคุม ใช้ |_+_| เพื่อควบคุมข้อความฉลาก
ตัวเลือกสี

รายการแบบเลื่อนลงที่กรองได้

ฟิลด์จำนวนเต็ม

ฟิลด์ทศนิยม

สไลเดอร์

ความเป็นสากล

Gooey พร้อมใช้งานในระดับสากลและย้ายไปยังภาษาโฮสต์ของคุณได้อย่างง่ายดาย ภาษาถูกควบคุมผ่านอาร์กิวเมนต์ของ |_+_| มัณฑนากร.

|_+_|

ข้อความโปรแกรมทั้งหมดถูกเก็บไว้ภายนอกใน |_+_| ไฟล์. ดังนั้น การเพิ่มการรองรับภาษาใหม่จึงง่ายพอๆ กับการวางคู่คีย์/ค่าใน |_+_| ไดเรกทอรี

วิธีใส่สอง divs ติดกัน

ต้องขอบคุณผู้มีส่วนร่วมที่ยอดเยี่ยม ปัจจุบัน Gooey มีการแปลภาษาที่แตกต่างกันกว่า 18 รายการในสต็อกล่วงหน้า!

ต้องการเพิ่มอีกหรือไม่ ส่งคำขอดึง!


การกำหนดค่าส่วนกลาง

เกือบทุกอย่างในรูปลักษณ์โดยรวมของ Gooey สามารถปรับแต่งได้โดยการส่งข้อโต้แย้งไปยังมัณฑนากร

พารามิเตอร์สรุป
การเข้ารหัสการเข้ารหัสข้อความเพื่อใช้เมื่อแสดงอักขระ (ค่าเริ่มต้น: 'utf-8')
use_legacy_titlesเขียนชื่อกลุ่ม argparse เริ่มต้นใหม่จาก 'Positional' เป็น 'Required' สิ่งนี้มีไว้เพื่อรักษาความเข้ากันได้แบบย้อนหลังกับ Gooey เวอร์ชันก่อนหน้าเป็นหลัก (ซึ่งมีการสนับสนุน/การรับรู้กลุ่มที่ไม่ดีและมีการโต้แย้งแบบไร้เดียงสาของตนเอง)
ขั้นสูงสลับว่าจะแสดงหน้าจอการกำหนดค่า 'แบบเต็ม' หรือแบบง่าย
auto_startข้ามการกำหนดค่าทั้งหมดและเรียกใช้โปรแกรมทันที
ภาษาบอกให้ Gooey ตั้งค่าภาษาที่จะโหลดจาก |_+_| ไดเรกทอรี
เป้าบอก Gooey ถึงวิธีการเรียกใช้ตัวเองอีกครั้ง ตามค่าเริ่มต้น Gooey จะพบ python แต่สิ่งนี้ทำให้คุณสามารถระบุโปรแกรมได้ (และอาร์กิวเมนต์หากให้มา)
suppress_gooey_flagควรตั้งค่าเมื่อใช้แบบกำหนดเอง |_+_| ป้องกัน Gooey จากการฉีด CLI params เพิ่มเติม
โปรแกรม_ชื่อชื่อที่แสดงในแถบชื่อเรื่องของหน้าต่าง GUI หากไม่ได้ระบุไว้ ชื่อเรื่องจะมีค่าเริ่มต้นเป็นชื่อสคริปต์ที่ดึงมาจาก |_+_|
โปรแกรม_descriptionกำหนดข้อความที่แสดงในแผงด้านบนของ |_+_| หน้าจอ. ค่าเริ่มต้นคือคำอธิบายที่ดึงมาจาก |_+_|
ขนาดเริ่มต้นขนาดเริ่มต้นของหน้าต่าง
เต็มจอเริ่ม Gooey ในโหมดเต็มหน้าจอ
need_colsควบคุมจำนวนคอลัมน์ในส่วนอาร์กิวเมนต์ที่จำเป็น
:คำเตือน: ประกาศเลิกใช้: ดูการปรับแต่งเค้าโครงสำหรับการควบคุมเค้าโครงสมัยใหม่
ตัวเลือก_colsควบคุมจำนวนคอลัมน์ในส่วนอาร์กิวเมนต์ทางเลือก
:คำเตือน: ประกาศเลิกใช้: ดูการปรับแต่งเค้าโครงสำหรับการควบคุมเค้าโครงสมัยใหม่
dump_build_configบันทึก |_+_| คัดลอกการกำหนดค่าบิลด์บนดิสก์เพื่อใช้ซ้ำ/แก้ไข
load_build_configโหลด |_+_| คัดลอกการกำหนดค่าบิลด์จากดิสก์
monospace_displayใช้แบบอักษรเว้นวรรคแบบโมโนในหน้าจอเอาต์พุต
:คำเตือน: ประกาศเลิกใช้: ดูการปรับแต่งเค้าโครงสำหรับการกำหนดค่าแบบอักษรสมัยใหม่
รูปภาพ_dirเส้นทางไปยังไดเร็กทอรีที่ Gooey ควรค้นหารูปภาพ/ไอคอนที่กำหนดเอง
ภาษา_dirเส้นทางไปยังไดเร็กทอรีที่ Gooey ควรค้นหาไฟล์ภาษาที่กำหนดเอง
ปิดการใช้งาน_stop_buttonปิดการใช้งาน |_+_| ปุ่มเมื่อทำงาน
show_stop_warningแสดงคำเตือนก่อนที่จะอนุญาตให้ผู้ใช้บังคับยุติโปรแกรมของคุณ
force_stop_is_errorสลับว่าการยกเลิกก่อนกำหนดโดยแสดงหน้าจอสำเร็จหรือข้อผิดพลาด
show_success_modalสลับว่าจะแสดงโมดอลสรุปหรือไม่หลังจากรันสำเร็จ
show_failure_modalสลับว่าจะแสดงโมดูลสรุปเมื่อเกิดความล้มเหลวหรือไม่
show_restart_buttonสลับว่าจะแสดงปุ่มรีสตาร์ทเมื่อสิ้นสุดการดำเนินการหรือไม่
run_validatorsควบคุมว่าจะให้ Gooey ทำการตรวจสอบก่อนเรียกโปรแกรมของคุณหรือไม่
poll_external_updates(ทดลอง!) เมื่อเป็นจริง Gooey จะเรียกรหัสของคุณด้วย |_+_| อาร์กิวเมนต์ CLI และใช้การตอบกลับเพื่อเติมค่าไดนามิกใน UI (ดู: การใช้ค่าไดนามิก )
use_cmd_argsแทนที่อาร์กิวเมนต์บรรทัดคำสั่งใดๆ ที่ระบุในขณะรันไทม์สำหรับค่าดีฟอลต์ที่ระบุในการกำหนดค่า Gooey
return_to_configเมื่อ True Gooey จะกลับไปที่หน้าต่างการตั้งค่าเมื่อรันสำเร็จ
progress_regexregex ข้อความที่ใช้ในการจัดรูปแบบการจับคู่ข้อมูลความคืบหน้าของรันไทม์ ดู: กำลังแสดงความคืบหน้า สำหรับวิธีการโดยละเอียด
ความคืบหน้า_exprนิพจน์หลามที่ใช้กับการจับคู่ใด ๆ ที่พบผ่าน |_+_| ดู: กำลังแสดงความคืบหน้า สำหรับวิธีการโดยละเอียด
Hide_progress_msgตัวเลือกเพื่อซ่อนการอัปเดตความคืบหน้าที่เป็นข้อความซึ่งตรงกับ |_+_| ดู: กำลังแสดงความคืบหน้า สำหรับวิธีการโดยละเอียด
ปิดการใช้งาน_progress_bar_animationปิดใช้งานแถบความคืบหน้า
เวลา_ตัวเลือกซึ่งมีตัวเลือกสำหรับแสดงเวลาที่เหลือและเวลาที่ผ่านไป ซึ่งจะใช้กับ |_+_| และ |_+_| เวลาที่ผ่านไป / เวลาที่เหลือ . บรรจุเป็นพจนานุกรมพร้อมตัวเลือก |_+_| และ |_+_| เช่น |_+_|
แสดง_เวลา_ที่เหลืออยู่ปิดใช้งานข้อความเวลาที่เหลือดู เวลาที่ผ่านไป / เวลาที่เหลือ
Hide_time_remaining_on_completeซ่อนเวลาที่เหลือในการมองเห็นแบบเต็มหน้าจอ เวลาที่ผ่านไป / เวลาที่เหลือ
ต้องใช้_shellควบคุมว่า |_+_| หรือไม่ ใช้อาร์กิวเมนต์เมื่อเรียกใช้โปรแกรมของคุณ ข้อมูลเพิ่มเติมที่นี่
ปิดเครื่อง_สัญญาณระบุ |_+_| เพื่อส่งไปยังโปรเซสลูกเมื่อ |_+_| กดปุ่ม ดูการหยุดอย่างสง่างามในเอกสารสำหรับข้อมูลเพิ่มเติม
การนำทาง

ตั้งค่าสไตล์ 'การนำทาง' ของหน้าต่างระดับบนสุดของ Gooey
ตัวเลือก:

แท็บแถบด้านข้าง
sidebar_title ควบคุมหัวเรื่องเหนือบานหน้าต่างนำทางของแถบด้านข้าง ค่าเริ่มต้นเป็น: 'การกระทำ'
show_sidebarแสดง/ซ่อนแถบด้านข้างในโหมดนำทาง == |_++|
body_bg_colorค่า HEX ของหน้าต่าง Gooey หลัก
header_bg_colorค่า HEX ของพื้นหลังส่วนหัว
header_heightความสูงเป็นพิกเซลของส่วนหัว
header_show_titleแสดง/ซ่อนหัวเรื่อง
header_show_subtitleแสดง/ซ่อนคำบรรยายส่วนหัว
ส่วนท้าย_bg_สีค่า HEX ของพื้นหลังส่วนท้าย
แถบด้านข้าง_bg_สีค่า HEX ของพื้นหลังของแถบด้านข้าง
terminal_panel_colorค่า HEX ของแผงขั้วต่อ
terminal_font_colorค่า HEX ของแบบอักษรที่แสดงในเทอร์มินัลของ Gooey
terminal_font_familyชื่อของตระกูลแบบอักษรที่จะใช้ในเทอร์มินัล
terminal_font_weightน้ำหนักของแบบอักษร (|_+_|, |_+_|)
เทอร์มินัล_font_sizeขนาดพอยต์ของแบบอักษรที่แสดงในเทอร์มินัล
error_colorค่า HEX ของข้อความที่แสดงเมื่อเกิดข้อผิดพลาดในการตรวจสอบ
Richtext_controlsเปิด/ปิดการรองรับคอนโซลสำหรับลำดับการควบคุมเทอร์มินัล (การรองรับแบบจำกัดสำหรับน้ำหนักและสีของฟอนต์) ค่าเริ่มต้นเป็น : เท็จ ดูเอกสารสำหรับรายละเอียดเพิ่มเติม
เมนูแสดงกลุ่มเมนูและรายการที่กำหนดเอง (ดู: เมนู
clear_before_runเมื่อเป็นจริง เอาต์พุตก่อนหน้านี้จะถูกล้างออกจากเทอร์มินัลเมื่อเรียกใช้โปรแกรมอีกครั้ง

การปรับแต่งเค้าโครง

คุณสามารถสร้างเลย์เอาต์ที่ค่อนข้างยืดหยุ่นได้ด้วย Gooey โดยใช้การปรับแต่งง่ายๆ ไม่กี่อย่าง

ที่ระดับสูงสุด คุณจะมีตัวเลือกเลย์เอาต์โดยรวมหลายตัวที่ควบคุมได้ผ่านอาร์กิวเมนต์ต่างๆ ไปยัง Gooey decorator

|_+_||_+_||_+_||_+_|

การจัดกลุ่มอินพุต

ตามค่าเริ่มต้น หากคุณใช้ Argparse กับ Gooey ข้อมูลที่คุณป้อนจะถูกแบ่งออกเป็นสองกลุ่ม: |_+_| และ |_+_| อย่างไรก็ตาม กลุ่มเหล่านี้อาจไม่ใช่กลุ่มที่สื่อความหมายได้ดีที่สุดเสมอไปสำหรับผู้ใช้ของคุณ คุณสามารถฝากข้อมูลเข้าในกลุ่มลอจิกโดยพลการและปรับแต่งเค้าโครงของแต่ละรายการ

ด้วย |_+_| สิ่งนี้ทำได้ผ่าน |_+_|

|_+_|

คุณสามารถเพิ่มอาร์กิวเมนต์ลงในกลุ่มได้ตามปกติ

ทวิตเตอร์ทำให้ไลค์เป็นส่วนตัว
|_+_|

ซึ่งจะแสดงเป็นส่วนหนึ่งของกลุ่มภายใน UI

เรียกใช้โหมด

Gooey มีโหมดการนำเสนอจำนวนหนึ่ง คุณจึงสามารถปรับแต่งเลย์เอาต์ให้เหมาะกับประเภทเนื้อหาและระดับหรือประสบการณ์ของผู้ใช้

ขั้นสูง

มุมมองเริ่มต้นคือหน้าจอการกำหนดค่า 'เต็ม' หรือ 'ขั้นสูง' มีเค้าโครงที่แตกต่างกันสองแบบขึ้นอยู่กับประเภทของอินเทอร์เฟซบรรทัดคำสั่งที่กำลังรวมอยู่ สำหรับแอ็พพลิเคชันส่วนใหญ่ เลย์เอาต์แบบแฟลตจะเป็นแบบที่ใช้ได้ เนื่องจากเลย์เอาต์นั้นเข้ากันได้ดีที่สุดกับสคีมา CLI ที่คุ้นเคยของคำสั่งหลัก ตามด้วยตัวเลือกมากมาย (เช่น Curl, FFMPEG)

อีกด้านหนึ่งคือเค้าโครงคอลัมน์ อันนี้เหมาะที่สุดสำหรับ CLIs ที่มีหลายพาธหรือประกอบด้วยเครื่องมือเล็กๆ หลายตัว ซึ่งแต่ละอันก็มีอาร์กิวเมนต์และตัวเลือกของตัวเอง (คิดว่า: git) โดยจะแสดงเส้นทางหลักตามคอลัมน์ด้านซ้าย และอาร์กิวเมนต์ที่เกี่ยวข้องทางด้านขวา นี่เป็นวิธีที่ยอดเยี่ยมในการรวมฟังก์ชันต่างๆ มากมายไว้ในแอปเดียว

ทั้งสองมุมมองนำเสนอแต่ละการกระทำใน |_+_| เป็นส่วนประกอบ GUI ที่ไม่ซ้ำใคร ทำให้เหมาะสำหรับการนำเสนอโปรแกรมแก่ผู้ใช้ที่ไม่คุ้นเคยกับตัวเลือกบรรทัดคำสั่งและ/หรือโปรแกรมคอนโซลโดยทั่วไป ข้อความช่วยเหลือจะแสดงด้านข้างแต่ละส่วนประกอบเพื่อให้ชัดเจนที่สุดเท่าที่จะเป็นไปได้ว่าแต่ละวิดเจ็ตทำอะไรได้บ้าง

การตั้งค่ารูปแบบเค้าโครง:

ในขณะนี้ เค้าโครงไม่สามารถระบุได้อย่างชัดเจนผ่านพารามิเตอร์ (บน TODO!) เค้าโครงถูกสร้างขึ้นโดยขึ้นอยู่กับว่ามี |_+_| หรือไม่ ใช้ในฐานรหัสของคุณ ดังนั้น หากคุณต้องการทริกเกอร์ |_+_| คุณจะต้องเพิ่ม |_+_| ถึง |_+_| ของคุณ รหัส.

สามารถสลับได้ผ่าน |_+_| พารามิเตอร์ใน |_+_| มัณฑนากร.

|_+_|

ขั้นพื้นฐาน

มุมมองพื้นฐานเหมาะที่สุดสำหรับเวลาที่ผู้ใช้คุ้นเคยกับ Console Applications แต่คุณยังคงต้องการนำเสนอสิ่งที่ขัดเกลามากกว่าเทอร์มินัลธรรมดาเล็กน้อย เข้าถึงการแสดงผลพื้นฐานได้โดยการตั้งค่า |_+_| พารามิเตอร์ใน |_+_| มัณฑนากรถึง |_+_|.

|_+_|


ไม่มีการกำหนดค่า

No Config ค่อนข้างทำในสิ่งที่คุณคาดหวัง: มันไม่แสดงหน้าจอการกำหนดค่า มันกระโดดไปทางขวา |_+_| ส่วนและเริ่มการดำเนินการของโปรแกรมโฮสต์ นี่เป็นการปรับปรุงลักษณะที่ปรากฏของสคริปต์แบบใช้ครั้งเดียวเพียงเล็กน้อย

หากต้องการใช้โหมดนี้ ให้ตั้งค่า |_+_| ในมัณฑนากร Gooey

|_+_|


เมนู

ภาพ

เพิ่ม 1.0.2

คุณสามารถเพิ่มแถบเมนูที่ด้านบนของ Gooey ด้วยกลุ่มเมนูและรายการที่กำหนดเอง

มีการระบุเมนูไว้ที่หลัก |_+_| มัณฑนากรเป็นรายการแผนที่

|_+_|

แต่ละแผนที่ประกอบด้วยคู่คีย์/ค่าสองคู่

  1. |_+_| - ชื่อกลุ่มเมนูนี้
  2. |_+_| - รายการเมนูแต่ละรายการในกลุ่มนี้

คุณสามารถมีกลุ่มเมนูได้มากเท่าที่คุณต้องการ พวกเขาจะถูกส่งผ่านเป็นรายการไปยัง |_+_| อาร์กิวเมนต์ใน |_+_| มัณฑนากร.

|_+_|

รายการเมนูแต่ละรายการในกลุ่มยังเป็นเพียงแผนที่ของคู่คีย์/ค่า ชุดคีย์ที่แน่นอนจะแตกต่างกันไปตาม |_+_| แต่จะมีคีย์สองคีย์เสมอ:

  • |_+_| - สิ่งนี้ควบคุมลักษณะการทำงานที่จะแนบกับรายการเมนูรวมถึงปุ่มที่จำเป็นตามที่ระบุ
  • |_+_| - ชื่อของ MenuItem นี้

ขณะนี้รองรับตัวเลือกเมนูสามประเภท:

  • เกี่ยวกับไดอะล็อก
  • กล่องโต้ตอบข้อความ
  • ลิงค์
  • HtmlDialog

เกี่ยวกับไดอะล็อก เป็นโปรแกรมสำเร็จรูปเกี่ยวกับ Dialog ของคุณ จะแสดงข้อมูลโปรแกรม เช่น ชื่อ รุ่น และข้อมูลสิทธิ์ใช้งานใน AboutBox แบบมาตรฐาน

สคีมา

  • |_+_| - ( ไม่จำเป็น )
  • |_+_| - ( ไม่จำเป็น )
  • |_+_| - ( ไม่จำเป็น )
  • |_+_| - ( ไม่จำเป็น )
  • |_+_| - ( ไม่จำเป็น )
  • |_+_| - ( ไม่จำเป็น )
  • |_+_| - ( ไม่จำเป็น )

ตัวอย่าง:

|_+_|

กล่องโต้ตอบข้อความ เป็นกล่องโต้ตอบข้อมูลทั่วไป คุณสามารถแสดงอะไรก็ได้ตั้งแต่การแจ้งเตือนขนาดเล็ก ไปจนถึงข้อความแสดงข้อมูลแบบยาวแก่ผู้ใช้

สคีมา:

  • |_+_| - ( ที่จำเป็น ) ข้อความที่จะแสดงในเนื้อหาของโมดอล
  • |_+_| - ( ไม่จำเป็น ) คำอธิบายภาพในแถบชื่อเรื่องของโมดอล

ตัวอย่าง:

|_+_|

ลิงค์ มีไว้สำหรับส่งผู้ใช้ไปยังเว็บไซต์ภายนอก สิ่งนี้จะสร้างเบราว์เซอร์เริ่มต้นที่ URL ที่คุณระบุ

สคีมา:

  • |_+_| - ( ที่จำเป็น ) - URL แบบเต็มที่จะเข้าชม

ตัวอย่าง:

|_+_|

HtmlDialog ให้คุณควบคุมสิ่งที่แสดงในกล่องโต้ตอบข้อความได้อย่างเต็มที่ (โบนัส: ผู้ใช้สามารถคัดลอก/วางข้อความจากข้อความนี้ได้!)

สคีมา:

  • |_+_| - ( ไม่จำเป็น ) คำอธิบายภาพในแถบชื่อเรื่องของโมดอล
  • |_+_| - ( ที่จำเป็น ) html ที่คุณต้องการให้แสดงในกล่องโต้ตอบ หมายเหตุ: รองรับ HTML ส่วนย่อยเพียงเล็กน้อยเท่านั้น ดูเอกสาร WX สำหรับข้อมูลเพิ่มเติม

ตัวอย่าง:

|_+_|

ตัวอย่างแบบเต็ม:

กลุ่มเมนูสองกลุ่ม ('ไฟล์' และ 'วิธีใช้') โดยมีรายการเมนูสี่รายการคั่นกลาง

|_+_|

การตรวจสอบแบบไดนามิก

:warning: หมายเหตุ! ฟังก์ชันนี้อยู่ระหว่างการทดลองและมีแนวโน้มว่าจะไม่เสถียร API อาจมีการเปลี่ยนแปลงหรือลบออกทั้งหมด ข้อเสนอแนะ / ความคิดเกี่ยวกับคุณสมบัตินี้ยินดีต้อนรับและสนับสนุน!

:warning: ดู บันทึกประจำรุ่น สำหรับคำแนะนำในการอัปเกรดจาก 1.0.8 เป็น 1.2.0

ก่อนที่จะส่งผ่านอินพุตของผู้ใช้ไปยังโปรแกรมของคุณ Gooey สามารถเรียกใช้การตรวจสอบก่อนการบินแบบพิเศษเพื่อตรวจสอบว่าอาร์กิวเมนต์ทั้งหมดผ่านการตรวจสอบความถูกต้องที่คุณระบุ

มันทำงานอย่างไร?

ลูกหมูเหนอะหนะอยู่บนหลัง |_+_| พารามิเตอร์ใช้ได้กับประเภท Argparse Argument ส่วนใหญ่

|_+_|

นอกเหนือจากบิวด์อินง่ายๆ เช่น |_+_| และ |_+_| คุณสามารถระบุฟังก์ชันของคุณเองให้กับ |_+_| พารามิเตอร์เพื่อตรวจสอบค่าที่เข้ามา

|_+_|

วิธีเปิดใช้งานการตรวจสอบก่อนการบิน

ตามค่าเริ่มต้น Gooey จะไม่เรียกใช้การตรวจสอบ ทำไม ฟีเจอร์นี้ค่อนข้างเป็นการทดลองและทำ Monkey Patching ที่หนักหน่วงอยู่เบื้องหลัง ด้วยเหตุนี้จึงอยู่ในระหว่างการเลือกรับ

คุณเปิดใช้การตรวจสอบโดยบอก Gooey ว่าคุณต้องการสมัครรับข้อมูลจาก |_+_| เหตุการณ์.

|_+_|

ตอนนี้ เมื่อคุณเรียกใช้ Gooey ก่อนที่มันจะเรียกใช้โปรแกรมหลักของคุณ มันจะส่งการตรวจสอบความถูกต้องล่วงหน้าแยกต่างหากและบันทึกปัญหาใดๆ ที่เกิดขึ้นจาก |_+_| ของคุณ ฟังก์ชั่น.

ตัวอย่างโค้ดแบบเต็ม

|_+_|

เหตุการณ์วงจรชีวิตและการควบคุม UI

:warning: หมายเหตุ! ฟังก์ชันนี้เป็นการทดลอง API อาจมีการเปลี่ยนแปลงหรือลบออกทั้งหมด ข้อเสนอแนะเกี่ยวกับคุณสมบัตินี้ยินดีต้อนรับและสนับสนุน!

ตั้งแต่ 1.2.0 เป็นต้นไป Gooey เปิดเผย hooks วงจรชีวิตของเมล็ดหยาบในโปรแกรมของคุณ ซึ่งหมายความว่าตอนนี้คุณสามารถดำเนินการติดตามผลเพิ่มเติมเพื่อตอบสนองต่อการทำงานที่สำเร็จหรือล้มเหลว และแม้แต่ควบคุมสถานะปัจจุบันของ UI เอง!

ขณะนี้มีการเปิดเผยตะขอหลักสองรายการ:

  • |_+_|
  • |_+_|

สิ่งเหล่านี้จะเกิดขึ้นในเวลาที่คุณคาดหวัง: หลังจากกระบวนการของคุณเสร็จสิ้น

กายวิภาคของตัวจัดการวงจรชีวิต :

ทั้ง |_+_| และ |_+_| มีลายเซ็นประเภทเดียวกัน

|_+_|
    หาเรื่องนี่คือวัตถุ Argparse ที่แยกวิเคราะห์ (เช่น เอาต์พุตของ |_+_|) นี่จะเป็นการแมปอาร์กิวเมนต์ของผู้ใช้ตามที่มีอยู่เมื่อโปรแกรมของคุณถูกเรียกใช้สถานะนี่คือสถานะปัจจุบันของ UI ของ Gooey หากโปรแกรมของคุณใช้ตัวแยกวิเคราะห์ย่อย ขณะนี้จะแสดงสถานะของตัวแยกวิเคราะห์/ฟอร์มที่ใช้งานอยู่เท่านั้น ไม่ว่าเวอร์ชันที่อัปเดตของสถานะนี้ที่คุณส่งคืนจะสะท้อนให้เห็นใน UI!

การแนบตัวจัดการ:

ตัวจัดการถูกแนบเมื่อสร้างอินสแตนซ์ของ |_+_|

|_+_|

สมัครรับข้อมูลเหตุการณ์รอบชีวิต

เหมือนกับ การตรวจสอบ เหตุการณ์วงจรชีวิตเหล่านี้สามารถเลือกได้ ผ่านกิจกรรมที่คุณต้องการสมัครไปที่ |_+_| อาร์กิวเมนต์มัณฑนากรเหนอะหนะ

|_+_|

กำลังแสดงความคืบหน้า

การให้คำติชมความคืบหน้าทางสายตาด้วย Gooey นั้นง่ายมาก! หากคุณแสดงการอัปเดตความคืบหน้าที่เป็นข้อความอยู่แล้ว คุณสามารถบอก Gooey ให้เชื่อมต่อเข้ากับเอาต์พุตที่มีอยู่เพื่อเพิ่มพลังให้กับแถบความคืบหน้า

สำหรับกรณีทั่วไป สตริงเอาต์พุตที่แปลงเป็นตัวเลขที่แสดงเปอร์เซ็นต์ความสำเร็จ (เช่น |_+_|) สามารถจับคู่รูปแบบและเปลี่ยนเป็นสถานะแถบความคืบหน้าด้วยนิพจน์ทั่วไปอย่างง่าย (เช่น |_+_|)

สำหรับผลลัพธ์ที่ซับซ้อนมากขึ้น คุณสามารถส่งนิพจน์การประเมินแบบกำหนดเอง (|_+_|) เพื่อแปลงการจับคู่นิพจน์ทั่วไปได้ตามต้องการ

สตริงเอาต์พุตที่ตอบสนองนิพจน์ทั่วไปสามารถซ่อนจากคอนโซลผ่าน |_+_| พารามิเตอร์ (เช่น |_+_|.

Regex และนิพจน์การประมวลผล

eclipse ide สำหรับ mac
|_+_|

ผลลัพธ์ของโปรแกรม:

|_+_|

มีตัวเลือกมากมายสำหรับการบอก Gooey เกี่ยวกับความคืบหน้าในขณะที่โปรแกรมของคุณกำลังทำงาน ตรวจสอบพื้นที่เก็บข้อมูลตัวอย่าง Gooey เพื่อดูรายละเอียดการใช้งานและตัวอย่าง!

เวลาที่ผ่านไป / เวลาที่เหลือ

Gooey ยังรองรับการติดตามเวลาที่ผ่านไป / เวลาที่เหลือเมื่อใช้ความคืบหน้า! สิ่งนี้ทำในลักษณะที่คล้ายกับของโครงการ tqdm สามารถเปิดใช้งานได้ด้วย |_+_|, |_+_| อาร์กิวเมนต์ใช้ในพจนานุกรมด้วยคีย์ |_+_| และ |_+_| ลักษณะการทำงานเริ่มต้นคือ True สำหรับ |_+_| และเป็นเท็จสำหรับ |_+_| การดำเนินการนี้จะใช้ได้เฉพาะเมื่อ |_+_| และ |_+_| ถูกนำมาใช้

|_+_|

การปรับแต่งไอคอน

Gooey มาพร้อมกับชุดไอคอนเริ่มต้นหกชุด สิ่งเหล่านี้สามารถลบล้างได้ด้วยรูปภาพ/ไอคอนที่คุณกำหนดเองโดยบอกให้ Gooey ค้นหาไดเร็กทอรีเพิ่มเติมเมื่อเริ่มต้น ซึ่งทำได้ผ่าน |_+_| อาร์กิวเมนต์ |_+_| มัณฑนากร.

|_+_|

รูปภาพถูกค้นพบโดย Gooey โดยอ้างอิงจากรูปภาพเหล่านั้น ชื่อไฟล์ . ตัวอย่างเช่น ในการจัดหาไอคอนการกำหนดค่าแบบกำหนดเอง ให้วางรูปภาพด้วยชื่อไฟล์ |_+_| ในไดเรกทอรีรูปภาพของคุณ นี่คือชื่อไฟล์ที่สามารถแทนที่ได้:

  • โปรแกรม_icon.png
  • Success_icon.png
  • running_icon.png
  • กำลังโหลด_icon.gif
  • config_icon.png
  • error_icon.png

บรรจุภัณฑ์

ขอบคุณผู้ร่วมให้ข้อมูลที่ยอดเยี่ยม การบรรจุ Gooey เป็นไฟล์เรียกทำงานนั้นง่ายมาก

เวอร์ชัน tl;dr pyinstaller คือการวาง build.spec นี้ลงในไดเรกทอรีรากของแอปพลิเคชันของคุณ แก้ไขเนื้อหาเพื่อให้ |_+_| และ |_+_| มีความเกี่ยวข้องกับโครงการของคุณและ |_+_| ค่าชี้ไปที่รูทแอปพลิเคชันของคุณ จากนั้นดำเนินการ |_+_| เพื่อรวมแอพของคุณไว้ในไฟล์ปฏิบัติการที่พร้อมใช้งาน

สามารถดูคำแนะนำทีละขั้นตอนโดยละเอียดได้ที่นี่

ภาพหน้าจอ

เค้าโครงแบบแบนเค้าโครงคอลัมน์หน้าจอความสำเร็จหน้าจอข้อผิดพลาดไดอะล็อกคำเตือน
กลุ่มที่กำหนดเองกลุ่มแท็บการนำทางแบบแท็บการนำทางแถบด้านข้างการตรวจสอบการป้อนข้อมูล

ต้องการความช่วยเหลือ?

รหัส การแปล เอกสาร หรือกราฟิก? ยินดีต้อนรับคำขอดึงทั้งหมด เพียงตรวจสอบให้แน่ใจว่าได้ตรวจสอบหลักเกณฑ์การมีส่วนร่วมก่อน

ผู้เขียน: chriskiehl
รหัสแหล่งที่มา: https://github.com/chriskiehl/Gooey
ใบอนุญาต: ใบอนุญาต MIT

#งูหลาม #กุย

ดูสิ่งนี้ด้วย: