From 007b3f338a0f6786f600a9e480eedff9e851e7ba Mon Sep 17 00:00:00 2001
From: Bryan C Guner <bryan.guner@gmail.com>
Date: Tue, 14 Jun 2022 10:01:14 -0400
Subject: [PATCH] =?UTF-8?q?Create=20Blog=20=E2=80=9Cpython-setup-guide?=
 =?UTF-8?q?=E2=80=9D?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/pages/blog/python-setup-guide.md | 104 +++++++++++++++++++++++++++
 1 file changed, 104 insertions(+)
 create mode 100644 src/pages/blog/python-setup-guide.md

diff --git a/src/pages/blog/python-setup-guide.md b/src/pages/blog/python-setup-guide.md
new file mode 100644
index 0000000000..8ee9986a36
--- /dev/null
+++ b/src/pages/blog/python-setup-guide.md
@@ -0,0 +1,104 @@
+---
+title: Python Setup Guide
+template: post
+subtitle: After installation check whether binary folder was added to environment PATH
+excerpt: After installation check whether binary folder was added to environment PATH
+date: 2022-06-14T13:57:31.678Z
+image: https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTWmxaBtO4d1a-OrkqfGVKFoAOVWDKwvb4IQA&usqp=CAU
+thumb_image: https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTWmxaBtO4d1a-OrkqfGVKFoAOVWDKwvb4IQA&usqp=CAU
+image_position: top
+author: src/data/authors/webdevhub.yaml
+categories:
+  - src/data/categories/py.yaml
+tags:
+  - src/data/tags/python.yaml
+show_author_bio: true
+related_posts:
+  - src/pages/blog/data-types.md
+  - src/pages/blog/beginners-guide-to-python.md
+cmseditable: true
+---
+Python setup guide
+---
+
+
+1. Download latest python from https://www.python.org/downloads
+After installation check whether binary folder was added to environment PATH variable (user's or system)
+
+2. To ensure installation went sucessfully run following commands:
+
+    ```python --version```
+    ```pip --version ```
+    ```python -m ensurepip --default-pip```
+    
+    More info is [here](https://packaging.python.org/tutorials/installing-packages/#requirements-for-installing-packages).
+
+3. Setup [Wheel](https://github.com/pypa/wheel) tool:
+
+    ```python -m pip install --upgrade pip setuptools wheel```
+
+4. Building and deploying packages [guide](https://packaging.python.org/guides/distributing-packages-using-setuptools)
+
+    4.1. Clear **dist** folder content.
+    
+    4.2. Build package. Run 
+    ```python setup.py sdist bdist_wheel```
+    command in folder with setup.py file
+
+5. Setup [Twin](https://twine.readthedocs.io/en/latest) tool for uploading packages to test.pypi
+
+   ```python -m pip install --user --upgrade twine```
+   
+   NOTE: Twine won't be added automatically to PATH environment variable. You should add it manually
+**C:\Users\\*UserName*\AppData\Roaming\Python\Python37\Scripts**
+
+6. Install [KeyRing](https://github.com/jaraco/keyring) tool
+
+   ```pip install --user keyring```
+
+7. Create keyring. This command will ask for credentials for the first time.
+
+   ```keyring set https://test.pypi.org/legacy/pypi_username```
+   
+   or
+   
+   ```python -m keyring set https://test.pypi.org/legacy/pypi_username```
+   
+8. Create environment variables
+
+Goto **System Properties** -> **Environment variables** -> **User variables** and add
+
+    | Variable name  | Value |
+    | ------------- | ------------- |
+    | TWINE_USERNAME  | *pypi_username*  |
+    | TWINE_PASSWORD  | *pypi_password*  |
+
+9. Upload package to test
+```twine upload --repository-url https://test.pypi.org/legacy/ -u pypi_username dist/*```
+Probably you will need restart PowerShell or run command one more time before it will not ask for password next time
+
+Additional information
+---
+There're more options for packages upload:
+
+1. ```twine upload --repository-url https://test.pypi.org/ -u pypi_username -p pypi_password dist/*```
+2. ```twine upload --repository-url https://test.pypi.org/legacy/ dist/*```
+3. ```twine upload --repository-url https://test.pypi.org/legacy/ --username pypi_username  --password pypi_password dist/*```
+4. ```twine upload --repository-url https://test.pypi.org/legacy/ --config-file config.pypirc dist/*```
+
+
+Running Unit Tests from separate folder will require to import package or extend system pathes to folder with package sources.
+You will need to deploy package to repository and install it locally. Alternative solution is to insert absolute path to folder with package 
+
+```import sys```
+```sys.path.insert(0, "/path/to/your/package_or_module")```
+
+10. Install package from test repository
+
+```pip install --index-url https://test.pypi.org/simple  PACKAGE-NAME```
+
+Alternative way to force install
+```pip install --upgrade --force-reinstall PACKAGE-NAME```
+
+11. Run all unit tests in folder
+```call python -m unittest discover PATH-TO-UNIT-TESTS```