Jak zveřejnit knihovnu

Jak dostat open-source do světa. Přednáška pro říjnové PyVo 2012.

Transcript

1. Jak zveřejnit knihovnu Petr Viktorin encukou@gmail.com PyVo, 2012-10-25
2. Licence BSD? MIT? GPL?
3. Git & Github
4. Git & Github nebo jinde?
5. Struktura projektu LICENSE
6. Struktura projektu LICENSE README
7. Struktura projektu LICENSE README CHANGELOG
8. Struktura projektu LICENSE README CHANGELOG setup.py
9. Struktura projektu LICENSE README CHANGELOG setup.py mojeknihovna / __init__.py
10. Struktura projektu LICENSE README CHANGELOG setup.py mojeknihovna / __init__.py tests /
11. Struktura projektu LICENSE README CHANGELOG setup.py mojeknihovna / __init__.py tests / doc /
12. Struktura projektu LICENSE README CHANGELOG setup.py mojeknihovna / __init__.py tests / doc / bin /
13. setup.py from setuptools import setup , find_packages setup ( name= ' Moje knihovna ' , version= ' 0.0.1 ' , author= ' Já První ' , author_email= ' ja@example .com ' , scripts =[ ' bin / necodelej ' ] , url = ' http : / / github .com/ ja / mojeknihovna / ' , license = 'MIT ' , description = ' Moje první knihovna . ' , install_requires =[ " docopt >= 0.5.0 " , ] , packages=find_packages ( ) , long_description=open ( 'README ' ) . read ( ) , c l a s s i f i e r s =[... ] , )
14. Trove Classifiers http://pypi.python.org/pypi?: action=list_classifiers Natural Language :: Czech License :: OSI Approved :: MIT License Programming Language :: Python :: 3
15. Nestačí? http://packages.python.org/ distribute/setuptools.html
16. Na PyPI s tím! http://pypi.python.org/pypi $ python setup.py sdist $ python setup.py register $ python setup.py upload
17. A je to! pip install mojeknihovna
18. Verzování 0.3.7
19. Verzování 0.3.7
20. Verzování 0.3.7
21. Dokumentace Sphinx readthedocs.org
22. Propagace
23. Propagace Blogy
24. Propagace Blogy Twittery
25. Propagace Blogy Twittery Géplusy
26. Propagace Blogy Twittery Géplusy Xichtobichle
27. Propagace Blogy Twittery Géplusy Xichtobichle Přednášky
28. Propagace Blogy Twittery Géplusy Xichtobichle Přednášky Workshopy
29. Propagace Blogy Twittery Géplusy Xichtobichle Přednášky Workshopy ...
30. ? Petr Viktorin @encukou encukou@gmail.com github.com/encukou Licence slajdů & videa: Creative Commons Attribution-ShareAlike 3.0 http://creativecommons.org/licenses/by-sa/3.0/
31. Zdroje & odkazy http://as.ynchrono.us/2007/12/ filesystem-structure-of-python-project_21.html http://packages.python.org/distribute/setuptools.html http://guide.python-distribute.org/creation.html http://pypi.python.org/pypi http://semver.org/ http://sphinx.pocoo.org/ https://readthedocs.org/