Come dichiarare in requisito.txt una fonte github diretta

Ho installato una libreria usando il comando

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

che lo installa direttamente da un repository Github. Funziona bene e voglio avere quella dipendenza nel mio requirements.txt. Ho visto altri biglietti come questo, ma questo non ha risolto il mio problema. Se metto qualcosa del genere

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

nel requirements.txtfile, si pip install -r requirements.txtottiene il seguente output:

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))

La documentazione del file dei requisiti non menziona i collegamenti che utilizzano l' git+gitidentificatore di protocollo, quindi forse questo non è supportato.

Qualcuno ha una soluzione per il mio problema?

La sintassi dei pacchetti "modificabili" può essere utilizzata requirements.txtper importare pacchetti da una varietà di VCS (git, hg, bzr, svn) :

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

Inoltre, è possibile indicare un commit particolare:

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

Normalmente il tuo requirements.txtfile sarebbe simile al seguente:

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

Per specificare un repository Github, non è necessaria la package-name==convenzione.

Gli esempi seguenti si aggiornano package-twousando un repository GitHub. Il testo tra @e #indica i dettagli del pacchetto.

Specificare l'hash di commit ( 41b95ecnel contesto dell'aggiornamento requirements.txt):

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

Specifica il nome del ramo ( master):

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

Specifica tag ( 0.1):

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

Specifica release ( 3.7.1):

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

Si noti che #egg=package-twonon è un commento qui, è di indicare esplicitamente il nome del pacchetto

Questo post sul blog ha qualche discussione in più sull'argomento.

requirements.txtconsente i seguenti modi per specificare una dipendenza da un pacchetto in un repository git a partire da 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

Per Github ciò significa che puoi fare (nota l'omesso -e):

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

Perché la risposta extra?
Sono stato un po 'confuso dalla -ebandiera nelle altre risposte, quindi ecco il mio chiarimento:

La bandiera -eo --editableindica che il pacchetto è installato in <venv path>/src/SomeProjecte quindi non nel sepolto profondo in <venv path>/lib/pythonX.X/site-packages/SomeProjectcui verrebbe altrimenti inserito. ²

Documentazione

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

Innanzitutto, installa con git+gito git+https, come sai. Esempio di installazione kronokdel ramo del brabeionprogetto:

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

In secondo luogo, utilizzare pip freeze > requirements.txtper ottenere la cosa giusta nel tuo requirements.txt. In questo caso, otterrai

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

In terzo luogo, testare il risultato:

pip uninstall brabeion
pip install -r requirements.txt

Dal momento che pip v1.5, (rilasciato il 1 gennaio 2014: CHANGELOG , PR ), puoi anche specificare una sottodirectory di un repository git per contenere il tuo modulo. La sintassi è simile al seguente:

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

Nota: come autore del modulo pip, idealmente probabilmente vorrai pubblicare il tuo modulo nel suo repository di livello superiore, se puoi. Tuttavia, questa funzione è utile per alcuni repository preesistenti che contengono moduli Python in sottodirectory. Potresti essere costretto a installarli in questo modo se non vengono pubblicati anche su Pypi.

Sto scoprendo che è un po 'difficile ottenere pip3 (v9.0.1, come installato dal gestore dei pacchetti di Ubuntu 18.04) per installare effettivamente la cosa che gli dico di installare. Sto pubblicando questa risposta per risparmiare tempo a chiunque si imbatta in questo problema.

Inserimento in un file requisito.txt non riuscito:

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

Per "fallito" intendo che mentre scaricava il codice da Git, ha finito per installare la versione originale del codice, come trovata su PyPi, invece del codice nel repository su quel ramo.

Tuttavia, l'installazione di commit anziché il nome del ramo funziona:

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