Packaging pratique (fr) - pycon.fr 2014

Présentation général du packaging Python

Transcript

1. packaging xavier ordoquy
2. @linovia_net
3. Changer une miriade de scripts
4. en un système contrôlé.
5. Distribution: Une « distribution » Python est un fichier d’archive versionné qui contient des paquets Python, des modules et d’autres fichiers de ressources qui sont utilisés pour distribuer une « Release ». Ce fichier de distribution est ce qu’un utilisateur final téléchargera d’Internet et installera.
6. Par la suite: packaging == distribution
7. exemple : pip install sentry[postgres]
8. Packaging Python : pourquoi ?
9. multi plateformes
10. Packaging Python : comment ?
11. 3 outils + du code !!
12. virtualenv pyenv
13. Isoler le projet du reste
14. y compris avec docker, lxc, vagrant…
15. gain: fin des conflits
16. dépôt pypi
17. dépôt ‘officiel’ pypi.python.org
18. dépôt privé devpi
19. gain: distribution simple
20. pip
21. pip install -e
22. pip freeze (-l)
23. requirements: pip install -r
24. gain: gestion des dépendances
25. setup.py
26. use setuptools
27. recopiez !!
28. versions: PEP440 1.2.4.dev3557 1.2.4a1 1.2.4b1 1.2.4c1 == 1.2.4rc1 1.2.4 1.2.4.post1
29. images, css..: MANIFEST.in
30. gain: application web
31. executables : entry_points
32. gain : aucun chemin en dur
33. requirements : extra_requires
34. exemple : pip install sentry[postgres] pip install -e .[tests,dev]
35. gain: uniformisation des méthodes
36. Bonus: wheel
37. gain: temps
38. Bonus 2: stevedore
39. Bonus 3: du code !
40. setup( name='project', version='0.1.3a4', description='Some description', long_description=open('README.rst').read(), author='Xavier Ordoquy', author_email='xordoquy@linovia.com', url='http://github.com/xx/yy', packages=find_packages(exclude=[‘tests']), zip_safe=False, include_package_data=True, classifiers=[ 'Framework :: Django', ] ) exemple:
41. setup( … install_requires=install_requires, extras_require={ 'tests': tests_require, 'dev': dev_requires, 'postgres': install_requires + pg_requires, } ) exemple:
42. setup( … entry_points={ 'console_scripts': [ 'sentry = sentry.utils.runner:main', ], }, ) exemple:
43. class PyTest(TestCommand): def finalize_options(self): TestCommand.finalize_options(self) self.test_args = ['tests'] self.test_suite = True def run_tests(self): import pytest errno = pytest.main(self.test_args) sys.exit(errno) setup( … cmdclass={'test': PyTest}, ) exemple:
44. Présentation http://bit.ly/1skB3K4 Python Packaging User Guide http://bit.ly/1ww8Nbz setup.py Sentry http://bit.ly/1FMMCnG
45. Merci