updapips 0.1.0__tar.gz

updapips-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ed Waldner
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

updapips-0.1.0/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: updapips
+Version: 0.1.0
+Summary: Upgrade outdated python packages via PIP
+Author-email: Ed Waldner <waldevburry@proton.me>
+Maintainer-email: Ed Waldner <waldevburry@proton.me>
+Project-URL: Homepage, https://github.com/ew98/updapips
+Project-URL: Documentation, https://github.com/ew98/updapips/wiki/UpDaPips
+Project-URL: Issues, https://github.com/ew98/updapips/issues
+Keywords: util,utility
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: argcomplete
+Requires-Dist: distro
+Requires-Dist: quickcolor
+Requires-Dist: delayviewer
+Requires-Dist: showexception
+Dynamic: license-file
+
+# UpDaPips
+
+**UpDaPips** is a command line package to upgrade outdated PIP packages in the current environment
+
+## Installation
+
+Use the package manager [pip](https://pip.pypa.io/en/stable/) to install **updapips**.
+
+```bash
+pip install updapips
+```
+
+## CLI Utility
+
+The following CLI is provided in this package.
+
+```bash
+╰─ bkmeup -h                                                                                                                             ─╯
+usage: bkmeup [-h] [--version] {show.env.info,show.dflt.bkup.list,create.archive} ...
+
+-.-.-. BkMeUp Shell Config archiver & bkup!
+
+positional arguments:
+  {show.env.info,show.dflt.bkup.list,create.archive}
+    show.env.info       show system environment info
+    show.dflt.bkup.list
+                        show list of default items to archive/bkup
+    create.archive      accumulate shell config files if they exist and archive them
+
+options:
+  -h, --help            show this help message and exit
+  --version             top-level package version
+
+-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.
+```
+
+
+## License
+
+[MIT](https://choosealicense.com/licenses/mit/)
+

updapips-0.1.0/README.md

@@ -0,0 +1,41 @@
+# UpDaPips
+
+**UpDaPips** is a command line package to upgrade outdated PIP packages in the current environment
+
+## Installation
+
+Use the package manager [pip](https://pip.pypa.io/en/stable/) to install **updapips**.
+
+```bash
+pip install updapips
+```
+
+## CLI Utility
+
+The following CLI is provided in this package.
+
+```bash
+╰─ bkmeup -h                                                                                                                             ─╯
+usage: bkmeup [-h] [--version] {show.env.info,show.dflt.bkup.list,create.archive} ...
+
+-.-.-. BkMeUp Shell Config archiver & bkup!
+
+positional arguments:
+  {show.env.info,show.dflt.bkup.list,create.archive}
+    show.env.info       show system environment info
+    show.dflt.bkup.list
+                        show list of default items to archive/bkup
+    create.archive      accumulate shell config files if they exist and archive them
+
+options:
+  -h, --help            show this help message and exit
+  --version             top-level package version
+
+-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.
+```
+
+
+## License
+
+[MIT](https://choosealicense.com/licenses/mit/)
+

updapips-0.1.0/pyproject.toml

@@ -0,0 +1,46 @@
+[build-system]
+requires = ["setuptools >= 81.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "updapips"
+description = "Upgrade outdated python packages via PIP"
+readme = {file = "README.md", content-type = "text/markdown"}
+authors = [{name = "Ed Waldner", email = "waldevburry@proton.me"},]
+maintainers = [{name = "Ed Waldner", email = "waldevburry@proton.me"},]
+# dynamic = ["version"]
+version = "0.1.0"
+requires-python = ">=3.9"
+dependencies = [
+    "argcomplete",
+    "distro",
+    "quickcolor",
+    "delayviewer",
+    "showexception",
+]
+keywords = [
+    "util", "utility"
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Natural Language :: English",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Operating System :: OS Independent",
+    "Topic :: Utilities",
+]
+
+[project.urls]
+Homepage = "https://github.com/ew98/updapips"
+Documentation = "https://github.com/ew98/updapips/wiki/UpDaPips"
+Issues = "https://github.com/ew98/updapips/issues"
+
+[project.scripts]
+updapips = "updapips.cli:cli"
+

updapips-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

updapips-0.1.0/src/__init__.py

@@ -0,0 +1,3 @@
+from updapips import (
+        updapips,
+        )

updapips-0.1.0/src/updapips/cli.py

@@ -0,0 +1,98 @@
+#!/usr/bin/env python3
+# ------------------------------------------------------------------------------------------------------
+# -- CLI for cleaning __pycache__ nested folders from specified root path
+# ------------------------------------------------------------------------------------------------------
+# ======================================================================================================
+
+# PYTHON_ARGCOMPLETE_OK
+import argcomplete, argparse
+
+import os
+import sys
+
+from quickcolor.color_def import color
+from showexception.showexception import exception_details
+
+from .updapips import get_pip_list_pkgs, get_pip_list_outdated_pkgs
+from .updapips import upgrade_pip_pkg
+
+# ------------------------------------------------------------------------------------------------------
+# ------------------------------------------------------------------------------------------------------
+
+def cli():
+    try:
+        parser = argparse.ArgumentParser(
+                    description=f'{"-." * 3}  {color.CBLUE2}Update PIPs {color.CYELLOW2}utility!{color.CEND}',
+                    epilog='-.' * 40)
+
+        parser.add_argument('--version', action="store_true", help='top-level package version')
+
+        subparsers = parser.add_subparsers(dest='cmd')
+
+        p_showAllPipPkgs = subparsers.add_parser('show.all.pip.pkgs',
+                                              help='show all PIP packages installed in current virt env')
+
+        p_showOutdatedPipPkgs = subparsers.add_parser('show.outdated.pip.pkgs',
+                                                   help='show PIP packages in virtual env that are outdated')
+
+        p_upgradePipPkgs = subparsers.add_parser('upgrade.pips',
+                                                help='updgrade all outdated PIP pkgs')
+
+        argcomplete.autocomplete(parser)
+        args = parser.parse_args()
+        # print(args)
+
+        if len(sys.argv) == 1:
+            parser.print_help(sys.stderr)
+            sys.exit(0)
+
+        if args.version:
+            from importlib.metadata import version
+            import bkmeup
+            print(f'{color.CGREEN}{os.path.basename(sys.argv[0])}{color.CEND} resides in package ' + \
+                    f'{color.CBLUE2}{updapips.__package__}{color.CEND} ' + \
+                    f'version {color.CVIOLET2}{version("updapips")}{color.CEND} ...')
+            sys.exit(0)
+
+        if args.cmd == 'show.all.pip.pkgs':
+            pkgs = get_pip_list_pkgs()
+            print(f"There are {color.CYELLOW2}{len(pkgs)}{color.CEND} PIP packages installed in this environment!\n")
+            for idx, pkg in enumerate(pkgs):
+                print(f" --> {color.CWHITE2}{idx+1:>3}. {color.CBLUE2}{pkg['name']:<30}{color.CEND} " + \
+                        f"ver: {color.CYELLOW2}{pkg['version']:<15}{color.CEND}", end=" ", flush=True)
+                if 'editable_project_location' in pkg.keys():
+                    print(f"{color.CGREEN}{pkg['editable_project_location']:<30}{color.CEND}")
+                else:
+                    print()
+
+        elif args.cmd == 'show.outdated.pip.pkgs':
+            pkgs = get_pip_list_outdated_pkgs()
+            if len(pkgs):
+                print(f" ... Found {color.CYELLOW2}{len(pkgs)}{color.CEND} PIP packages that can be upgraded!\n")
+                for idx, pkg in enumerate(pkgs):
+                    print(f" --> {color.CWHITE2}{idx+1:>3}. {color.CYELLOW2}{pkg['name']:<30}{color.CEND} " + \
+                            f"installed: {color.CRED2}{pkg['version']:<15}{color.CEND} " + \
+                            f"available: {color.CCYAN2}{pkg['latest_version']:<15}{color.CEND}", end=" ", flush=True)
+                    if 'editable_project_location' in pkg.keys():
+                        print(f"{color.CGREEN}{pkg['editable_project_location']:<30}{color.CEND}")
+                    else:
+                        print()
+            else:
+                print(f"{color.CGREEN}There are no PIP packages in this environment that need to be upgraded!{color.CEND}")
+
+        elif args.cmd == 'upgrade.pips':
+            pkgs = get_pip_list_outdated_pkgs()
+            if len(pkgs):
+                for pkg in pkgs:
+                    upgrade_pip_pkg(pkg['name'], pkg['version'], pkg['latest_version'])
+                print(f"\n .. Finished upgrade run for {color.CYELLOW2}{len(pkgs)} packages{color.CEND}!\n")
+
+            else:
+                print(f"{color.CGREEN}There are no PIP packages in this environment that need to be upgraded!{color.CEND}")
+
+    except Exception as e:
+        exception_details(e, "UpDaPIPs CLI", True)
+
+# ------------------------------------------------------------------------------------------------------
+# ------------------------------------------------------------------------------------------------------
+

updapips-0.1.0/src/updapips/updapips.py

@@ -0,0 +1,55 @@
+#!/usr/bin/env python3
+# ------------------------------------------------------------------------------------------------------
+# -- update PIP packages
+# ------------------------------------------------------------------------------------------------------
+# ======================================================================================================
+
+import json
+import sys
+import subprocess
+
+from quickcolor.color_def import color
+from delayviewer.spinner import handle_spinner
+
+# ------------------------------------------------------------------------------------------------------
+# ------------------------------------------------------------------------------------------------------
+
+def get_pip_list_pkgs() -> list:
+    result = subprocess.run([sys.executable, '-m', 'pip', 'list', '--format=json'], capture_output=True, text=True)
+    return json.loads(result.stdout)
+
+# ------------------------------------------------------------------------------------------------------
+
+@handle_spinner
+def get_pip_list_outdated_pkgs(debug: bool = False, spinner = None) -> list:
+    spinner.start(f" -- {color.CYELLOW2}Retrieving outdated packages{color.CEND} ...")
+    result = subprocess.run([sys.executable, '-m', 'pip', 'list', '--outdated', '--format=json'], capture_output=True, text=True)
+    spinner.stop()
+    pkgList = json.loads(result.stdout)
+    if debug:
+        if len(pkgList):
+            print(f"    Found {color.CCYAN}{len(pkgList)} package(s){color.CEND} to upgrade!\n")
+        else:
+            print(f"    {color.CGREEN2}No package updates required!{color.CEND}!\n")
+    return pkgList
+
+# ------------------------------------------------------------------------------------------------------
+
+@handle_spinner
+def upgrade_pip_pkg(pkgName: str, currVer: str, latestVer: str, debug: bool = False, spinner = None):
+    spinner.start(f" -- Upgrading {color.CGREEN2}{pkgName}{color.CEND} " + \
+            f"from {color.CRED2}{currVer}{color.CEND} to {color.CGREEN}{latestVer}{color.CEND} ...")
+    result = subprocess.run([sys.executable, '-m', 'pip', 'install', '--upgrade', pkgName], capture_output=True, text=True)
+    spinner.stop()
+
+    if result.returncode:
+        print(f"{color.CRED2}Error:{color.CWHI2}{result.stderr}{color.CEND}")
+
+    if debug:
+        print(f'STDOUT: {result.stdout}')
+        print(f'STDERR: {result.stderr}')
+        print(f'retcode: {result.returncode}')
+
+# ------------------------------------------------------------------------------------------------------
+# ------------------------------------------------------------------------------------------------------
+

updapips-0.1.0/src/updapips/upgrade_pip_pkgs.py

@@ -0,0 +1,59 @@
+#!/usr/bin/env python3
+
+import json
+import sys
+import subprocess
+
+from quickcolor.color_def import color
+from delayviewer.spinner import handle_spinner
+
+def get_pip_list_pkgs() -> list:
+    result = subprocess.run([sys.executable, '-m', 'pip', 'list', '--format=json'], capture_output=True, text=True)
+    return json.loads(result.stdout)
+
+@handle_spinner
+def get_pip_list_outdated_pkgs(spinner = None) -> list:
+    spinner.start(f" -- {color.CYELLOW2}Retrieving outdated packages{color.CEND} ...")
+    result = subprocess.run([sys.executable, '-m', 'pip', 'list', '--outdated', '--format=json'], capture_output=True, text=True)
+    spinner.stop()
+    pkgList = json.loads(result.stdout)
+    if len(pkgList):
+        print(f"    Found {color.CCYAN}{len(pkgList)} packages{color.CEND} to upgrade!\n")
+    else:
+        print(f"    {color.CGREEN2}No package updates required!{color.CEND}!\n")
+    return pkgList
+
+@handle_spinner
+def upgrade_pip_pkg(pkgName: str, debug: bool = False, spinner = None):
+    spinner.start(f" -- Upgrading {color.CGREEN2}{pkg['name']}{color.CEND} ...")
+    result = subprocess.run([sys.executable, '-m', 'pip', 'install', '--upgrade', pkgName], capture_output=True, text=True)
+    spinner.stop()
+
+    if result.returncode:
+        print(f"{color.CRED2}Error:{color.CWHI2}{result.stderr}{color.CEND}")
+
+    if debug:
+        print(f'STDOUT: {result.stdout}')
+        print(f'STDERR: {result.stderr}')
+        print(f'retcode: {result.returncode}')
+
+
+# python -m pip list --format=json | jq -r '.[] | [.name, .version] | @csv' > packages.csv
+
+# pkgs = get_pip_list_pkgs()
+# print(pkgs)
+
+outdatedPkgs = get_pip_list_outdated_pkgs()
+# print (outdatedPkgs)
+
+if len(outdatedPkgs):
+    # numPkgsToUpgrade = 1
+    for pkg in outdatedPkgs:
+        upgrade_pip_pkg(pkg['name'])
+        # numPkgsToUpgrade -= 1
+        # if numPkgsToUpgrade == 0:
+        #     break
+
+    print(f"\n .. Finished upgrade run for {color.CYELLOW2}{len(outdatedPkgs)} packages{color.CEND}!\n")
+
+

updapips-0.1.0/src/updapips.egg-info/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: updapips
+Version: 0.1.0
+Summary: Upgrade outdated python packages via PIP
+Author-email: Ed Waldner <waldevburry@proton.me>
+Maintainer-email: Ed Waldner <waldevburry@proton.me>
+Project-URL: Homepage, https://github.com/ew98/updapips
+Project-URL: Documentation, https://github.com/ew98/updapips/wiki/UpDaPips
+Project-URL: Issues, https://github.com/ew98/updapips/issues
+Keywords: util,utility
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: argcomplete
+Requires-Dist: distro
+Requires-Dist: quickcolor
+Requires-Dist: delayviewer
+Requires-Dist: showexception
+Dynamic: license-file
+
+# UpDaPips
+
+**UpDaPips** is a command line package to upgrade outdated PIP packages in the current environment
+
+## Installation
+
+Use the package manager [pip](https://pip.pypa.io/en/stable/) to install **updapips**.
+
+```bash
+pip install updapips
+```
+
+## CLI Utility
+
+The following CLI is provided in this package.
+
+```bash
+╰─ bkmeup -h                                                                                                                             ─╯
+usage: bkmeup [-h] [--version] {show.env.info,show.dflt.bkup.list,create.archive} ...
+
+-.-.-. BkMeUp Shell Config archiver & bkup!
+
+positional arguments:
+  {show.env.info,show.dflt.bkup.list,create.archive}
+    show.env.info       show system environment info
+    show.dflt.bkup.list
+                        show list of default items to archive/bkup
+    create.archive      accumulate shell config files if they exist and archive them
+
+options:
+  -h, --help            show this help message and exit
+  --version             top-level package version
+
+-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.
+```
+
+
+## License
+
+[MIT](https://choosealicense.com/licenses/mit/)
+

updapips-0.1.0/src/updapips.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+src/__init__.py
+src/updapips/__init__.py
+src/updapips/cli.py
+src/updapips/updapips.py
+src/updapips/upgrade_pip_pkgs.py
+src/updapips.egg-info/PKG-INFO
+src/updapips.egg-info/SOURCES.txt
+src/updapips.egg-info/dependency_links.txt
+src/updapips.egg-info/entry_points.txt
+src/updapips.egg-info/requires.txt
+src/updapips.egg-info/top_level.txt

updapips-0.1.0/src/updapips.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

updapips-0.1.0/src/updapips.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+updapips = updapips.cli:cli

updapips-0.1.0/src/updapips.egg-info/requires.txt

@@ -0,0 +1,5 @@
+argcomplete
+distro
+quickcolor
+delayviewer
+showexception

updapips-0.1.0/src/updapips.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+__init__
+updapips