configure GITHUB Actions To Upload Python Package to PypI.github.io

ข้อกำหนดเบื้องต้น

• - แพ็คเกจ Python เพื่ออัปโหลด
• บัญชี GitHub
• บัญชี PYPI
• - โทเค็น API PYPI

สร้างโทเค็น PYPI API

1. เข้าสู่บัญชี PYPI ของคุณ : ไปที่เว็บไซต์ PYPI (https://pypi.org/) และเข้าสู่บัญชีของคุณ

2. นำทางไปที่ "การตั้งค่าบัญชี" : คลิกที่ชื่อผู้ใช้ของคุณที่มุมบนขวาและเลือก "การตั้งค่าบัญชี" จากเมนูแบบเลื่อนลง

3. สร้างโทเค็น API ใหม่ : เลื่อนลงไปที่ส่วน "API Tokens" และคลิกที่ปุ่ม "สร้าง API Token"

4. ตั้งชื่อโทเค็นของคุณ : ตั้งชื่อโทเค็นของคุณที่จะช่วยคุณระบุวัตถุประสงค์ (เช่น "การกระทำของ GitHub")

5. สร้างโทเค็น : คลิกที่ปุ่ม "สร้างโทเค็น" โทเค็นจะปรากฏบนหน้าจอ คัดลอกโทเค็นนี้และรักษาความปลอดภัยเนื่องจากคุณจะไม่สามารถเห็นได้อีก

6. เพิ่มโทเค็นลงในความลับของ GitHub : ไปที่ที่เก็บ GitHub ของคุณคลิกที่ "การตั้งค่า" จากนั้น "ความลับ" และคลิกที่ "ความลับที่เก็บใหม่" ตั้งชื่อความลับของคุณ (เช่น TEST_PYPI_API_TOKEN ) และวางโทเค็น API PYPI ที่คุณสร้างขึ้น คลิกที่ "เพิ่มความลับ" เพื่อบันทึก

ขั้นตอน

1. สร้างแพ็คเกจ Python ของคุณ : ตรวจสอบให้แน่ใจว่าแพ็คเกจของคุณมีโครงสร้างอย่างถูกต้องและมีไฟล์ที่จำเป็นทั้งหมด

2. - อัปโหลดแพ็คเกจของคุณไปยัง GitHub : กดแพ็คเกจ Python ของคุณไปยังที่เก็บ GitHub

3. เปิดพื้นที่เก็บข้อมูลของคุณใน GitHub : นำทางไปยังหน้าของที่เก็บของคุณใน GitHub

4. เข้าถึงการกระทำของ GitHub : คลิกที่แท็บ "การกระทำ" ในที่เก็บของคุณ

5. ➕ สร้างเวิร์กโฟลว์ใหม่ : คลิกที่ "เวิร์กโฟลว์ใหม่" และเลือก "เผยแพร่แพ็คเกจ Python"

6. - แก้ไขไฟล์เวิร์กโฟลว์ : ไฟล์ YAML ใหม่จะถูกสร้างขึ้นภายในโฟลเดอร์. .github/workflows แทนที่เนื้อหาด้วยสิ่งต่อไปนี้:

 name : Upload Python Package

on :
  push :
    tags :
    - ' * '

jobs :
  deploy :
    runs-on : ubuntu-latest

    steps :
    - uses : actions/checkout@v2
    - uses : actions/setup-python@v2
    - name : Install dependencies
      run : |
        python -m pip install --upgrade pip
        pip install setuptools wheel twine
    - name : Build and publish
      env :
        TWINE_USERNAME : __token__
        TWINE_PASSWORD : ${{ secrets.TEST_PYPI_API_TOKEN }}
      run : |
        python setup.py sdist bdist_wheel
        # twine upload --repository testpypi dist/* --skip-existing
      

• Twine Upload Dist/* -ใช้สกายที่มีอยู่สำหรับ PYPI ใน YML 7. แท็กการกระทำของคุณ: ใช้ Git Tag -a -m "เวอร์ชัน" เพื่อติดแท็กคำมั่นสัญญาด้วยหมายเลขเวอร์ชันก่อนที่จะผลักดัน ตัวอย่างเช่น Git Tag -a v1.0 -m "เวอร์ชัน 1.0"

กดแท็กของคุณ: ใช้จุดกำเนิดแบบพุช Git เพื่อผลักแท็กของคุณไปยังที่เก็บระยะไกล ตัวอย่างเช่น Git Push Origin v1.0

หลังจากตั้งค่าสิ่งนี้ทุกครั้งที่คุณผลักดันการกระทำด้วยเวอร์ชันที่ติดแท็กการกระทำของ GitHub จะสร้างและอัปโหลดแพ็คเกจของคุณไปยัง PYPI