deployer_app.TXT 2.1 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465
  1. Pour deployer une application python:
  2. http://sametmax.com/creer-un-setup-py-et-mettre-sa-bibliotheque-python-en-ligne-sur-pypi/
  3. 1- Créer sa lib (ici: "lib_exemple")
  4. 2- la mettre dans un dossier portant le même nom:
  5. - lib_exemple
  6. - MANIFEST.in [un fichier texte qui liste les fichiers non Python qu’on inclura dans l’installation]
  7. - README.md [un fichier markdown contiendra une présentation du package]
  8. - setup.py
  9. - lib_exemple
  10. - main.py
  11. - core
  12. - ui
  13. ...Etc
  14. 3- pour l'installeur, on devrait utiliser distutils ou setuptools (plus complet, gère les dépendances)
  15. 4- rendre notre paquet plus facile à utiliser
  16. - en documentant: on décrit le package dans __init__, le module dans l'en-tête du fichier, puis chaque fonction
  17. - en faisant les differents imports depuis le __init__ principal, de manière à ce que l'utilisateur puisse faire
  18. import lib_exemple.calcul plutôt que lib_exemple.core.calcul
  19. - en creant une variable __all__ = ['calcul'] pour limiter les fonctions importables avec *
  20. - en ajoutant une version:
  21. __version__ = "0.0.1"
  22. 5 - dans le readme:
  23. - A quoi sert la lib.
  24. - Comment l’installer.
  25. - Un exempe concret d’utilisation.
  26. - La licence d’utilisation.
  27. - Un lien vers la doc si elle existe
  28. au format markdown:
  29. https://daringfireball.net/projects/markdown/basics
  30. 6 - dans le manifest, ajouter des include et recursive-include pour ajouter les fichiers non python
  31. 7- creer le setup.py (cf PJ)
  32. 8- dans le dossier principal, executer:
  33. python setup.py install
  34. 9- si la lib s'est bien installée, on doit pouvoir faire avec la console python:
  35. > from lib_exemple import fonction_test
  36. > fonction_test()
  37. et avec l'invite de commande si on a créé des commandes dans le setup
  38. 10- pour enregistrer sur Pypi (et rendre la lib installable avec pip):
  39. python setup.py register
  40. - choisir option 2 la première fois et créer son compte, puis choisir 1 ensuite
  41. le but est d'obtenir ceci:
  42. Registering lib_exemple to http://pypi.python.org/pypi
  43. Server response (200): OK
  44. puis executer:
  45. python setup.py sdist upload
  46. 11- par la suite, pour uploader à nouveau, le numero de version doit être modifié