Référez-vous au tutoriel du livre C'est Django que j'ai écrit
Je vais directement extraire le paragraphe pertinent pour que vous puissiez le voir :
Téléchargez votre propre kit
Nous avons vu et utilisé de nombreux packages écrits par d'autres. Voulez-vous vraiment en écrire un vous-même ? Le contenu précédent de ce chapitre est suffisant pour que tout le monde comprenne comment écrire un package et l'utiliser localement, mais comment partager ce package avec le monde ? Bien sûr, vous devez télécharger le package sur PyPI (de cette façon, tout le monde peut utiliser pip pour télécharger et installer votre package). Cette section a pour but de vous apprendre comment procéder.
Si vous envisagez de télécharger votre propre package, vous devez d'abord vous inscrire sur PyPI pour obtenir un compte et un mot de passe.
Tout d'abord, tout le monde doit savoir que si votre projet Python souhaite non seulement pouvoir importer à partir du dossier actuel ou relatif, mais également pouvoir être installé dans l'environnement Python, vous devez écrire sous le répertoire du projet. Ici, nous devons télécharger sur PyPI pour personnaliser notre setup.py. Vérifions d'abord la structure d'un projet à télécharger et les emplacements de plusieurs fichiers de configuration que nous souhaitons ajouter :
Nous avons remarqué qu'il y avait à l'origine deux packages pkgA et pkgB sous le projet (généralement, nous avons plusieurs packages dans un projet, et nous devons télécharger tous les packages appartient à), qui contiennent plusieurs modules et __init__.py indiquant qu'il s'agit de structures de packages. Ensuite nous aurons un fichier de description README (utilisé pour présenter la structure et l'utilisation du projet, qui ne sera pas abordé en détail ici) et un fichier d'exécution (code du script d'exécution de l'ensemble du projet) coureur .
Ensuite, nous devons ajouter deux fichiers de configuration au projet d'origine, à savoir les fichiers setup.py et .pypirc. Nous présenterons comment utiliser ces fichiers un par un. un.
Voyons d'abord setup.py :
à partir de la configuration de l'importation distutils.core
installation(
nom = 'MonProjet',
packages = ['pkgA', 'pkgB'],
scripts = ['coureur'],
version = '1.0',
description = 'Mon premier projet',
auteur = 'dokelung',
author_email = 'dokelung@gmail.com',
mots-clés = ['Bon projet'],
classificateurs = [],
)
Nous devons importer la fonction setup depuis distutils.core (distutils est un package intégré de Python. Cette fonction nous aidera à l'installer). regardez la signification de chaque paramètre dans cette fonction :
Nom du champ
Description
nom
Nom du projet (même nom que le répertoire du projet)
forfaits
Nom du package à installer
scripts
Le nom du script représente généralement un fichier exécutable, mais pas nécessairement
version
Version
description
Description du projet
auteur
Auteur
auteur_e-mail
Boîte aux lettres de l'auteur
mots clés
Quelques mots-clés pour ce projet
Voici une brève explication des scripts. Ce qui est écrit dans les scripts ici est le fichier d'exécution de l'ensemble du projet. Il a peut-être utilisé le package dans le projet. Afin d'installer ce fichier sur le système de l'utilisateur en même temps, nous devons le marquer, sinon lorsque nous utiliserons pip pour installer plus tard, nous installerons uniquement le package et non le fichier exécutable. Ici, ce qu'on appelle l'installation de fichiers exécutables signifie en fait placer les scripts spécifiés dans un chemin exécutable, tel que /usr/bin/, afin que l'utilisateur puisse l'installer n'importe où après l'installation. (en fait, on peut spécifier le chemin d'installation, mais si on donne seulement le nom du script, il sera placé à l'emplacement par défaut). Une chose à laquelle vous devez faire attention ici est que le nom du script ne doit pas être le même que celui du package à importer. Cela entraînera des erreurs d'importation.
À ce stade, vous disposez déjà d'un magnifique fichier d'installation (qui prend également en charge la version PyPI).
Ensuite, jetons un œil au fichier .pypirc Ce n'est qu'en créant ce fichier de configuration que nous pouvons transférer des éléments vers PyPI :
[distutils]
serveurs d'index =
Pypi
[pypi]
référentiel : https://pypi.python.org/pypi
nom d'utilisateur : (remplissez le numéro de compte ici)
mot de passe : (remplissez le mot de passe ici)
Si vous êtes un utilisateur Windows, veuillez ouvrir le terminal (invite de commande) et définir les variables d'environnement :
set HOME=C:\Users\Owner\
Ensuite, nous ajouterons un sous-répertoire Owner dans le dossier utilisateur du slot C (en fait C:\Users) et mettrons notre Copie .pipyrc code> et placez-le dans le dossier, et le réglage est terminé.
Si vous êtes un utilisateur Linux ou Mac, veuillez également copier .pypirc dans votre répertoire personnel :
$ cp .pypirc ~/.pypirc
Une fois le fichier de configuration ci-dessus prêt, il est temps d'atteindre la dernière étape, inscrivez-vous d'abord :
$ python setup.py registre -r pypi
Télécharger ensuite :
$ python setup.py sdist upload -r pypi
Super, vous avez réussi à rendre votre travail visible dans le monde entier. Accédez à PyPI et jetez un œil à la page de votre package. Enfin, nous avons goûté le fruit sucré, puis avons utilisé pip pour télécharger notre projet (et les packages qu'il contient) et l'installer sur notre ordinateur pour y jeter un œil :
$ pip installe MonProjet
Si les lecteurs utilisent pip pour installer le projet téléchargé sur leur ordinateur, le package sous le projet peut être importé n'importe où sur la machine locale.
Vous pourrez alors dire au monde que vous êtes également un contributeur à Python.
Référez-vous au tutoriel du livre C'est Django que j'ai écrit
Je vais directement extraire le paragraphe pertinent pour que vous puissiez le voir :
Téléchargez votre propre kit
Nous avons vu et utilisé de nombreux packages écrits par d'autres. Voulez-vous vraiment en écrire un vous-même ? Le contenu précédent de ce chapitre est suffisant pour que tout le monde comprenne comment écrire un package et l'utiliser localement, mais comment partager ce package avec le monde ? Bien sûr, vous devez télécharger le package sur PyPI (de cette façon, tout le monde peut utiliser pip pour télécharger et installer votre package). Cette section a pour but de vous apprendre comment procéder.
Tout d'abord, tout le monde doit savoir que si votre projet Python souhaite non seulement pouvoir importer à partir du dossier actuel ou relatif, mais également pouvoir être installé dans l'environnement Python, vous devez écrire
sous le répertoire du projet. Ici, nous devons télécharger sur PyPI pour personnaliser notre setup.py. Vérifions d'abord la structure d'un projet à télécharger et les emplacements de plusieurs fichiers de configuration que nous souhaitons ajouter :
Nous avons remarqué qu'il y avait à l'origine deux packages
pkgA
etpkgB
sous le projet (généralement, nous avons plusieurs packages dans un projet, et nous devons télécharger tous les packages appartient à), qui contiennent plusieurs modules et__init__.py
indiquant qu'il s'agit de structures de packages. Ensuite nous aurons un fichier de descriptionREADME
(utilisé pour présenter la structure et l'utilisation du projet, qui ne sera pas abordé en détail ici) et un fichier d'exécution (code du script d'exécution de l'ensemble du projet) coureur .Ensuite, nous devons ajouter deux fichiers de configuration au projet d'origine, à savoir les fichiers
setup.py
et.pypirc
. Nous présenterons comment utiliser ces fichiers un par un. un.Voyons d'abord
setup.py
:Nous devons importer la fonction
setup
depuisdistutils.core
(distutils est un package intégré de Python. Cette fonction nous aidera à l'installer). regardez la signification de chaque paramètre dans cette fonction :Voici une brève explication des
scripts
. Ce qui est écrit dans les scripts ici est le fichier d'exécution de l'ensemble du projet. Il a peut-être utilisé le package dans le projet. Afin d'installer ce fichier sur le système de l'utilisateur en même temps, nous devons le marquer, sinon lorsque nous utiliserons pip pour installer plus tard, nous installerons uniquement le package et non le fichier exécutable. Ici, ce qu'on appelle l'installation de fichiers exécutables signifie en fait placer les scripts spécifiés dans un chemin exécutable, tel que/usr/bin/
, afin que l'utilisateur puisse l'installer n'importe où après l'installation. (en fait, on peut spécifier le chemin d'installation, mais si on donne seulement le nom du script, il sera placé à l'emplacement par défaut). Une chose à laquelle vous devez faire attention ici est que le nom du script ne doit pas être le même que celui du package à importer. Cela entraînera des erreurs d'importation.À ce stade, vous disposez déjà d'un magnifique fichier d'installation (qui prend également en charge la version PyPI).
Ensuite, jetons un œil au fichier
.pypirc
Ce n'est qu'en créant ce fichier de configuration que nous pouvons transférer des éléments vers PyPI :[distutils] serveurs d'index = Pypi [pypi] référentiel : https://pypi.python.org/pypi nom d'utilisateur : (remplissez le numéro de compte ici) mot de passe : (remplissez le mot de passe ici)
Si vous êtes un utilisateur Windows, veuillez ouvrir le terminal (invite de commande) et définir les variables d'environnement :
Ensuite, nous ajouterons un sous-répertoire
Owner
dans le dossier utilisateur du slot C (en faitC:\Users
) et mettrons notreCopie .pipyrc code> et placez-le dans le dossier, et le réglage est terminé.
Si vous êtes un utilisateur Linux ou Mac, veuillez également copier
.pypirc
dans votre répertoire personnel :Une fois le fichier de configuration ci-dessus prêt, il est temps d'atteindre la dernière étape, inscrivez-vous d'abord :
Télécharger ensuite :
Super, vous avez réussi à rendre votre travail visible dans le monde entier. Accédez à PyPI et jetez un œil à la page de votre package. Enfin, nous avons goûté le fruit sucré, puis avons utilisé
pip
pour télécharger notre projet (et les packages qu'il contient) et l'installer sur notre ordinateur pour y jeter un œil :Vous pourrez alors dire au monde que vous êtes également un contributeur à Python.
Questions auxquelles j'ai répondu : Python-QA