PythonStarterPackage
1.0.0
このプロジェクトの目的は、標準のPythonパッケージをゼロから作成する方法を示すことです。このプロジェクトは、@iamtennisloverによるこの優れたGetMyIPパッケージに触発されています：[https://github.com/iamtennislover/getMyip]と、 @sigma-codingによるpythonパッケージの展開に関するこの素晴らしいガイド：[https://github.com/areed1192/sigma-coding]。
パッケージの展開方法に関するステップバイステップのチュートリアルについては、 doc/ディレクトリのpythonstarterpackage_tutorial.mdを参照してください。このスターターパッケージを初めて使用している場合は、最初にチュートリアルを行うことをお勧めします。
このパッケージは、新しいパッケージを作成するたびにスケルトンとしても使用できます。以下の手順を使用して、パッケージをインストール、テスト、展開します。
以下は、このパッケージのGitHubおよびPypiリソースです。
Windowsの場合、Git Bash端子などのLinuxエミュレーション層でこのアプリを実行することをお勧めします。詳細については、「Git Bashの指示」セクションを参照してください。 Git Bashに加えて、以下に説明するように、Python3とPIP3もあることを確認してください。
MacとLinuxの場合、このアプリはLinuxまたはMac端末の箱から出して作業する必要がありますが、以下に説明するようにPython3とPIP3もあることを確認してください。
要件：
python3 --version 。pip3 --version 。 このアプリをインストールするには、いくつかのオプションがあります。
pip3 install PythonStarterPackage
git clone https://github.com/ArcticTechnology/PythonStarterPackage.git
cd PythonStarterPackage
pip3 install -e .
このアプリをアンインストールするには：
pip3 uninstall PythonStarterPackage
src/ディレクトリにある.egg-infoファイルを削除することもできます。これはpip3 install -e . 。 インストール後、このアプリを実行する方法がいくつかあります。
pythonstarterpackage
python3 -mでこのアプリを実行します： python3 -m pythonstarterpackage
from pythonstarterpackage import *
starter = StarterPkg()
starter.run()
このパッケージを展開するには、最初に、 doc/ディレクトリのpythonstarterpackage_tutorial.mdを使用していることを確認してください。独自のパッケージを実装する方法を十分に理解し、依存関係をマッピングしてパッケージをテストしたと仮定したら、以下を使用してパッケージを展開できます。
パッケージの準備ができたら、パッケージの展開に取り組むことができます。
setuptools 、 wheel 、およびtwine （次の部分ではtwineが使用されます）。 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
上記に問題がある場合は、いつでもパッケージをアンインストールして分布を削除して、問題のトラブルシューティングに進みます。完了したら、最初からやり直します。以下のコマンドを使用すると、分布を削除できます。
rm -rf build dist src/*.egg-info
上記のコマンドを誤解しないように注意してください。
PYPIにアップロードするには、最初にPYPIアカウントを設定してください。詳細については、「Pypi Setup Guide.md」/ in doc/の「Md」を参照してください。また、 twineをインストールしてアップグレードする必要があります。このセットアップをすべて行いたら、次のことを行います。
twineを使用してアップロードします。 twine upload dist/*
pipでパッケージをインストールします。 pip3 install pythonstarterpackage
注：インストールを試みたときにPythonStarterPackageの「既に満たされている要件...」を取得した場合、 pip以前のテストからパッケージを既にインストールしていると考えているためかもしれません。その接続をきれいに破るには、 ./src/PythonStarterPackage.egg-info pythonstarterpackage.egg-infoを削除するだけです。次に、もう一度アンインストールして再インストールしてみてください。
pythonstarterpackageでアプリを実行します。pip3 uninstall pythonstarterpackage 。 このセクションでは、見つかった一般的な問題のいくつかとそれらを解決する方法について説明します。
Linuxでは、アプリを実行しようとするときにcommand not found場合は、 ~/.local/bin/パスに追加する必要がある場合があります。詳細については、このスレッドを参照してください：[https://stackoverflow.com/a/34947489]。 ~/.local/bin/を追加するには、次のことを行います。
export PATH=~/.local/bin:$PATH ~/.bash_profileに追加します。 echo export PATH=~/.local/bin:$PATH > ~/.bash_profile
source ~/.bash_profile
Pythonバージョンにはおそらく、通常はデフォルトになります。詳細については、この投稿を参照してください[https://stackoverflow.com/a/25905642]。次のようにインストールしてください。
sudo apt-get install python3-tk
Macには、これを使用してください。
brew install python-tk
Windowsの場合、Git Bash端子のようなLinuxエミュレーション層でこのアプリを実行することをお勧めします。 Git Bashのインストールとセットアップの指示は次のとおりです。
Version >= 2.34.1
Use bundled OpenSSH - This uses ssh.exe that comes with Git.
bash.exeを開き、python3 https://www.python.org/downloads/をインストールする重要：Windowsには、 git-bash.exeではなくbash.exeターミナルを使用します。 git-bash.exeはimport osでpython osコマンドを台無しにすることに既知の問題があります。詳細については、このスレッドを参照してください：[https://stackoverflow.com/a/33623136]。
bash.exe gitフォルダーは、 bin/ directoryにあります。たとえば、 git-bash.exeここにある場合C:Program FilesGitgit-bash.exeでは、 bash.exeここにC:Program FilesGitbinbash.exeを見つける必要があります。 当社のソフトウェアはオープンソースであり、公開されています。これらのリポジトリのいずれかが有用で、このプロジェクトを財政的にサポートしたい場合は、ビットコインの住所に自由に寄付してください。
ビットコインアドレス1：1GZQY6HMWSZQXCCMBC6UGXKYD5HKPHK1PMF
