หน้าแรก>การเขียนโปรแกรมที่เกี่ยวข้อง>โค้ดแหล่งที่มา AI
ดาวน์โหลด

แพ็คเกจ Starter Python

วัตถุประสงค์ของโครงการนี้คือการแสดงวิธีการสร้างแพ็คเกจ Python มาตรฐานตั้งแต่เริ่มต้น โครงการนี้ได้รับแรงบันดาลใจจากแพ็คเกจ getMyip ที่ยอดเยี่ยมนี้โดย @iamtennislover: [https://github.com/iamtennislover/getMyip] และคู่มือที่ยอดเยี่ยมนี้เกี่ยวกับการปรับใช้แพ็คเกจ Python โดย @Sigma-Coding: [https://github.com/areed1192/sigma-coding]

ดู pythonstarterpackage_tutorial.md ใน doc/ Directory สำหรับการสอนทีละขั้นตอนเกี่ยวกับวิธีการปรับใช้แพ็คเกจ หากคุณใช้แพ็คเกจเริ่มต้นนี้เป็นครั้งแรกฉันขอแนะนำให้ทำบทช่วยสอนก่อน

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

ด้านล่างนี้คือทรัพยากร GitHub และ PYPI สำหรับแพ็คเกจนี้

  • GitHub repo: https://github.com/arctictechnology/pythonstarterpackage
  • pypi: https://pypi.org/project/pythonstarterpackage/

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

สำหรับ Windows ขอแนะนำให้เรียกใช้แอพนี้บนเลเยอร์การจำลอง Linux เช่นเทอร์มินัล Git Bash ดูส่วน "คำแนะนำสำหรับ Git Bash" สำหรับรายละเอียด นอกเหนือจากการทุบตี Git ตรวจสอบให้แน่ใจว่าคุณมี Python3 และ Pip3 ตามที่อธิบายไว้ด้านล่าง

สำหรับ Mac และ Linux แอพนี้ควรทำงานนอกกรอบบนเทอร์มินัล Linux หรือ Mac แต่ให้แน่ใจว่าคุณมี Python3 และ PIP3 ตามที่อธิบายไว้ด้านล่าง

ความต้องการ:

  • Python3 (เวอร์ชัน 3.8 หรือมากกว่า) - ติดตั้ง Python3 ที่นี่: [https://www.python.org/downloads/] ตรวจสอบเวอร์ชันด้วย: python3 --version
  • PIP3 (เวอร์ชัน 20.2.1 หรือมากกว่า) - ตรวจสอบให้แน่ใจว่าได้ติดตั้ง Python3 -Pip เพื่อใช้การติดตั้ง PIP ตรวจสอบเวอร์ชันด้วย: pip3 --version

การติดตั้ง

มีตัวเลือกสองสามตัวในการติดตั้งแอพนี้:

  • PIP Install - แอพนี้โฮสต์บน PYPI และสามารถติดตั้งได้ด้วยคำสั่งต่อไปนี้: 
 pip3 install PythonStarterPackage
  • การติดตั้งในพื้นที่ - หรือคุณสามารถดาวน์โหลดหรือ git clone repo gitHub และติดตั้งในเครื่องด้วยสิ่งต่อไปนี้: 
 git clone https://github.com/ArcticTechnology/PythonStarterPackage.git
cd PythonStarterPackage
pip3 install -e .

เพื่อถอนการติดตั้งแอพนี้: 

 pip3 uninstall PythonStarterPackage
  • หากคุณใช้ตัวเลือกการติดตั้งในพื้นที่คุณจะต้องลบไฟล์ .egg-info ที่อยู่ใน src/ ไดเรกทอรีของแพ็คเกจ สิ่งนี้จะถูกสร้างขึ้นโดยอัตโนมัติด้วย pip3 install -e . -

การใช้งาน

หลังจากการติดตั้งคุณมีวิธีเรียกใช้แอพนี้สองสามวิธี

  • เรียกใช้แอพนี้จากเทอร์มินัลด้วยคำสั่งนี้: 
 pythonstarterpackage
  • เรียกใช้แอพนี้ด้วยคำสั่ง python python3 -m : 
 python3 -m pythonstarterpackage
  • นอกจากนี้คุณยังสามารถนำเข้าทรัพยากรแพ็คเกจและเรียกใช้ในโครงการของคุณเอง: 
 from pythonstarterpackage import *
starter = StarterPkg()
starter.run()

เอกสาร

ในการปรับใช้แพ็คเกจนี้ก่อนอื่นให้แน่ใจว่าคุณได้ผ่าน PythonstarterPackage_tutorial.md ใน doc/ Directory เมื่อคุณมีความเข้าใจที่ดีเกี่ยวกับวิธีการใช้แพ็คเกจของคุณเองและสมมติว่าคุณมีการพึ่งพาการแมปและทดสอบแพ็คเกจคุณสามารถใช้สิ่งต่อไปนี้เพื่อปรับใช้แพ็คเกจของคุณ

การปรับใช้

เมื่อแพ็คเกจพร้อมแล้วเราสามารถทำงานในการปรับใช้แพ็คเกจ

  1. อัพเกรด setuptools wheel และ twine ( twine จะใช้ในส่วนถัดไป) 
 pip3 install --upgrade setuptools wheel twine
  1. สร้างแพ็คเกจด้วย setup.py 
 python3 setup.py sdist bdist_wheel
  1. ตรวจสอบเนื้อหาของการแจกแจง. whl และ. tar.gz สิ่งสำคัญที่ควรมองหาคือ: (1) ไดเรกทอรีย่อยแพ็คเกจทั้งหมดของคุณเช่น UTILs จะถูกเพิ่มเข้าไปในการแจกแจงทั้งสอง (2) ข้อมูลการกำหนดค่าและแพ็คเกจของคุณรวมอยู่ในการแจกแจงทั้งสอง 
 unzip -l dist/*.whl && tar --list -f dist/*.tar.gz
  1. ทดสอบการติดตั้งในพื้นที่ของแพ็คเกจและเรียกใช้เพื่อให้แน่ใจว่ามันใช้งานได้ 
 pip3 install .
pythonstarterpackage
  1. หลังจากทดสอบว่าใช้งานได้แล้วถอนการติดตั้งแพ็คเกจจาก PIP3 
 pip3 uninstall pythonstarterpackage

หากมีปัญหาใด ๆ ในข้างต้นคุณสามารถถอนการติดตั้งแพ็คเกจและลบการแจกแจงได้เสมอจากนั้นดำเนินการแก้ไขปัญหา เมื่อเริ่มต้นใหม่ตั้งแต่ต้น คำสั่งด้านล่างอนุญาตให้คุณลบการแจกแจง 

 rm -rf build dist src/*.egg-info

ระวังอย่าผิดคำสั่งข้างต้นราวกับว่าคุณลบสิ่งที่คุณไม่ได้ตั้งใจว่าจะไม่สามารถเรียกคืนได้

อัปโหลดไปยัง PYPI

ในการอัปโหลดไปยัง PYPI ตรวจสอบให้แน่ใจว่าได้ตั้งค่าบัญชี PYPI ของคุณก่อน ดู "คู่มือการตั้งค่า PYPI" ใน doc/ สำหรับรายละเอียดเพิ่มเติม คุณจะต้องมีการติดตั้งและอัพเกรด twine เมื่อคุณมีการตั้งค่าทั้งหมดนี้ทำดังต่อไปนี้:

  1. อัปโหลดโดยใช้ twine 
 twine upload dist/*
  1. ติดตั้งแพ็คเกจของคุณด้วย pip 
 pip3 install pythonstarterpackage

หมายเหตุ: หากคุณได้รับ "ข้อกำหนดที่พึงพอใจแล้ว ... " สำหรับ PythonstarterPackage เมื่อพยายามติดตั้งอาจเป็นเพราะ pip ยังคงคิดว่าคุณติดตั้งแพ็คเกจจากการทดสอบก่อนหน้านี้ หากต้องการทำลายการเชื่อมต่อนั้นอย่างหมดจดเพียงแค่ลบ. ./src/PythonStarterPackage.egg-info จากนั้นลองถอนการติดตั้งและติดตั้งใหม่อีกครั้ง

  1. ในที่สุดเรียกใช้แอพด้วย: pythonstarterpackage
  2. ถอนการติดตั้งด้วย: pip3 uninstall pythonstarterpackage

การแก้ไขปัญหา

ส่วนนี้เกิดขึ้นในประเด็นทั่วไปบางอย่างที่พบและวิธีการแก้ไข

ข้อผิดพลาด "คำสั่งไม่พบ" เมื่อเรียกใช้แอป

บน Linux หากคุณได้ command not found ข้อผิดพลาดเมื่อพยายามเรียกใช้แอพคุณอาจต้องเพิ่ม ~/.local/bin/ to path ดูหัวข้อนี้สำหรับรายละเอียด: [https://stackoverflow.com/a/34947489] เพื่อเพิ่ม ~/.local/bin/ to path ทำสิ่งต่อไปนี้:

  1. เพิ่ม export PATH=~/.local/bin:$PATH ไป ~/.bash_profile 
 echo export PATH=~/.local/bin:$PATH > ~/.bash_profile
  1. ดำเนินการคำสั่ง 
 source ~/.bash_profile

"ตัวนำ: ไม่มีโมดูลชื่อ 'tkinter'

เวอร์ชัน Python ของคุณอาจจะหายไป tkinter ซึ่งโดยทั่วไปจะเป็นค่าเริ่มต้น ดูโพสต์นี้สำหรับรายละเอียด [https://stackoverflow.com/a/25905642] ติดตั้งด้วยสิ่งต่อไปนี้: 

 sudo apt-get install python3-tk

สำหรับ Mac ใช้สิ่งนี้: 

 brew install python-tk

คำแนะนำสำหรับ Git Bash

สำหรับ Windows ขอแนะนำให้เรียกใช้แอพนี้บนเลเยอร์เลียนแบบ Linux เช่นเทอร์มินัล Git Bash นี่คือคำแนะนำสำหรับการติดตั้งและตั้งค่า Git Bash:

  1. ไปที่ https://git-scm.com/downloads แล้วคลิกดาวน์โหลด 
 Version >= 2.34.1
  1. ในระหว่างการติดตั้งการติดตั้งตรวจสอบให้แน่ใจว่าได้รวม openssh การตั้งค่าที่แนะนำควรจะดี: 
 Use bundled OpenSSH - This uses ssh.exe that comes with Git.
  1. ปล่อยให้การตั้งค่าอื่นเป็นค่าเริ่มต้นคลิกผ่านและติดตั้ง
  2. เปิด bash.exe และติดตั้ง python3 https://www.python.org/downloads/
  3. ดำเนินการต่อไปยังส่วน "การติดตั้ง" เพื่อติดตั้งแอพนี้

สำคัญ: สำหรับ windows ให้ใช้เทอร์มินัล bash.exe ค่อนข้าง git-bash.exe มีปัญหาที่ทราบกับ git-bash.exe messing คำสั่ง Python os ใน import os ดูหัวข้อนี้สำหรับรายละเอียด: [https://stackoverflow.com/a/33623136]

  • คุณสามารถค้นหาโฟลเดอร์ bash.exe git ใน bin/ directory ตัวอย่างเช่น: ถ้า git-bash.exe อยู่ที่นี่ C:Program FilesGitgit-bash.exe คุณควรพบ bash.exe ที่นี่ C:Program FilesGitbinbash.exe

การสนับสนุนและการมีส่วนร่วม

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

ที่อยู่ Bitcoin 1: 1GZQY6HMWSZQXCMBC6UGXKYD5HKPHK1PMF

ข้อความ alt

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