Jak zveřejnit knihovnu

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/