PythonStarterPackage
1.0.0
Le but de ce projet est de vous montrer comment créer un package Python standard à partir de zéro. Ce projet est inspiré par cet excellent package GetMyip de @iamtennislover: [https://github.com/iamtennislover/getmyip] et ce grand guide sur le déploiement de packages Python par @ sigma coding: [https://github.com/areed1192/sigma coding].
Voir pythonstarterpackage_tutorial.md dans le répertoire doc/ pour un tutoriel étape par étape sur la façon de déployer un package. Si vous utilisez ce package de démarrage pour la première fois, je recommande vraiment de faire le tutoriel d'abord.
Ce package peut également être utilisé comme squelette pour chaque fois que vous créez un nouveau package. Utilisez les instructions ci-dessous Installer, tester et déployer le package.
Vous trouverez ci-dessous les ressources GitHub et PYPI pour ce package.
Pour Windows, il est recommandé d'exécuter cette application sur une couche d'émulation Linux telle que le terminal Git Bash. Voir la section "Instructions pour Git Bash" pour plus de détails. En plus de Git Bash, assurez-vous que vous disposez également de Python3 et Pip3 comme décrit ci-dessous.
Pour Mac et Linux, cette application doit fonctionner hors de la boîte sur le terminal Linux ou Mac, mais assurez-vous que vous disposez également de Python3 et Pip3 comme décrit ci-dessous.
Exigences:
python3 --version .pip3 --version . Il existe quelques options pour installer cette application:
pip3 install PythonStarterPackage
git clone https://github.com/ArcticTechnology/PythonStarterPackage.git
cd PythonStarterPackage
pip3 install -e .
Pour désinstaller cette application:
pip3 uninstall PythonStarterPackage
.egg-info situé dans le répertoire src/ du package. Cela est créé automatiquement avec pip3 install -e . . Après l'installation, vous avez plusieurs façons d'exécuter cette application.
pythonstarterpackage
python3 -m : python3 -m pythonstarterpackage
from pythonstarterpackage import *
starter = StarterPkg()
starter.run()
Pour déployer ce package, assurez-vous d'abord de passer par le Pythonstarterpackage_tutorial.md dans le répertoire doc/ . Une fois que vous avez une bonne compréhension de la façon de mettre en œuvre votre propre package et de supposer que vous avez des dépendances mappées et testé le package, vous pouvez utiliser ce qui suit pour déployer votre package.
Une fois le package prêt, nous pouvons travailler sur le déploiement du package.
setuptools , wheel et twine ( twine sera utilisée dans la partie suivante). pip3 install --upgrade setuptools wheel twine
setup.py . python3 setup.py sdist bdist_wheel
unzip -l dist/*.whl && tar --list -f dist/*.tar.gz
pip3 install .
pythonstarterpackage
pip3 uninstall pythonstarterpackage
S'il y a des problèmes dans ce qui précède, vous pouvez toujours désinstaller le package et supprimer les distributions, procédez à dépanner le problème. Une fois terminé, commencez depuis le début. Les commandes ci-dessous vous permettent de supprimer les distributions.
rm -rf build dist src/*.egg-info
Faites attention à ne pas me faire mal à la commande ci-dessus, comme si vous supprimez quelque chose que vous n'aviez pas l'intention que vous ne pourriez pas le récupérer.
Afin de télécharger sur PYPI, assurez-vous de configurer d'abord votre compte PYPI. Voir "PYPI Configuration Guide.md" dans doc/ pour plus de détails. Vous devrez également faire installer et améliorer twine . Une fois que vous avez toute cette configuration, faites ce qui suit:
twine . twine upload dist/*
pip . pip3 install pythonstarterpackage
Remarque: Si vous obtenez une "exigences déjà satisfaite ..." pour PythonStarterpackage lorsque vous essayez d'installer, cela peut être parce que pip pense toujours que le package a déjà installé le test plus tôt. Pour briser proprement cette connexion, supprimez simplement le ./src/PythonStarterPackage.egg-info . Ensuite, essayez de désinstaller et de réinstaller à nouveau.
pythonstarterpackage .pip3 uninstall pythonstarterpackage . Cette section passe en revue certains des problèmes communs trouvés et comment les résoudre.
Sur Linux, si vous obtenez une erreur command not found lorsque vous essayez d'exécuter l'application, vous devrez peut-être ajouter ~/.local/bin/ vers le chemin. Voir ce fil pour plus de détails: [https://stackoverflow.com/a/34947489]. Pour ajouter ~/.local/bin/ pour le chemin, faites ce qui suit:
export PATH=~/.local/bin:$PATH vers ~/.bash_profile . echo export PATH=~/.local/bin:$PATH > ~/.bash_profile
source ~/.bash_profile
Votre version Python manque probablement de Tkinter qui vient généralement par défaut. Voir cet article pour plus de détails [https://stackoverflow.com/a/25905642]. Installez-le avec ce qui suit:
sudo apt-get install python3-tk
Pour Mac, utilisez ceci:
brew install python-tk
Pour Windows, il est recommandé d'exécuter cette application sur une couche d'émulation Linux comme le terminal Git Bash. Voici les instructions pour installer et configurer Git Bash:
Version >= 2.34.1
Use bundled OpenSSH - This uses ssh.exe that comes with Git.
bash.exe et installer python3 https://www.python.org/downloads/ IMPORTANT: Pour Windows, utilisez le terminal bash.exe plutôt git-bash.exe . Il y a un problème connu avec git-bash.exe gâcher les commandes Python os dans import os . Voir ce fil pour plus de détails: [https://stackoverflow.com/a/33623136].
bash.exe Git dans le bin/ répertoire. Par exemple: si git-bash.exe est ici C:Program FilesGitgit-bash.exe , vous devriez trouver bash.exe ici C:Program FilesGitbinbash.exe . Notre logiciel est open source et gratuit pour un usage public. Si vous trouviez l'un de ces dépôts utile et que vous souhaitez soutenir ce projet financièrement, n'hésitez pas à faire un don à notre adresse Bitcoin.
Bitcoin Adresse 1: 1GZQY6HMWSZQXCMBC6UGXKYD5HKPHK1PMF
