รูปแบบไฟล์ whl - การแจกแจงแพ็คเกจ Python

ข้อมูลเก็บถาวรของ Python Wheel

WHL เป็นรูปแบบบรรจุภัณฑ์ที่สร้างขึ้นสำหรับ Python ที่มีไฟล์ทั้งหมดที่จำเป็นสำหรับการติดตั้งในสถานะที่รวบรวมไว้ล่วงหน้า ในสาระสำคัญไฟล์ WHL คือ zip archive ที่มีโครงสร้างไดเรกทอรีพิเศษและการประชุมการตั้งชื่อที่อนุญาตให้ผู้จัดการแพ็คเกจของ Python ติดตั้งซอฟต์แวร์โดยไม่ต้องใช้กระบวนการสร้างเพื่อทำงานบนระบบของผู้ใช้ปลายทาง เนื่องจากความเร็วในการติดตั้งที่ดีขึ้นและความน่าเชื่อถือรูปแบบนี้ได้แทนที่รูปแบบที่เก่ากว่าและการกระจายแหล่งที่มา (.tar.gz) สำหรับผลิตภัณฑ์ Python จำนวนมาก

วิวัฒนาการของไฟล์ WHL

ในปี 2012 PEP 427 ประกาศรูปแบบ WHL ซึ่งเรียกว่า “Wheel” อย่างเป็นทางการเพื่อเพิ่มประสิทธิภาพในรูปแบบไข่ก่อนหน้า Daniel Holth สร้างมันขึ้นมาเพื่อแก้ไขปัญหาต่าง ๆ ด้วยระบบนิเวศบรรจุภัณฑ์ Python เมื่อ PIP ตัวติดตั้งแพ็คเกจของ Python รวมถึงความสามารถในการติดตั้งล้อในเวอร์ชัน 1.4 ซึ่งมีให้ในต้นปี 2556 รูปแบบจะมีการใช้งานที่สำคัญ ภายในปี 2014 แพ็คเกจ Python Major เริ่มแจกจ่ายไฟล์ล้อและวันนี้ได้กลายเป็นมาตรฐาน de พฤตินัยสำหรับการกระจายแพ็คเกจ Python ด้วยความก้าวหน้าในระบบนิเวศบรรจุภัณฑ์ Python รูปแบบจะช่วยพัฒนา มาตรฐานล่าสุดมีการระบุไว้ใน PEP 600 และ PEP 621

โครงสร้างของไฟล์ WHL

ไฟล์ WHL เป็นคลังเก็บซิปที่มีโครงสร้างภายในเฉพาะที่เป็นไปตามข้อกำหนดของบรรจุภัณฑ์ Python ภายในไฟล์ WHL คุณจะพบโมดูล Python ที่คอมไพล์ (ไฟล์. pyc), ข้อมูลเมตาเกี่ยวกับแพ็คเกจและส่วนขยายไบนารีใด ๆ ที่จำเป็นสำหรับแพ็คเกจที่จะใช้งาน ชื่อไฟล์นั้นเป็นไปตามการประชุมที่เข้มงวดซึ่งเข้ารหัสข้อมูลที่สำคัญ: ชื่อแพ็คเกจ, เวอร์ชัน, แท็กความเข้ากันได้ของ Python และสถาปัตยกรรมเป้าหมาย วิธีการที่มีโครงสร้างนี้ช่วยให้ผู้จัดการแพ็คเกจของ Python สามารถตรวจสอบได้อย่างรวดเร็วว่าล้อเข้ากันได้กับระบบเป้าหมายโดยไม่จำเป็นต้องแยกเนื้อหาหรือไม่

วิธีการบีบอัด WHL

ไฟล์ WHL ใช้วิธีการบีบอัดเช่นเดียวกับไฟล์ ZIP ปกติเพราะเป็นไฟล์เก็บถาวร ZIP โดยพื้นฐาน อัลกอริทึม deflate ซึ่งสมดุลอัตราส่วนการบีบอัดและความเร็วในการบีบอัดมักใช้บ่อยที่สุดในการบีบอัดเนื้อหาของไฟล์ WHL วิธีนี้รับประกันได้ว่าแพ็คเกจอาจติดตั้งอย่างรวดเร็วในขณะที่รักษาขนาดไฟล์ที่เหมาะสมกับการกระจาย ไฟล์เหล่านี้เข้ากันได้กับไลบรารีเช่น aspose.zip ซึ่งอำนวยความสะดวกในการสกัดและการสร้างแพ็คเกจ WHL โดยใช้เทคนิคการบีบอัดที่หลากหลายเช่น deflate, deflate64tm, BZIP2 และอื่น ๆ

การดำเนินงานที่รองรับ WHL Archive

การใช้เครื่องมือเช่น ASPOSE.ZIP สำหรับ Python .NET นักพัฒนาสามารถจัดการไฟล์ WHL ได้หลายวิธี สามารถสร้างแพ็คเกจล้อได้เนื้อหาสามารถตรวจสอบไฟล์สามารถแยกไฟล์จาก WHL ได้โดยไม่ต้องติดตั้งเมทาดาทาสามารถเปลี่ยนแปลงได้และล้อดัดแปลงสามารถบรรจุใหม่ได้ ผู้ดูแลแพ็คเกจ Python ที่ต้องการแก้ไขปัญหาปรับแพคเกจสำหรับบริบทที่ไม่ซ้ำกันหรือตรวจสอบการพึ่งพาจะพบว่าการกระทำเหล่านี้มีประโยชน์เป็นพิเศษ คำสั่งเพิ่มเติมสำหรับการติดตั้งไฟล์ WHL การแปลงการกระจายแหล่งที่มาเป็นล้อและการตรวจสอบความถูกต้องของแพ็คเกจล้อนั้นรวมอยู่ในเครื่องมือมาตรฐานของ Python ซึ่งรวมถึงเครื่องมือ PIP และล้อ

ไฟล์ WHL - โครงสร้างภายใน

ไฟล์ WHL เป็นคลังเก็บซิปที่มีโครงสร้างภายในเฉพาะที่เป็นไปตามข้อกำหนดของบรรจุภัณฑ์ Python ภายในไฟล์ WHL คุณจะพบ:

• โมดูล Python ที่รวบรวมได้: ไฟล์ precompiled .pyc ที่สามารถโหลดได้โดยตรงโดยไม่ต้องรวบรวม
• แพ็คเกจข้อมูลเมตา: ข้อมูลเกี่ยวกับผู้แต่งแพ็คเกจเวอร์ชันการพึ่งพาและข้อกำหนด
• ส่วนขยายไบนารี: ไลบรารีคอมไพล์เฉพาะแพลตฟอร์มที่จำเป็นสำหรับฟังก์ชั่นแพ็คเกจ
• การประชุมการตั้งชื่อที่มีโครงสร้าง: ชื่อไฟล์ที่เข้ารหัสข้อมูลที่สำคัญ:
  • ชื่อแพ็คเกจ
  • หมายเลขเวอร์ชัน
  • แท็กความเข้ากันได้ของ Python
  • สถาปัตยกรรมเป้าหมาย (เช่น win_amd64, manylinux1_x86_64)

องค์กรภายในมาตรฐานนี้รวมถึง:

• เนื้อหาแพ็คเกจรูท: รหัสและทรัพยากร Python จริง
• . ไดเรกทอรี dist-info: มีไฟล์ข้อมูลเมตาเช่นข้อมูลเมตา, ล้อและบันทึก
• . Data Directory (ไม่บังคับ): ถือไฟล์ข้อมูลและทรัพยากรที่ไม่ใช่ Python

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

ความนิยมของไฟล์ WHL และการสนับสนุน

เนื่องจากประสิทธิภาพและความน่าเชื่อถือของมัน WHL จึงกลายเป็นวิธีการกระจายที่ต้องการสำหรับแพ็คเกจ Python ตอนนี้ไฟล์ล้อสามารถเข้าถึงได้สำหรับเกือบทุกแพ็คเกจที่ระบุไว้ในดัชนีแพ็คเกจ Python (PYPI) รูปแบบนี้ได้รับการสนับสนุนอย่างเต็มที่โดยระบบนิเวศ Python พร้อมยูทิลิตี้เช่น PIP ให้ล้อที่มีความสำคัญกว่าการแจกแจงแหล่งที่มาที่มีอยู่ โดยไม่คำนึงถึงสภาพแวดล้อมการเขียนโปรแกรมนักพัฒนา Python มักจะใช้รูปแบบนี้เสมอเนื่องจากทำงานร่วมกับระบบปฏิบัติการที่สำคัญทั้งหมดรวมถึง Windows, MacOS และ Linux

ตัวอย่างของการใช้ไฟล์ WHL

ไฟล์ WHL เป็นสิ่งจำเป็นสำหรับนักพัฒนา Python ที่ต้องการแจกจ่ายและติดตั้งแพ็คเกจอย่างมีประสิทธิภาพ การทำงานกับไฟล์ WHL ช่วยให้นักพัฒนาสามารถปรับแต่งเวิร์กโฟลว์การจัดการแพ็คเกจของพวกเขา ในตัวอย่างโค้ดต่อไปนี้เราจะสำรวจวิธีการใช้ไลบรารีเพื่อสร้างและแยกไฟล์ WHL โดยแสดงให้เห็นถึงเทคนิคสำหรับการตรวจสอบแพ็คเกจและการดัดแปลง ตัวอย่างเหล่านี้จะช่วยให้คุณเข้าใจวิธีการใช้ประโยชน์จากไฟล์ WHL ในโครงการพัฒนา Python ของคุณสำหรับการจัดการการพึ่งพาและการปรับใช้ที่ราบรื่นยิ่งขึ้น

    using (var archive = new Archive())
    {
        archive.CreateEntry("entry_name1.dat", "input_file1.dat");
        archive.CreateEntry("entry_name2.dat", "input_file2.dat");
        archive.Save("result_archive.whl");
    }

    using (var whlFile = File.Open("EncrypedWithAES256.whl", FileMode.Create)) 
    { 
        using (var source = File.Open("alice29.txt", FileMode.Open, FileAccess.Read)) 
        { 
            using (var archive = new Archive(new ArchiveEntrySettings(null, new AesEncryptionSettings("p@s$", EcryptionMethod.AES256)))) 
            { 
                archive.CreateEntry("alice29.txt", source); 
                archive.Save(whlFile); 
            } 
        } 
    }

Aspose.Zip offers individual archive processing APIs for popular development environments, listed below:

ข้อมูลเพิ่มเติมเกี่ยวกับ Archives WHL

• PEP 427
• .egg

มีคนถาม

1. ฉันจะติดตั้งไฟล์ WHL ใน Python ได้อย่างไร

ในการติดตั้งไฟล์ whl ให้ใช้คำสั่ง pip: pip ติดตั้ง filename.whl คำสั่งนี้ใช้งานได้กับแพลตฟอร์มทั้งหมดและเป็นวิธีมาตรฐานในการติดตั้งแพ็คเกจล้อใน Python หากคุณทำงานในสภาพแวดล้อมเสมือนจริงตรวจสอบให้แน่ใจว่าเปิดใช้งานก่อน

2. ฉันสามารถสร้างไฟล์ WHL ของตัวเองเพื่อแจกจ่ายได้หรือไม่?

ใช่คุณสามารถสร้างไฟล์ WHL โดยใช้เครื่องมือสร้างของ Python ก่อนอื่นให้แน่ใจว่าโครงการของคุณมีไฟล์ setup.py หรือ pyproject.toml ที่เหมาะสมจากนั้นเรียกใช้ python -m build -wheel ในไดเรกทอรีโครงการของคุณ สิ่งนี้จะสร้างไฟล์ WHL ในไดเรกทอรี DIST/ DIRECTORY ที่คุณสามารถแจกจ่ายหรืออัปโหลดไปยัง PYPI

3. WHL Files เฉพาะแพลตฟอร์มหรือไม่

ขึ้นอยู่กับเนื้อหาของแพ็คเกจ ล้อ ‘Pure Python’ (ทำเครื่องหมายด้วยแท็ก ‘PY3’) ทำงานในทุกแพลตฟอร์ม อย่างไรก็ตามล้อที่มีส่วนขยายที่คอมไพล์ (ทำเครื่องหมายด้วยแท็กเฉพาะแพลตฟอร์มเช่น ‘win_amd64’ หรือ ‘manylinux’) เป็นแพลตฟอร์มเฉพาะและจะทำงานกับระบบการจับคู่เท่านั้น นี่คือเหตุผลที่บางแพ็คเกจมีไฟล์หลายล้อสำหรับแพลตฟอร์มที่แตกต่างกัน