วิธีการระบุใน requirements.txt แหล่ง github โดยตรง

ฉันติดตั้งไลบรารีโดยใช้คำสั่ง

pip install git+git://github.com/mozilla/elasticutils.git

ซึ่งติดตั้งโดยตรงจากแหล่งเก็บ Github requirements.txtนี้ทำงานได้ดีและผมต้องการที่จะมีการพึ่งพาในการที่ของฉัน ฉันดูตั๋วประเภทอื่นเช่นนี้แต่นั่นก็ไม่ได้แก้ปัญหาของฉัน ถ้าฉันใส่อะไรเช่น

-f git+git://github.com/mozilla/elasticutils.git
elasticutils==0.7.dev

ในrequirements.txtไฟล์pip install -r requirements.txtผลลัพธ์ในเอาต์พุตต่อไปนี้:

Downloading/unpacking elasticutils==0.7.dev (from -r requirements.txt (line 20))
  Could not find a version that satisfies the requirement elasticutils==0.7.dev (from -r requirements.txt (line 20)) (from versions: )
No distributions matching the version for elasticutils==0.7.dev (from -r requirements.txt (line 20))

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

ใครบ้างมีวิธีแก้ไขปัญหาของฉันหรือไม่

ไวยากรณ์ของแพคเกจ“ แก้ไขได้”สามารถใช้ในrequirements.txtการนำเข้าแพ็คเกจจากVCSหลากหลาย(git, hg, bzr, svn) :

-e git://github.com/mozilla/elasticutils.git#egg=elasticutils

นอกจากนี้ยังเป็นไปได้ที่จะชี้ไปที่การกระทำเฉพาะ:

-e git://github.com/mozilla/elasticutils.git@000b14389171a9f0d7d713466b32bc649b0bed8e#egg=elasticutils

โดยปกติrequirements.txtไฟล์ของคุณจะมีลักษณะดังนี้:

package-one==1.9.4
package-two==3.7.1
package-three==1.0.1
...

ในการระบุ repo Github คุณไม่จำเป็นต้องมีการpackage-name==ประชุม

ตัวอย่างด้านล่างอัปเดตpackage-twoโดยใช้ repo GitHub ข้อความระหว่าง@และ#หมายถึงเฉพาะของแพคเกจ

ระบุแฮชคอมมิต ( 41b95ecในบริบทของการอัพเดตrequirements.txt):

package-one==1.9.4
git+git://github.com/path/to/package-two@41b95ec#egg=package-two
package-three==1.0.1

ระบุชื่อสาขา ( master):

git+git://github.com/path/to/package-two@master#egg=package-two

ระบุแท็ก ( 0.1):

git+git://github.com/path/to/package-two@0.1#egg=package-two

ระบุรุ่น ( 3.7.1):

git+git://github.com/path/to/package-two@releases/tag/v3.7.1#egg=package-two

โปรดทราบว่า#egg=package-twoนี่ไม่ใช่ความคิดเห็นที่นี่ก็คือการระบุชื่อแพคเกจอย่างชัดเจน

โพสต์บล็อกนี้มีการอภิปรายเพิ่มเติมในหัวข้อ

requirements.txtอนุญาตวิธีต่อไปนี้ในการระบุการขึ้นต่อกันของแพ็กเกจในที่เก็บ git ณ pip 7.0: ¹

[-e] git+git://git.myproject.org/SomeProject#egg=SomeProject
[-e] git+https://git.myproject.org/SomeProject#egg=SomeProject
[-e] git+ssh://git.myproject.org/SomeProject#egg=SomeProject
-e git+git@git.myproject.org:SomeProject#egg=SomeProject

สำหรับ Github ซึ่งหมายความว่าคุณสามารถทำได้ (สังเกตสิ่งที่ตัดออก-e):

git+git://github.com/mozilla/elasticutils.git#egg=elasticutils

ทำไมคำตอบพิเศษ?
ฉันรู้สึกสับสนกับ-eธงในคำตอบอื่น ๆ ดังนั้นนี่คือคำอธิบายของฉัน:

-eหรือ--editableธงหมายความว่าแพคเกจติดตั้งใน<venv path>/src/SomeProjectและดังนั้นจึงไม่ได้อยู่ในฝังลึก<venv path>/lib/pythonX.X/site-packages/SomeProjectมันมิฉะนั้นจะถูกวางไว้ใน. ²

เอกสาร

• ¹ https://pip.readthedocs.org/en/stable/reference/pip_install/#git
• ² https://pip.readthedocs.org/en/stable/reference/pip_install/#vcs-support

ก่อนอื่นให้ติดตั้งด้วยgit+gitหรือgit+httpsในแบบที่คุณรู้ ตัวอย่างการติดตั้งkronokสาขาของbrabeionโครงการ:

pip install -e git+https://github.com/kronok/brabeion.git@12efe6aa06b85ae5ff725d3033e38f624e0a616f#egg=brabeion

ประการที่สองการใช้งานที่จะได้รับสิ่งที่ถูกต้องในของคุณpip freeze > requirements.txt requirements.txtในกรณีนี้คุณจะได้รับ

-e git+https://github.com/kronok/brabeion.git@12efe6aa06b85ae5ff725d3033e38f624e0a616f#egg=brabeion-master

ประการที่สามทดสอบผล:

pip uninstall brabeion
pip install -r requirements.txt

ตั้งแต่ pip v1.5, (เผยแพร่เมื่อ 1 มกราคม 2014: CHANGELOG , PR ) คุณอาจระบุไดเรกทอรีย่อยของ repo git เพื่อเก็บโมดูลของคุณ ไวยากรณ์มีลักษณะดังนี้:

pip install -e git+https://git.repo/some_repo.git#egg=my_subdir_pkg&subdirectory=my_subdir_pkg # install a python package from a repo subdirectory

หมายเหตุ: ในฐานะผู้เขียนโมดูล pip คุณควรจะเผยแพร่โมดูลของคุณใน repo ระดับบนของตัวเองถ้าคุณทำได้ คุณลักษณะนี้มีประโยชน์สำหรับ repos ที่มีอยู่แล้วที่มีโมดูล python ในไดเรกทอรีย่อย คุณอาจถูกบังคับให้ติดตั้งด้วยวิธีนี้หากไม่ได้เผยแพร่ไปยัง pypi

ฉันพบว่ามันเป็นเรื่องยากที่จะรับ pip3 (v9.0.1 ซึ่งติดตั้งโดยตัวจัดการแพคเกจของ Ubuntu 18.04) เพื่อติดตั้งสิ่งที่ฉันบอกให้ติดตั้งจริง ๆ ฉันโพสต์คำตอบนี้เพื่อประหยัดเวลาของทุกคนที่พบปัญหานี้

การนำสิ่งนี้ลงในไฟล์ requirements.txt ล้มเหลว:

git+git://github.com/myname/myrepo.git@my-branch#egg=eggname

โดย "ล้มเหลว" ฉันหมายความว่าในขณะที่มันดาวน์โหลดรหัสจาก Git มันก็จบลงด้วยการติดตั้งรหัสดั้งเดิมตามที่พบใน PyPi แทนที่จะเป็นรหัสใน repo ในสาขานั้น

อย่างไรก็ตามการติดตั้งการยอมรับแทนชื่อสาขาใช้งานได้:

git+git://github.com/myname/myrepo.git@d27d07c9e862feb939e56d0df19d5733ea7b4f4d#egg=eggname