Como declarar no requirements.txt uma fonte direta do github

Eu instalei uma biblioteca usando o comando

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

que o instala diretamente de um repositório do Github. Isso funciona bem e eu quero ter essa dependência na minha requirements.txt. Eu olhei para outros tickets como este, mas isso não resolveu o meu problema. Se eu colocar algo como

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

no requirements.txtarquivo, pip install -r requirements.txtresulta na seguinte saída:

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

A documentação do arquivo de requisitos não menciona links usando o git+gitespecificador de protocolo, portanto, talvez isso não seja suportado.

Alguém tem uma solução para o meu problema?

A sintaxe dos pacotes “editáveis” pode ser usada requirements.txtpara importar pacotes de uma variedade de VCS (git, hg, bzr, svn) :

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

Além disso, é possível apontar para um commit específico:

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

Normalmente, seu requirements.txtarquivo ficaria assim:

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

Para especificar um repositório do Github, você não precisa do package-name== convenção.

Os exemplos abaixo são atualizados package-twousando um repositório GitHub. O texto entre @e# denota as especificidades do pacote.

Especifique o hash de confirmação ( 41b95ecno contexto de atualizado requirements.txt):

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

Especifique o nome da filial ( master):

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

Especifique a tag ( 0.1):

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

Especifique release ( 3.7.1):

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

Observe que #egg=package-twonão é um comentário aqui, é declarar explicitamente o nome do pacote

Esta postagem do blog tem mais algumas discussões sobre o tópico.

requirements.txtpermite as seguintes maneiras de especificar uma dependência em um pacote em um repositório git a partir do 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

Para o Github, isso significa que você pode fazer (observe o omitido -e):

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

Por que a resposta extra?
Fiquei um pouco confuso com a -ebandeira nas outras respostas, então aqui está o meu esclarecimento:

O -eou --editableos meios de bandeira de que o pacote é instalada dentro <venv path>/src/SomeProjecte, assim, não no profundamente enterrado <venv path>/lib/pythonX.X/site-packages/SomeProjectque de outra forma seriam colocados em. ²

Documentação

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

Primeiro, instale com git+gitou git+https, da maneira que você souber. Exemplo de instalação kronokdo ramo do brabeionprojeto:

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

Segundo, use pip freeze > requirements.txtpara obter a coisa certa no seu requirements.txt. Nesse caso, você receberá

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

Terceiro, teste o resultado:

pip uninstall brabeion
pip install -r requirements.txt

Desde o pip v1.5(lançado em 1º de janeiro de 2014: CHANGELOG , PR ), você também pode especificar um subdiretório de um repositório git para conter seu módulo. A sintaxe é assim:

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: Como autor do módulo pip, idealmente, você provavelmente desejaria publicar seu módulo em seu próprio repositório de nível superior, se puder. No entanto, esse recurso é útil para alguns repositórios preexistentes que contêm módulos python em subdiretórios. Você pode ser forçado a instalá-los dessa maneira, se eles também não forem publicados no pypi.

Estou descobrindo que é meio complicado conseguir que o pip3 (v9.0.1, instalado pelo gerenciador de pacotes do Ubuntu 18.04) realmente instale o que eu digo para instalar. Estou postando esta resposta para economizar tempo de qualquer um que tenha esse problema.

Colocar isso em um arquivo requirements.txt falhou:

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

Por "falha", quero dizer que, enquanto ele baixava o código do Git, acabou instalando a versão original do código, como encontrada no PyPi, em vez do código no repositório nesse ramo.

No entanto, a instalação do commit em vez do nome da filial funciona:

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