Skip to main content

AutoUpgrade

https://img.shields.io/pypi/v/autoupgrade-ng.svg https://img.shields.io/github/issues/vuolter/autoupgrade.svg https://img.shields.io/pypi/dm/autoupgrade-ng.svg https://img.shields.io/pypi/l/autoupgrade-ng.svg https://img.shields.io/pypi/format/autoupgrade-ng.svg https://img.shields.io/pypi/pyversions/autoupgrade-ng.svg https://img.shields.io/pypi/status/autoupgrade-ng.svg https://img.shields.io/twitter/url/https/twitter.com/WalterPurcaro.svg?style=social https://img.shields.io/github/stars/vuolter/autoupgrade.svg

Quick Start

from autoupgrade import Package
Package(<packagename>).smartupgrade()

Example:

from autoupgrade import Package
Package('pip').smartupgrade()

The above will upgrade the Python package pip only if there is a new version available on the PyPI. The upgrade will be unattended and the python script will be restarted.

Old methods are still supported; you can accomplish the same task calling:

from autoupgrade import AutoUpgrade
AutoUpgrade('pip').upgrade_if_needed()

Installation

pip install autoupgrade-ng

All the modules will be installed under the autoupgrade package, so make sure you have already removed the old AutoUpgrade package (https://pypi.python.org/pypi/autoupgrade) before install this to avoid an installation conflict.

Usage

Classes

class Package(__builtin__.object)

Decription: Basic package class, holds one package.

class AutoUpgrade(__builtin__.object)

Decription: Legacy class refering to Package one.

Methods

__init__(self, pkg, index=None, verbose=False)

Decription: None.

Arguments:

  • pkg (str) name of package.

  • index (str) alternative index, if not given default from pip will be used.
    Include full index url _(e.g. https://example.com/simple)_.
    Return: None.
check(self)

Decription: Check if pkg has a later version.

Arguments: None.

Return: True if later version exists, else False.

restart(self)

Decription: Restart application with same args as it was started.

Arguments: None.

Return: None.

upgrade(self, dependencies=False, prerelease=False, force=False)

Decription: Upgrade the package unconditionaly.

Arguments:

  • dependencies update dependencies if True (see ``pip –no-deps``).

  • prerelease update to pre-release and development versions.

  • force reinstall all packages even if they are already up-to-date.

Return: None.

smartupgrade(self, restart=True, dependencies=False,
prerelease=False)

Decription: Upgrade the package if there is a later version available.

Arguments:

  • restart restart app if True.

  • dependencies update dependencies if True (see ``pip –no-deps``).

  • prerelease update to pre-release and development versions.

Return: None.

upgrade\_if\_needed(self, restart=True, dependencies=False,
prerelease=False)

Decription: Legacy method refering to smartupgrade one.

Arguments: Same as smartupgrade.

Return: Same as smartupgrade.

Release notes

0.3.0:

  • Fork of autoupgrade (https://pypi.python.org/pypi/autoupgrade).

  • Python 3 support.

  • Removed unnecessary dependencies.

  • Pre-release and force-reinstall support.

  • Massive code refactoring and cleaning.

  • Updated README and LICENSE.

  • New exception PIPError to handle pip errors.

  • Main class renamed to Package.

  • More verbose messages.

  • Small code optimizations and improvements.

0.2.0:

  • Issue #2, Index did not work when specified.

  • Issue #3, Autoupgrade should not print to console (added verbose flag to keep backward compatibility.

  • Issue #4, Support for pip > v0.6 .

0.1.5:

  • Issue #1, Extra index did not work for all servers.

0.1.4:

  • Fixed bug when version contains characters.

0.1.3:

  • Fixed vital fault in v0.1.2 .

0.1.2:

  • Setup file fixes

  • Removed verbose output as default.

  • Return value fixed of method upgrade.

0.1.1:

  • Dependencies updated.

0.1.0:

  • Initial release.

Metadata

Release files for autoupgrade-prima 0.6.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for autoupgrade-prima 0.6.5
File Interpreter ABI Platform
autoupgrade_prima-0.6.5-py2.py3-none-any.whl Python 3, Python 2 none any Details

Release files / autoupgrade_prima-0.6.5-py2.py3-none-any.whl

Download URL autoupgrade_prima-0.6.5-py2.py3-none-any.whl
Size 5.4 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
980c802e9d704b540de7b8df508a5d7b7f742799250a47abd29e4168de05b06e
BLAKE2b-256 checksum
How to use checksums
a6a2bd00b7cb6b0ad196cf0c7289a11cbefbb42a6f8c36724d6fe9030dcbb943
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.11.2

Release history Release notifications | RSS feed

This release

0.6.5 This release

1 release file

0.6.4

1 release file

0.6.3

2 release files

0.6.2

2 release files

0.6.1

2 release files

0.6.0

2 release files

0.5.1

1 release file

0.5.0

2 release files

0.4.0

2 release files

0.3.4

2 release files

0.3.3

2 release files

0.3.2

2 release files

0.3.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page