![setup(
name='my_first_package',
version=my_first_package.__version__,
author='Matt Davidson',
tests_require=['pytest'],
install_requires=['requests==2.7.0',
'docopt==0.6.2'
],
cmdclass={'test': PyTest},
author_email='matt@mattjdavidson.co.uk',
description='A dummy package used for presentations',
long_description=long_description,
packages=['my_first_package'],
include_package_data=True,
platforms='any',](https://image.slidesharecdn.com/pythontalksdeliveringapythonproject-150527234727-lva1-app6891/85/How-to-deliver-a-Python-project-3-320.jpg)
.](https://image.slidesharecdn.com/pythontalksdeliveringapythonproject-150527234727-lva1-app6891/85/How-to-deliver-a-Python-project-4-320.jpg)
How to deliver a Python project
- 1. matt_davidson@python_talks ~/ $ delivering a python project
- 3. setup( name='my_first_package', version=my_first_package.__version__, author='Matt Davidson', tests_require=['pytest'], install_requires=['requests==2.7.0', 'docopt==0.6.2' ], cmdclass={'test': PyTest}, author_email='[email protected]', description='A dummy package used for presentations', long_description=long_description, packages=['my_first_package'], include_package_data=True, platforms='any',
- 4. my_first_package ======= Documentation ------------- Available in docs directory of the project, hopefully hosted somewhere else too! ### Installation `pip install my_first_package` ## Contact Me Questions or comments about `my first package`? Hit me up at [[email protected]](mailto:[email protected]).
- 6. """ my_first_package is a dummy package used for presentations """ __version__ = '0.0.1'
- 7. |- README.md |- requirements.txt |- setup.py |- docs | |-- my_first_module.rst |- my_first_package | |-- __init__.py | |-- my_first_module.py |- tests | |-- test_my_first_module.py
- 8. • Create projects using templates • Windows, Mac, Linux • Python, Javascript, Ruby etc. https://github.com/audreyr/cookiecutter
- 9. • Readability > Verbosity • Generate from docstrings • Use a tool!
- 10. def complex(real=0.0, imag=0.0): """Form a complex number. If necessary you can include a much longer multi line explanation here if the single line explanation is not sufficient. Keyword arguments: real -- the real part (default 0.0) imag -- the imaginary part (default 0.0) """ if imag == 0.0 and real == 0.0: return complex_zero ...
- 11. • http://sphinx-doc.org/ • http://fitzgen.github.io/pycco/ • http://www.mkdocs.org/
- 12. • Manage throughout development lifecycle • Dependency’s dependencies matt@workstation ~/code $ pip freeze > requirements.txt
- 13. • PyPA recommended install tool • Easy to use with PyPI (mirrors), wheels • Easy requirements gathering • 2.7.9+ 3.4+ included
- 14. matt@workstation ~/code $ pip install my_first_package matt@workstation ~/code $ pip install /path/to/dir matt@workstation ~/code $ pip install -e /path/to/dir matt@workstation ~/code $ pip install -r requirements.txt matt@workstation ~/code $ pip uninstall ... matt@workstation ~/code $ pip install --no-index --find-links /path/to/dependencies my_first_package
- 15. • A zip archive • Requires setup.py and PEP 376 files • Wheel > egg (dependencies)
- 16. matt@workstation ~/code $ python setup.py bdist_wheel matt@workstation ~/code $ pip install wheel matt@workstation ~/code $ pip --wheel-dir /path/to/dir my_first_package matt@workstation ~/code $ pip install --no-index --find-links /path/to/dir my_first_package
- 17. • Organise your code • Run your tests • Generate your documents • Build your wheels • Distribute your wheels • Share your code
- 18. matt@workstation ~/code $ python setup.py test matt@workstation ~/code $ sphinx/pycco ... matt@workstation ~/code $ pip wheel --wheel-dir /path/to/dir my_first_package matt@workstation ~/code $ git bundle create repo.bundle --all matt@workstation ~/code $ pip install --no-index --find-links /path/to/dir my_first_package
- 19. • Development Tools and Virtualenvs • Unit Testing and Docker • Python 2 vs Python 3 & “future” proofing • Intermediate Python • Pythonic Code
- 20. • https://www.python.org/dev/peps • http://www.jeffknupp.com/blog/ • http://docs.python-guide.org/en/latest/