O documento discute o gerenciamento de dependências em Python usando pipenv. Ele explica como instalar dependências individuais e múltiplas, estruturar requirements.txt, isolar dependências por ambiente e projeto usando virtualenv e pipenv, e gerenciar versões exatas de dependências.

1. Gerenciamento de
dependências em Python
@patrickporto

2. Patrick Porto
● Pythonista há 6 anos
● Graduando em Ciência da
Computação
● Engenheiro de Software
Sênior na Stone
Pagamentos

3. Como instalar uma
dependência no
Python?

4. Instalação de dependência no Python
pip install django

5. Como instalar várias
dependências no
Python?

6. Instalação de várias dependências
$ pip install django
$ pip install gunicorn
$ pip install pytest
[...]

7. Requirements.txt

8. Anatomia de um requirements.txt
django >= 1.11
gunicorn ~= 19.4.5
pytest

9. Como posso
separar as minha
dependências por
ambiente?

10. Estrutura de Projeto (two scoops)
● requirements/base.txt
● requirements/local.txt
● requirements/production.txt
● requirements/test.txt
● requirements.txt

11. Como posso ter
diferentes
dependência para
vários projetos?

12. Virtualenv

13. Criação de virtualenv
$ virtualenv env
$ envScriptsactivate
$ (env) pip install -r requirements.txt

14. Problema #1
Como obter as
versões exatas das
dependências do
projeto?

15. Problema #2
Como posso ter
uma lista das
dependências em
alto nível?

16. Pipenv

17. Instalação do Pipenv
pip install pipenv

18. Instalação de dependência pelo Pipenv
pipenv install django

19. Instalação de dependência pelo Pipenv
Creating a virtualenv for this project…
Installing setuptools, pip, wheel...done.
Virtualenv location: ~.virtualenvs<NOME_DA_SUA_VIRTUALENV>
Creating a Pipfile for this project…
Installing django…
Adding django to Pipfile's [packages]…
PS: You have excellent taste!
Locking [dev-packages] dependencies…
Locking [packages] dependencies…
Updated Pipfile.lock (2f8679)!

20. Instalação de dependência pelo Pipenv
pipenv install pytest --dev

21. Executação de comandos pela virtualenv
pipenv run django-admin startproject meusite

22. Ativação da virtualenv
pipenv shell

23. Pipfile

24. Estrutura de um projeto com pipenv
● Pipfile - dependências de alto nível
● Pipfile.lock - dependências com suas versões exatas

25. Anatomia de um Pipfile
[[source]]
url = "https://pypi.python.org/simple"
verify_ssl = true
[dev-packages]
pytest = "*"
[packages]
django = "*"
[requires]
python_version = "3.4"

26. Anatomia de um Pipfile
[[source]]
url = "https://pypi.python.org/simple"
verify_ssl = true
[dev-packages]
pytest = "*"
[packages]
django = "*"
[requires]
python_version = "3.4"

27. Anatomia de um Pipfile
[[source]]
url = "https://pypi.python.org/simple"
verify_ssl = true
[dev-packages]
pytest = "*"
[packages]
django = "*"
[requires]
python_version = "3.4"
$ pipenv install pytest --dev

28. Anatomia de um Pipfile
[[source]]
url = "https://pypi.python.org/simple"
verify_ssl = true
[dev-packages]
pytest = "*"
[packages]
django = "*"
[requires]
python_version = "3.4"
$ pipenv install django

29. Anatomia de um Pipfile
[[source]]
url = "https://pypi.python.org/simple"
verify_ssl = true
[dev-packages]
pytest = "*"
[packages]
django = ">1.10"
[requires]
python_version = "3.4"
PEP 440

30. PEP 440
django ~= 1.10 Versão compatível
django == 1.10 Versão correspondente
django != 1.10 Versão diferente
django <= 1.10 Versão igual ou inferior
django >= 1.10 Versão superior ou igual
django < 1.10 Versão inferior
django > 1.10 Versão superior

31. Anatomia de um Pipfile
[[source]]
url = "https://pypi.python.org/simple"
verify_ssl = true
[dev-packages]
pytest = "*"
[packages]
django = ">1.10"
[requires]
python_version = "3.4"
PEP 508

32. PEP 508
python_version = “3.6” Versão do python
platform_python_implementation = “CPython” Implementação do python
platform_system = “Linux” Sistema operacional
platform_machine = “x86_64” Arquitetura do processador

33. pipenv (avançado)

34. Versionamento do Python
pipenv install

35. Versionamento do Python
$ pipenv install
Warning: Python 3.6 was not found on your system…
Would you like us to install latest CPython 3.6 with pyenv? [Y/n]: y
Installing CPython 3.6.2 with pyenv (this may take a few minutes)…
...
Making Python installation global…
Creating a virtualenv for this project…
Using ~/.pyenv/shims/python3 to create virtualenv…
...
No package provided, installing all dependencies.
...
Installing dependencies from Pipfile.lock…
================================ 5/5 — 00:00:03
To activate this project's virtualenv, run the following:
$ pipenv shell

36. Instalação de dependências no sistema
pipenv install --system --deploy

37. Detecção de vulnerabilidades
pipenv check

38. Detecção de vulnerabilidades
$ pipenv check
Checking PEP 508 requirements…
Passed!
Checking installed package safety…
33075: django >=1.10,<1.10.3 resolved (1.10.1 installed)!
Django before 1.8.x before 1.8.16, 1.9.x before 1.9.11, and 1.10.x before 1.10.3, when
settings.DEBUG is True, allow remote attackers to conduct DNS rebinding attacks by
leveraging failure to validate the HTTP Host header against settings.ALLOWED_HOSTS.
33076: django >=1.10,<1.10.3 resolved (1.10.1 installed)!
Django 1.8.x before 1.8.16, 1.9.x before 1.9.11, and 1.10.x before 1.10.3 use a hardcoded
password for a temporary database user created when running tests with an Oracle database,
which makes it easier for remote attackers to obtain access to the database server by
leveraging failure to manually specify a password in the database settings TEST dictionary.

39. Verificação de Code Style
pipenv check --style app.py

40. Verificação de Code Style
$ pipenv check --style app.py
app.py:1:1: F401 'requests' imported but unused
app.py:1:16: W292 no newline at end of file

41. Abrir uma dependência no seu editor
pipenv open django

42. Visualização de dependências aninhadas
pipenv graph

43. Visualização de dependências aninhadas
$ pipenv graph
Django==1.11.6
- pytz [required: Any, installed: 2017.2]
requests==2.18.4
- certifi [required: >=2017.4.17, installed: 2017.7.27.1]
- chardet [required: <3.1.0,>=3.0.2, installed: 3.0.4]
- idna [required: >=2.5,<2.7, installed: 2.6]
- urllib3 [required: <1.23,>=1.21.1, installed: 1.22]

44. Geração de requirements.txt
pipenv lock -r > requirements.txt

45. Dúvidas?

46. Referências
● https://www.kennethreitz.org/essays/a-better-pip-workflow
● https://medium.com/@patrickporto/introdução-ao-pipenv-49aa9685dfe4
● https://github.com/pypa/pipfile
● https://github.com/kennethreitz/pipenv
● https://docs.pipenv.org

47. Obrigado!
Medium: @PatrickPorto
Twitter: @patrickporto
Telegram: @patrickporto
Email: patrick.s.porto@gmail.com