# pip-upgrader [![Build Status](https://travis-ci.org/simion/pip-upgrader.svg?branch=master)](https://travis-ci.org/simion/pip-upgrader)
An interactive pip requirements upgrader. Because upgrading
requirements, package by package, is a pain in the ass. It also updates
the version in your requirements.txt file.
## Purpose
This cli tools helps you interactively(or not) upgrade packages from
requirements file, and also **update the pinned version from
requirements file(s)**.
If no requirements are given, the command **attempts to detect the
requirements file(s)** in the current directory.
Quick preview:
![image](https://raw.githubusercontent.com/simion/pip-upgrader/master/demo.gif)
## Installation
pip install pip-upgrader
**Note:** this packages installs the following requirements: `'docopt',
'packaging', 'requests', 'terminaltables', 'colorclass'`
To avoid installing all these dependencies in your project, you can
install `pip-upgrader` in your system, rather than your virtualenv. If
you install it in your system, and need to upgrade it, run `pip install
-U pip-upgrader`
## Usage
**Activate your virtualenv** (important, because it will also install
the new versions of upgraded packages in current virtualenv)
**CD into your project.** Then: :
$ pip-upgrade
Arguments: :
requirements_file(s) The requirement FILE, or WILDCARD PATH to multiple files. (positional arguments)
--prerelease Include prerelease versions for upgrade, when querying pypi repositories.
-p <package> Pre-choose which packages tp upgrade. Skips any prompt.
--dry-run Simulates the upgrade, but does not execute the actual upgrade.
--skip-package-installation Only upgrade the version in requirements files, don't install the new package.
--skip-virtualenv-check Disable virtualenv check. Allows installing the new packages outside the virtualenv.
--use-default-index Skip searching for custom index-url in pip configuration file(s).
Examples:
pip-upgrade # auto discovers requirements file. Prompts for selecting upgrades
pip-upgrade requirements.txt
pip-upgrade requirements/dev.txt requirements/production.txt
# skip prompt and manually choose some/all packages for upgrade
pip-upgrade requirements.txt -p django -p celery
pip-upgrade requirements.txt -p all
# include pre-release versions
pip-upgrade --prerelease
To use `pip-upgrader` on install requirements located in a `setup.py`
file, try this:
``` sh
./setup.py egg_info
pip-upgrade $(./setup.py --name | tr -- - _)*.egg-info/requires.txt
```
This will display any versions that can be upgraded, and helps you to
manually main
Raw data
{
"_id": null,
"home_page": "https://github.com/simion/pip-upgrader",
"name": "pip-upgrader",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "cli,pip,pypi,requirements,upgrade",
"author": "Simion Baws",
"author_email": "simion.agv@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/3c/54/d3d6fdc8f5379bb2c0cd2da286796a2bd77e0fdea20b43e37ef1e46f1c46/pip_upgrader-1.4.15.tar.gz",
"platform": "",
"description": "# pip-upgrader [![Build Status](https://travis-ci.org/simion/pip-upgrader.svg?branch=master)](https://travis-ci.org/simion/pip-upgrader)\n\nAn interactive pip requirements upgrader. Because upgrading\nrequirements, package by package, is a pain in the ass. It also updates\nthe version in your requirements.txt file.\n\n## Purpose\n\nThis cli tools helps you interactively(or not) upgrade packages from\nrequirements file, and also **update the pinned version from\nrequirements file(s)**.\n\nIf no requirements are given, the command **attempts to detect the\nrequirements file(s)** in the current directory.\n\nQuick preview:\n\n![image](https://raw.githubusercontent.com/simion/pip-upgrader/master/demo.gif)\n\n## Installation\n\n pip install pip-upgrader\n\n**Note:** this packages installs the following requirements: `'docopt',\n'packaging', 'requests', 'terminaltables', 'colorclass'`\n\nTo avoid installing all these dependencies in your project, you can\ninstall `pip-upgrader` in your system, rather than your virtualenv. If\nyou install it in your system, and need to upgrade it, run `pip install\n-U pip-upgrader`\n\n## Usage\n\n**Activate your virtualenv** (important, because it will also install\nthe new versions of upgraded packages in current virtualenv)\n\n**CD into your project.** Then: :\n\n $ pip-upgrade\n\nArguments: :\n\n requirements_file(s) The requirement FILE, or WILDCARD PATH to multiple files. (positional arguments)\n --prerelease Include prerelease versions for upgrade, when querying pypi repositories.\n -p <package> Pre-choose which packages tp upgrade. Skips any prompt.\n --dry-run Simulates the upgrade, but does not execute the actual upgrade.\n --skip-package-installation Only upgrade the version in requirements files, don't install the new package.\n --skip-virtualenv-check Disable virtualenv check. Allows installing the new packages outside the virtualenv.\n --use-default-index Skip searching for custom index-url in pip configuration file(s).\n\nExamples:\n\n pip-upgrade # auto discovers requirements file. Prompts for selecting upgrades\n pip-upgrade requirements.txt\n pip-upgrade requirements/dev.txt requirements/production.txt\n\n # skip prompt and manually choose some/all packages for upgrade\n pip-upgrade requirements.txt -p django -p celery\n pip-upgrade requirements.txt -p all\n\n # include pre-release versions\n pip-upgrade --prerelease\n\nTo use `pip-upgrader` on install requirements located in a `setup.py`\nfile, try this:\n\n``` sh\n./setup.py egg_info\npip-upgrade $(./setup.py --name | tr -- - _)*.egg-info/requires.txt\n```\n\nThis will display any versions that can be upgraded, and helps you to\nmanually main\n\n\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "An interactive pip requirements upgrader. It also updates the version in your requirements.txt file.",
"version": "1.4.15",
"split_keywords": [
"cli",
"pip",
"pypi",
"requirements",
"upgrade"
],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "174a589aae1b1374592a7976236d5d3a",
"sha256": "7ddfdfa3b6664469c00b50d23f3ed082d61b16babd0729f9d52090add54abdca"
},
"downloads": -1,
"filename": "pip_upgrader-1.4.15-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "174a589aae1b1374592a7976236d5d3a",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 16762,
"upload_time": "2019-06-23T16:07:06",
"upload_time_iso_8601": "2019-06-23T16:07:06.239612Z",
"url": "https://files.pythonhosted.org/packages/b2/42/36c09ad93ddbf10406e301f3d4d7d063cf27fa5cf7a881ccea78bb22cdc7/pip_upgrader-1.4.15-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"md5": "588e5e9b1732c1e08344f88a0468c999",
"sha256": "ec07b93e06825d9cf40f475a8e021fc9d288446b479b40cb9aba406a6db65347"
},
"downloads": -1,
"filename": "pip_upgrader-1.4.15.tar.gz",
"has_sig": false,
"md5_digest": "588e5e9b1732c1e08344f88a0468c999",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 5809216,
"upload_time": "2019-06-23T16:07:08",
"upload_time_iso_8601": "2019-06-23T16:07:08.491540Z",
"url": "https://files.pythonhosted.org/packages/3c/54/d3d6fdc8f5379bb2c0cd2da286796a2bd77e0fdea20b43e37ef1e46f1c46/pip_upgrader-1.4.15.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2019-06-23 16:07:08",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "simion",
"github_project": "pip-upgrader",
"travis_ci": true,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "Django",
"specs": [
[
"==",
"1.11.29"
]
]
},
{
"name": "django-rest-auth",
"specs": [
[
"==",
"0.9.0"
]
]
}
],
"tox": true,
"lcname": "pip-upgrader"
}