Python Packaging Without Pain

PyPI is an incredibly important piece of infrastructure for the Python community, and if you use Python, you probably use PyPI, directly or indirectly, on a daily basis; many different sites, services, and companies rely heavily on it. Historically, Python packaging has been a source of significant pain for even the most devoted Python enthusiasts. In this talk I'll be covering all the required instructions and a quick overview of the current state of Python packaging. We'll go from nothing to a package that you can proudly put it in your portfolio to be used by other people. And yeah! Without pain!

Transcript

1. Python Packaging 2019 Oscar Cortez February
2. Without Pain Python Packaging 2019 Oscar Cortez February
3. Without Pain Python Packaging Oscar Cortez February 2019 I PROMISE !
4. Hi!
5. @oscar_mcm
6. Do you know what is pip and virtualenv?
7. Have ever submitted a Python package?
8. Why people don’t publish new packages?
9. •Batteries included?
10. 150,136 168,650 ~600,000 Source: modulecounts.com
11. •Packaging is HARD? •Batteries included?
12. MANIFEST.in setup.py README.md Documentation tox.ini easy_install distribute pip virtualenv travis.yml setuptools package_data.dat setup.cfg Readme.rst Makefile runtest.py disutils twine pytest.ini Coverage
13. •Can I create a package? •Packaging is HARD? •Batteries included?
14. PYTHON PACKAGING
15. PYTHON PACKAGING Dustin Ingram
16. •Getting the code you wrote
17. •To the people that want it •Getting the code you wrote
18. •To the people that want it •Getting the code you wrote •Using the same language you wrote it in
20. ar Architecture
21. ar Architecture
22. Terminology
23. setuptools 1
24. Project 2
25. Collection of multiple resources Project
26. 3 Package
27. Package Container of different modules
28. Module 4
29. Module The basic unit of code reusability in Python
30. Pure Module
31. Extension Module
32. Egg 6
33. Not This
34. Egg Same concept as a .jar file in Java
35. Wheel 9
36. Not This
37. Wheel Are the new standard of Python distribution and are intended to replace eggs, wheels as in a Cheese Shops.
38. “I want to share my code! What do I need to do?”
39. •Share Via USB?
40. •Share Via Email? •Share Via USB?
41. •Share Via Personal Website? •Share Via USB? •Share Via Email?
42. DANGEROUS
43. Use PyPI
44. Python Package Index aka The Cheese Shop
46. What do I need?
47. TL;DR
48. TL;DR
51. pypa/sampleproject
53. “But I just wanted to share my code!”
54. MVPyP
55. M V Py P
56. Minimal V Py P
57. Minimal Viable Py P
58. Minimal Viable Python P
59. Minimal Viable Python Package
60. •Module
61. •Readme •Module
62. •Setup Script •Module •Readme
63. •Documentation •CI •Tests •Demo
64. MVPyP
65. setup.py
67. Use markdown markup
69. Please add classifiers
71. Please add classifiers https://pypi.org/classifiers/
73. Best classifier?
74. Best classifier? Private :: Do Not Upload
75. Use develop mode in local environments
77. Use PyPI testing instance
78. Use PyPI testing instance https://test.pypi.org/
80. Will save you hours!!
81. “Lets go, share the code!”
83. Source Distributions
84. sdist
85. Built Distributions
86. bdist_wheel
88. Finally, it’s time to upload your package to the Python Package Index!
89. Use PyPI testing instance FIRST
90. pip install twine
92. https://test.pypi.org/project/pycaribbean
94. $ twine upload dist/*
95. The Future?
96. The Future? PEP 518
97. The Future? PEP 517
98. Alternatives
99. •Flit •Hatch •Poetry •Pipenv Alternatives
100. @oscar_mcm ¡GRACIAS!