Discussion :

[Luke spywoker]

Salut les pythons,

En lisant le how-to de distutils je suis tomber sur une chose que j'aimerai faire:

Uploader un de mes modules sur PyPI, seulement j'ai du mal a comprendre le fonctionnement non pas de l'upload qui est expliquer dans le how-to de distutils mais sur le mécanisme d'installation sur la machine désirant installer mon module une fois le module ou l'URL du module uploader après enregistrement et donc de l'arborescence du fichier zip que je doit fournir.
En faite je ne comprend pas comment le module s'installe automatiquement sur la machine cliente, car normalement je fait exécuter un script d'installation a cet effet a l'utilisateur désireux d'installer mon module.

Si vous avez déjà uploader un module sur PyPI vous seriez sympa de m'expliquer la marche a suivre.

Faut-il construire le zip du module avec distutils car mon module est déjà construit et distribuer sous forme d'archive zip avec un script d'installation, README.txt etc ( mais pas avec distutils ) mais je peut le retravailler.

Merci d'illuminer mon ignorance de part vos réponses éclairées.
Bon python a vous.

[Luke spywoker]

Et bien le sujet a l'air délaisser, j'ai appris que distutils (d'abords n'est pas facile a manier et semble être déprécier) et que la fonction setup nécessite quelques précisions si l'on veut uploader sur PYPi:

# Extrait du HOW-TO distutils commenter par mes soins.

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
 
from distutils.core import setup
 
with open('README.rst') as file:
  long_description = file.read()
 
# README.rst est un fichier ReStructuredText qui est un format de fichier fonctionnant de manière indenter,
# avec une mise en page avec des caractères spéciaux ascii,
# donnant un bon rendu si bien en mode texte que convertie en HTML. 
# Qui est le standart pour la documentation de code python.
# Qui peut être transformer en code HTML (avec rst2html de python-docutils par exemple)
# Mais les possibilités sont quand même limités.
# Dont PYPi ce sert pour formater la page internet descriptive du module uploader.  
 
setup(name='Distutils', 
version='1.0',
description='Python Distribution Utilities',
long_description=long_description,
author='Greg Ward',
author_email='gward@python.net',
url='http://www.python.org/sigs/distutils-sig/', # obligatoire pour PYPi
packages=['distutils', 'distutils.command'],
)

Le ReStructuredText est facile a prendre en main et avec les bon outils:
-retext (Editeur de texte).
-rst2html du paquet python-docutils (conversion en HTML).
Et la documentation.

Par contre je n'arrive pas a générer une archive compatible Linux et Windows a la fois car dans mon fichier setup.py je suis tomber sur un os.

[deusyss]

Bonjour Luke,

Une petite info au passage. Distutils2 est en cours de creation il me semble. Peut etre une meilleure piste?

[Luke spywoker]

J'ai finalement réussi, grâce au HOW-TO de distutils, a créer un paquetage compatible Linux et Windows pour mon module que vous connaissez peut-être déjà: curser, la tortue de pygame, qui est dorénavant disponible depuis PyPI.

J'ai profiter de cette plonger dans le cœurs de la fonction distutils.core.setup() qui a elle seule suffit a beaucoup de besoin de packaging, pour écrire un tutoriel sur le sujet:

Uploader un module compatible Linux et Windows sur PyPI (Python Package Index) grâce au module distutils.


Excusez la mise en page mais le vieux script cgi de mon site ne traite pas les blanc en début de ligne et j'ai oublier de mettre les liens de mes sources. Vous pouvez laisser un commentaire ou une critique ici ça me ferai plaisirs.

Voici les liens de mes donc sources:

-HOW-TO de distutils.

-Fonction distutils.core.setup().

-Documentation sur le langage ReStructuredText.

-Tutoriel Francophone pour débuter avec le langage ReStructuredText.

PS: Le format *.rst est très utile dans ce cas: La page de présentation de mon module est identique a celle que j'ai développer grâce aux outils décrit dan mon tutoriel.