We Buy Cheese in a Cheese Shop
•
1 like•906 views
NOTE: SlideShare seems to have problems rendering some of my screenshots. Please visit https://speakerdeck.com/uranusjr/we-buy-cheese-in-a-cheese-shop for a correctly-displayed version. ORIGINAL DESCRIPTION: Python packaging is ______. But PyPA is trying to solve the problem. Let's take a look at how we got into this mess in the first place, and how did/will PyPA do to fix it.
More Related Content
What's hot
Viewers also liked
Viewers also liked (20)
Similar to We Buy Cheese in a Cheese Shop
Similar to We Buy Cheese in a Cheese Shop (20)
Recently uploaded
Recently uploaded (20)
We Buy Cheese in a Cheese Shop
- 1. We Buy Cheese in a Cheese Shop
- 2. Cheese Shop
- 6. Click this!
- 7. “I buy my eggs at the cheese shop” ] E G A U G - Aaron Straup Cope N O O [M DjangoCon 2008 N A L 59 Why I Hate Django by Cal Henderson at DjangoCon 2008
- 8. Me • Call me TP • Follow @uranusjr • RTFM • http://uranusjr.logdown.com/pages/about
- 9. Terminology
- 10. PyPI
- 11. Python Package Index aka The Cheese Shop
- 12. PyPA
- 13. Python Packaging Authority Nobody Expects the Python Packaging Authority by Nick Coghlan at PyCon Australia 2013
- 15. Egg
- 16. Eggs are to Pythons as Jars are to Java http://peak.telecommunity.com/DevCenter/PythonEggs
- 18. Wheel
- 20. Wheels as in Cheese Shops
- 21. http://www.pythonwheels.com (retrieved on 2013-11-30)
- 23. Wheel is… • The replacement of egg • Standardized • Alternative Python implementation • API tag • Packaged with better structure and metadata • Performance • Security
- 24. But Why? If It Ain’t Broke, Don’t Fix It
- 25. Because Eggs Are Broken No pun intended
- 26. Where We Are Now
- 29. distutils • I am no expert on neither itself nor its history • Built-in since Python 1.6 (2000) • Nothing really changed since about 10 years ago Full documentation: http://docs.python.org/library/distutils.html
- 30. Container What you want to deploy Full documentation: http://docs.python.org/library/distutils.html
- 31. The “Makefile” Full documentation: http://docs.python.org/library/distutils.html
- 32. Extra rules on non-module information Full documentation: http://docs.python.org/library/distutils.html
- 33. setup.py from distutils.core import setup! ! setup(! name='mypackage',! version='1.0',! packages=['mymodule'],! description='My package',! url='http://myawesomepackage.com',! author='Me the Author',! author_email='im@aweso.me'! ) Documentation: http://docs.python.org/distutils/setupscript.html
- 34. MANIFEST.in include README.rst! recursive-exclude * __pycache__! recursive-exclude * *.py[co]! include docs! prune docs/build Documentation: http://docs.python.org/distutils/sourcedist.html
- 35. $ python setup.py sdist! ! $ python setup.py bdist_wininst Documentation: http://docs.python.org/distutils/sourcedist.html
- 37. from setuptools import setup! ! setup(! # ...! ) $ python setup.py bdist_egg Documentation: http://peak.telecommunity.com/DevCenter/PythonEggs
- 39. Binary egg
- 41. “I buy my eggs at the cheese shop” - Aaron Straup Cope DjangoCon 2008 58 Does this make sense now?
- 43. Package metadata (collected from setup)
- 44. The “zip safety” flag
- 46. Files in the package
- 48. Package information (as seen on PyPI)
- 49. Where to find packages (aside from PyPI)
- 51. $ python setup.py register! ! $ python setup.py sdist bdist_egg upload Documentation: http://docs.python.org/distutils/packageindex.html
- 56. [Y]ou don't have to worry about it. They've figured it all out already. The Absolute Minimum Every Software Developer Absolutely, Positively Must Know About Unicode and Character Sets (No Excuses!) by Joel Spolsky
- 57. Actually they did not; I just don’t want to talk about it.
- 59. The Manual Way 1. Go to PyPI and search for a package 2. Download 3. Install • Extract • python setup.py install
- 60. With Setuptools 1. Install Setuptools 2. Run easy_install <package>! 3. Profit! Documentation: https://pypi.python.org/pypi/setuptools#installation-instructions
- 61. Problem?
- 62. LIAR!!!1
- 66. Why PIP? • All packages are downloaded before installation • Flat installation by default • Uninstallation • Clean code™ • PyPI with HTTPS by default http://www.pip-installer.org/en/latest/other-tools.html#easy-install
- 67. Why NOT PIP? • Incompatible with certain legacy packages (rare) • Cannot install from bdist packages (except eggs) http://www.pip-installer.org/en/latest/other-tools.html#easy-install
- 69. Commit history of https://bitbucket.org/pypa/setuptools/
- 71. distribute • Intended to replace Setuptools • Shares the same module names (setuptools and pkg_resources) • Active development https://bitbucket.org/tarek/distribute/overview
- 73. We Need a New Standard!
- 75. http://ziade.org/2010/03/03/the-fate-of-distutils-pycon-summit-packaging-sprint-detailed-report/
- 78. This is what you get when developers fight with each other. Panel: Directions for Packaging, PyCON US 2013
- 82. ./setup.py install must die! Panel: Directions for Packaging, PyCON US 2013
- 83. PyPA’s Schedule • Merge Distribute back to Setuptools (Done) • New binary distribution format (Done) • Built-in Setuptools and pip support in Python • Better security • …And more! The Future of Python Packaging, Python Packaging User Guide
- 85. pip >= 1.4 setuptools >= 0.8 Upgrading notes: http://pythonhosted.org/setuptools/merge-faq.html
- 86. $ python setup.py bdist_wheel upload $ pip install --use-wheel <package> Documentation: docs.python.org/distutils/packageindex.html
- 87. MORE IS BETTER
- 89. Replaces dashes with underscores Platform independent django_mosql-0.2-py27-none-any.whl Implementation not relevant Does not need ABI information
- 90. Description gets its own file!
- 91. Other metadata (similar to PKG-INFO)
- 92. Unchanged
- 93. ???
- 94. Metadata in JSON
- 96. SHA256 for each file in this directory
- 97. What Changed? • The One True Cheese Shop • Forward compatibility • Machine-friendliness • Safety
- 98. Wrapping Up • Python packaging is _____ • How did we get into this mess? • distutils • setuptools • PyPI • A way out
- 99. Wheel is the future. Adapt today!