Metadata-Version: 2.1
Name: UpgradePipPkgs
Version: 0.3.2
Summary: Tool for upgrading all `pip` packages within a Python environment using just one command.
Home-page: https://github.com/schlopp96/UpgradePipPkgs
Author: schlopp96
Author-email: schloppdaddy@gmail.com
Keywords: upgrade,pip,pkgs,pkg,package,packages,update,python,install,modules,module,installation,manager,upgrades,updates
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Archiving :: Packaging
Classifier: Environment :: Console 
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: alive-progress (>=2.4.1)
Requires-Dist: PyLoadBar (==0.1.0)
Requires-Dist: setuptools (>=62.1.0)

# UpgradePipPkgs

> Tool for upgrading all `pip` packages within a Python environment using just one command.

---

## About

- **_`UpgradePipPkgs`_** can upgrade all of your `pip` packages using one of two methods:

  **Method 1:**

  > **First gather all outdated packages using the command `pip list --outdated`, then pass results to a list of outdated packages to be upgraded.**

  - This method is generally more efficient than the following method, as only outdated packages are passed to upgrade process.
  - Unfortunately doesn't take into account package dependencies relying on specific package versions to function properly.

  ---

  **Method 2:**

  > **Iterate over _all_ installed packages, passing the command `pip install --upgrade {pkgname}` over each one.**

  - This method takes more time overall, but is _"safer"_.
  - _"Safer"_ in this context means that package dependencies are corrected upon attempting upgrade on a package that specifies its dependencies, downgrading specific package versions where necessary.
  - Note that **not all packages will be able to downgrade**, as the order of packages upgraded is relevant to whether incorrect version dependencies are corrected.
    - For example, let's assume **`PackA`** requires **`PackB<=1.0.0`** as a dependency:
      1. **`PackA`** will be checked for available upgrade first, and will check for installed dependency pkg **`PackB<=1.0.0`**, installing it if not already installed.
      2. `PackB` is then checked, and has a new version available, `1.1.0`.
      3. `PackB-1.0.0` is then upgraded to `1.1.0`, but now `PackA` can't function correctly due to incorrect dependency version.
      4. This can easily be fixed by reinstalling `PackA` using the `pip` install command: "`pip install PackA`".

- You can review past results/program output in the application's log file, which can be found here:
  - `"~/UpgradePipPkgs/logs/pip_pkg_upgrade_log.log"`

---

## Installation

### **Using PIP _(Recommended)_**

> Easiest method. _Highly recommended over manual installation_.

- To install _**`UpgradePipPkgs`**_ using `pip`, enter the following in your commandline environment:

  ```shell
  pip install UpgradePipPkgs
  ```

- You should now be able to import/run _**`UpgradePipPkgs`**_ within your python environment by entering the following:

  ```python
  >>> from UpgradePipPkgs import upgrade_pip_pkgs # <-- Import UpgradePipPkgs
  >>> upgrade_pip_pkgs() # <-- start program
  ...
  ```

- Done!

---

### **Manual Installation**

> _Not_ recommended.

1. Before use, navigate to intended installation location, and create a new directory.

2. Clone repository with the git client of your preference.

3. Install all dependencies for this package within said directory by entering the following:

   ```shell
     pip install -r requirements.txt
   ```

- **(Optional)** move installation directory to `"~/path/to/Python/Libs/site_packages"` to be able to import this package to a Python program like any other importable package.

**Done!**

---

## Usage

- If installed using `pip`, you can start **_UpgradePipPkgs_** by entering the following command in your commandline environment:

  ```shell
  upgrade-pip-pkgs
  ```

- In order to use _**`UpgradePipPkgs`**_ within a Python program, start by importing the module to your Python environment:

  ```python
  >>> from UpgradePipPkgs import upgrade_pip_pkgs
  ```

- Call the `upgrade_pip_pkgs` function to start the application, and choose the method of operation by typing the option number, and press **[ENTER]**.

  ```python
  >>> upgrade_pip_pkgs()
  ```

- Follow the on-screen prompts to complete the upgrade process.

![alt](./img/README_screenshot.png)

---

## Contact the Author

- If you have any questions, comments, or concerns that cannot be alleviated through the [project's GitHub repository "issues" tab](https://github.com/schlopp96/UpgradePipPkgs), please feel free to contact me through my email address:
  - `schloppdaddy@gmail.com`

---
