Download as PDF, PPTX
![@audreyr
@pydanny
class cached_property(object):
"""
A property that is only computed once per instance and then replaces itself
with an ordinary attribute. Deleting the attribute resets the property.
Source: https://github.com/bottlepy/bottle/commit/fa7733e075da0d790d809aa3d2f5
""" # noqa
def __init__(self, func):
self.__doc__ = getattr(func, '__doc__')
self.func = func
def __get__(self, obj, cls):
if obj is None:
return self
value = obj.__dict__[self.func.__name__] = self.func(obj)
return value
Started at 9 lines of code
Now has 131 lines of code
Story of cached-property](https://image.slidesharecdn.com/pyconsg-foss-160623035104/85/How-to-Write-a-Popular-Python-Library-by-Accident-34-320.jpg)
Uploaded byDaniel Greenfeld
How to Write a Popular Python Library by Accident
Daniel and Audrey Roy Greenfeld discuss the process of creating popular Python libraries, emphasizing that anyone can contribute to open source projects. They outline a straightforward approach to packaging with practical steps and share success stories, including their own projects like django-uni-form and cookiecutter. The overarching message is to identify small problems, build what you need, and share your work with the community.
More Related Content
![Django apps and ORM Beyond the basics [Meetup hosted by Prodeers.com]](https://cdn.slidesharecdn.com/ss_thumbnails/djangoapps-160606094750-thumbnail.jpg?width=640&height=640&fit=bounds)
Similar to How to Write a Popular Python Library by Accident
How to Write a Popular Python Library by Accident
- 1. How to Writea Popular Python Library by Accident Daniel Roy Greenfeld Audrey Roy Greenfeld Thursday Keynote Speech June 23, 2016
- 2. How to Writea Popular Python Library by Accident Daniel Roy Greenfeld Audrey Roy Greenfeld Thursday Keynote Speech June 23, 2016
- 3. @audreyr @pydanny About Us Daniel RoyGreenfeld Audrey Roy Greenfeld Met at PyCon US 2010 Married December 2013 Open Source Developers Engineer & Principal, Cartwheel Web Engineer & Principal, Cartwheel Web
- 4. @audreyr @pydanny You Might KnowOur Open Source Work
- 5. @audreyr @pydanny So Much OpenSource Work?! Why? Portfolio Solves problems Community Responsibility
- 6. @audreyr @pydanny So Much OpenSource Work?! Why? Biggest Reason: It’s Gratifying
- 7. @audreyr @pydanny Python Package Index FindOpen SourcePython packages
- 8. @audreyr @pydanny Python Package Index Whois familiar with PyPI?
- 9. @audreyr @pydanny Python Package Index Whohere has released a package on PyPI? Raise your hand.
- 10. @audreyr @pydanny Everyone here shouldrelease a package on PyPI. Python Package Index
- 11. @audreyr @pydanny package I don’t know howto do it I’m not creative enough I don’t have enough experience I’m not a visionaryNonsense! But Isn’t Releasing Packages Hard?
- 12. @audreyr @pydanny The Big SecretAbout Open Source Packages
- 13. @audreyr @pydanny The Big Secret Creatorsof Packages aren’t special visionaries are
- 14.
- 15.
- 16.
- 17. @audreyr @pydanny A Single Function The BigSecret Installable Package
- 18. @audreyr @pydanny Secret Package Recipe#1 Step 1: Pick a Function Step 2: Get the Boilerplate Step 3: Add Function to Boilerplate
- 19. @audreyr @pydanny Secret Package Recipe#2 Step 1: Pick a Class Step 2: Get the Boilerplate Step 3: Add Class to Boilerplate
- 20. @audreyr @pydanny Cookiecutter Packagesmakes packaging trivial BoilerplateToolfor generating boilerplate for Python packages (and other projects)
- 21.
- 22. @audreyr @pydanny Cookiecutter Packagesmakes packaging trivial BoilerplateToolfor generating boilerplate for Python packages (and other projects)
- 23. @audreyr @pydanny packagesSmall But UsefulPackages binaryornot cached-property
- 24.
- 25.
- 26. @audreyr @pydanny project often grow from simpleprojects sComplex Project
- 27.
- 28.
- 29.
- 30. @audreyr @pydanny 😀 Community Don’t worry ifthe community follows 😮
- 31. @audreyr @pydanny 😮 Focus on yourneeds 😀 Focus on your story
- 32.
- 33. @audreyr @pydanny Story of cached-property 4Class Package Caches object properties
- 34. @audreyr @pydanny class cached_property(object): """ A propertythat is only computed once per instance and then replaces itself with an ordinary attribute. Deleting the attribute resets the property. Source: https://github.com/bottlepy/bottle/commit/fa7733e075da0d790d809aa3d2f5 """ # noqa def __init__(self, func): self.__doc__ = getattr(func, '__doc__') self.func = func def __get__(self, obj, cls): if obj is None: return self value = obj.__dict__[self.func.__name__] = self.func(obj) return value Started at 9 lines of code Now has 131 lines of code Story of cached-property
- 35.
- 36. @audreyr @pydanny Story of cached-property Younever know who will use your library :)
- 37.
- 38.
- 39.
- 40.
- 41.
- 42.
- 43. @audreyr @pydanny django-uni-form • Danny startedhis first professional Django project. • US Government projects must be Section 508. 2009 • Django is not Section 508!
- 44. @audreyr @pydanny What is Section508? •Color-blind •Blind
- 45. @audreyr @pydanny “Forms must bedefined not in tables, but in divs” Rule
- 46. @audreyr @pydanny Uh-oh… • Project had80 forms. • How do we convert 80 formsfrom tables to divs… • …without going crazy?
- 47. @audreyr @pydanny Reuse the Code!#uni_form/templatetags/uni_form_tags.py from django import template register = template.Library() from django.utils.safestring import mark_safe @register.filter def as_uni_form(form): text = '' for field in form: text = """ <div class="ctrlHolder"> %s %s : %s </div> """ % (field.errors, field.label_tag(), field) return mark_safe(text) https://github.com/pydanny/django-uni-form/commit/e0f02cb9120f794a17bec297f0b1778f066a9168
- 48.
- 49.
- 50. @audreyr @pydanny Growing the API Added entireHTML form generation via Python
- 51. @audreyr @pydanny Growing the API Added HTMLform button controls
- 52. @audreyr @pydanny Growing the API FancierHTML Control and Layout Widgets Project grew and grew…
- 53. @audreyr @pydanny Project Sometimes you leave aproject django-uni-form
- 54.
- 55.
- 56. @audreyr @pydanny Django Packages Django Dash2010 djangopackages.com
- 57. @audreyr @pydanny Django Packages Django Dash2010 djangopackages.com
- 58. @audreyr @pydanny “Automatic Birthday Greetings forFacebook!” Django Dash 2010 We were too lazy to learn the Facebook API Idea #1:
- 59. @audreyr @pydanny Django Dash 2010 Idea#2: “What about making comparison grids for for Django packages?”
- 60.
- 61. @audreyr @pydanny Stretch Goals • Anyonecould Add Packages • Anyone can Add Packages to Grids • Fetch data from GitHub and PyPI Django Dash 2010
- 62. @audreyr @pydanny Django Dash 2010 :) Thoughts Builtover a weekend contest Django Packages was a need Focus on your needs.
- 63. @audreyr @pydanny Stories django-uni-form / django-crispy-forms DjangoPackages Cookiecutter Matplotlib requests
- 64. @audreyr @pydanny urllib + urllib2doesn’t meet your needs? Use requests
- 65. @audreyr @pydanny requests Winter 2011 Kenneth’s problem: urlliband urllib2 are hard to use
- 66.
- 67. @audreyr @pydanny Stories django-uni-form / django-crispy-forms DjangoPackages requests Cookiecutter Matplotlib
- 68. @audreyr @pydanny Cookiecutter Summer 2013 Audrey’s experiment: Createas many new packages as I can, just for fun
- 69. @audreyr @pydanny Summer 2013 Cookiecutter packages Got tiredquickly of copy/pasting boilerplate from package to package
- 70. @audreyr @pydanny Great contributing instructions tests! Python module Travis-CI PyPIboilerplate More PyPI boilerplate boilerplate Cookiecutter
- 71. @audreyr @pydanny Cookiecutter I had justd a static site generator called “complexity” create
- 72. @audreyr @pydanny Cookiecutter What if Iused similar concepts to create a project template renderer?
- 73.
- 74. @audreyr @pydanny After first release, thepull requests began Cookiecutter
- 75.
- 76.
- 77. @audreyr @pydanny Cookiecutter Danny needed an imagefor his blog post.
- 78. @audreyr @pydanny Danny needed an imagefor his blog post.
- 79.
- 80.
- 81. @audreyr @pydanny Great contributing instructions tests Python module Travis-CI PyPIboilerplate More PyPI boilerplate
- 82. @audreyr @pydanny Now anyone can createand submit packages to PyPI in minutes!
- 83. @audreyr @pydanny Are there toomany PyPI packages? “I hate how there are too many packages. I can’t find what I need.” — grumpy coder — beginner
- 84. @audreyr @pydanny The grumpy coder: Doesn’tknow how to search intelligently “Grr, there are too many websites. I miss the old WWW before Google.”
- 85. @audreyr @pydanny The grumpy coder: Doesn’tread Python blogs or books
- 86. @audreyr @pydanny The grumpy coder: Doesn’tattend Python user groups to help find great tools
- 87.
- 88. @audreyr @pydanny The more packagesthat exist, the better Always Remember:
- 89. @audreyr @pydanny More packages means adiversity of selection
- 90. @audreyr @pydanny Different viewpoints on thesame problem
- 91. @audreyr @pydanny • Flask • Pyramid •Tornado • Bottle • Web2py • cherrypy • web.py • Falcon • Bluebreem • Turbogears • Google App Engine • Or write your own! Django doesn’t meet your needs? Use another web framework
- 92. @audreyr @pydanny youDjango doesn’t meetyour needs? Use another web framework • Flask • Pyramid • Tornado • Bottle • Web2py • cherrypy • web.py • Falcon • Bluebreem • Turbogears • Google App Engine • Or write your own! (Bold items were written as Django alternatives)
- 93. @audreyr @pydanny Python shell notquite what you want? Started as a 259-line experiment by Fernando Perez Now 180K+ LOC
- 94. @audreyr @pydanny you More Packages More Options MoreTools http://pixabay.com/en/carrots-variety-vegetables-76653/ your contribution
- 95. @audreyr @pydanny More is Good Thanto be limitedby options that don’t meet your needs Better to write a new library
- 96. @audreyr @pydanny Stories django-uni-form / django-crispy-forms DjangoPackages Requests Cookiecutter Matplotlib
- 97.
- 98. @audreyr @pydanny John Hunter (1968-2012) •Matplotlib was his brainchild • His work benefits our species • http://numfocus.org/news/2012/08/28/johnhunter/
- 99. @audreyr @pydanny Matplotlib • Created in2002 to solve a major problem: • Epilepsy causes seizures • Some children don’t respond to the medications. They need brain surgery by John Hunter Story told to us by Fernando Perez of IPython/Jupyter, John’s close friend and collaborator.
- 100. @audreyr @pydanny brain surgery Treatment: Open Brain, AnalyzeSeizure Data, Surgery Problem: Expensive, Limiting Analysis Tool Matplotlib
- 101. @audreyr @pydanny Problem: Expensive, Limiting AnalysisTool Matplotlib
- 102.
- 103.
- 104.
- 105. @audreyr @pydanny 3-d inferred locationof seizure focus, together with active electrodes. Matplotlib
- 106. @audreyr @pydanny Matplotlib The birth of •John Hunter originally offered his plotting code to Fernando Perez as a patch (contribution) to IPython • Fernando Perez liked it but had to focus on finishing his grad thesis • John turned that code into matplotlib
- 107. @audreyr @pydanny Stories django-uni-form / django-crispy-forms DjangoPackages Requests Cookiecutter Matplotlib
- 108. @audreyr @pydanny You never knowwhat project will grow from a small piece of FOSS code
- 109. @audreyr @pydanny project • They areminor fixes or enhancements • They fit the project’s needs/goals Contribute changes to existing projects if:
- 110. @audreyr @pydanny Start a newproject if: • No other project does what you need • You’ve tried the other options already • You feel that it will give you: • Less resistance • More freedom to do what you want
- 111. @audreyr @pydanny Anyone can… Create and releasea package on PyPI
- 112. @audreyr @pydanny All you have todo is JUST DO IT!
- 113. @audreyr @pydanny Daniel Roy GreenfeldAudrey Roy Greenfeld Engineer & Principal, Cartwheel Web Engineer & Principal, Cartwheel Web Met at PyCon US 2010 Married December 2013 Open Source Developers
- 114. @audreyr @pydanny Daniel Roy GreenfeldAudrey Roy Greenfeld Engineer & Principal, Cartwheel Web Engineer & Principal, Cartwheel Web