# 🐍 pyupgradecheck
[](https://pypi.org/project/pyupgradecheck/)
[](https://github.com/tdiprima/pyupgradecheck/actions)
<img src="https://raw.githubusercontent.com/tdiprima/pyupgradecheck/refs/heads/main/logo.png" width="700">
> 💡 **Check your Python packages before you upgrade.**
> Find out which of your dependencies are ready for your next Python version — and which ones might ruin your day.
## 🚀 Installation
```bash
pip install pyupgradecheck
```
## ⚡️ Quickstart
```bash
# Test all installed packages
pyupgradecheck 3.14
```
**Example Output:**
```
requests 2.32.3: supported (PyPI requires_python: >=3.7)
some-old-lib 1.2.0: incompatible (PyPI requires_python: <3.10)
```
## 🧰 CLI Examples
```bash
# Check specific packages
pyupgradecheck 3.14 --packages packaging httpx halo
# or short form:
pyupgradecheck 3.14 --p packaging httpx halo
```
```bash
# Check a requirements.txt file
pyupgradecheck 3.14 --requirements requirements.txt
# or short form:
pyupgradecheck 3.14 -r requirements.txt
```
```bash
# Perfect for CI
pyupgradecheck 3.14 --json > compat-report.json
```
## 💬 CLI Help
```bash
pyupgradecheck --help
```
## 🤔 Why pyupgradecheck?
Because upgrading Python shouldn't be a trust fall.
Quickly see which of your installed packages can handle your target Python version — before you break your dev environment or CI build.
## ❤️ Contributing
Pull requests welcome 💖
Run tests with:
```bash
pytest
```
## 🧩 Perfect for
* 🧪 CI/CD pipelines
* 🐍 Devs upgrading their local environments
* 🧠 Maintainers checking project compatibility
<br>
Raw data
{
"_id": null,
"home_page": null,
"name": "pyupgradecheck",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "python, compatibility, pypi, upgrade, cli, dependency",
"author": null,
"author_email": "Tammy DiPrima <tdiprima@yahoo.com>",
"download_url": "https://files.pythonhosted.org/packages/20/a3/e6bbd2a3401089d0c10c654ccc94136fbdcfea6826b43413ec1110427eff/pyupgradecheck-0.1.9.tar.gz",
"platform": null,
"description": "# \ud83d\udc0d pyupgradecheck\n\n[](https://pypi.org/project/pyupgradecheck/)\n[](https://github.com/tdiprima/pyupgradecheck/actions)\n\n<img src=\"https://raw.githubusercontent.com/tdiprima/pyupgradecheck/refs/heads/main/logo.png\" width=\"700\">\n\n> \ud83d\udca1 **Check your Python packages before you upgrade.**\n> Find out which of your dependencies are ready for your next Python version \u2014 and which ones might ruin your day.\n\n## \ud83d\ude80 Installation\n\n```bash\npip install pyupgradecheck\n```\n\n## \u26a1\ufe0f Quickstart\n\n```bash\n# Test all installed packages\npyupgradecheck 3.14\n```\n\n**Example Output:**\n\n```\nrequests 2.32.3: supported (PyPI requires_python: >=3.7)\nsome-old-lib 1.2.0: incompatible (PyPI requires_python: <3.10)\n```\n\n## \ud83e\uddf0 CLI Examples\n\n```bash\n# Check specific packages\npyupgradecheck 3.14 --packages packaging httpx halo\n# or short form:\npyupgradecheck 3.14 --p packaging httpx halo\n```\n\n```bash\n# Check a requirements.txt file\npyupgradecheck 3.14 --requirements requirements.txt\n# or short form:\npyupgradecheck 3.14 -r requirements.txt\n```\n\n```bash\n# Perfect for CI\npyupgradecheck 3.14 --json > compat-report.json\n```\n\n## \ud83d\udcac CLI Help\n\n```bash\npyupgradecheck --help\n```\n\n## \ud83e\udd14 Why pyupgradecheck?\n\nBecause upgrading Python shouldn't be a trust fall. \nQuickly see which of your installed packages can handle your target Python version \u2014 before you break your dev environment or CI build.\n\n## \u2764\ufe0f Contributing\n\nPull requests welcome \ud83d\udc96 \nRun tests with:\n\n```bash\npytest\n```\n\n## \ud83e\udde9 Perfect for\n\n* \ud83e\uddea CI/CD pipelines\n* \ud83d\udc0d Devs upgrading their local environments\n* \ud83e\udde0 Maintainers checking project compatibility\n\n<br>\n",
"bugtrack_url": null,
"license": null,
"summary": "Check your installed Python packages for version compatibility",
"version": "0.1.9",
"project_urls": null,
"split_keywords": [
"python",
" compatibility",
" pypi",
" upgrade",
" cli",
" dependency"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "4323400bc3a5ece8e70fdc22418d42f611452a31f9c9919e8cce18be846a30cc",
"md5": "2c3c5dfd49da3b64da282df93f27bf3b",
"sha256": "9fe9a60df3875d96a0a868e3ace036ba9feaf04c136b350069f4670898de3d2a"
},
"downloads": -1,
"filename": "pyupgradecheck-0.1.9-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2c3c5dfd49da3b64da282df93f27bf3b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 6712,
"upload_time": "2025-10-27T15:03:07",
"upload_time_iso_8601": "2025-10-27T15:03:07.740564Z",
"url": "https://files.pythonhosted.org/packages/43/23/400bc3a5ece8e70fdc22418d42f611452a31f9c9919e8cce18be846a30cc/pyupgradecheck-0.1.9-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "20a3e6bbd2a3401089d0c10c654ccc94136fbdcfea6826b43413ec1110427eff",
"md5": "5d8a2ec4a4dea250985e653ac4600aab",
"sha256": "d468e3aa3e62f805d7bdad97ea773daa19017e381a9371ac722b5a85e57fbb89"
},
"downloads": -1,
"filename": "pyupgradecheck-0.1.9.tar.gz",
"has_sig": false,
"md5_digest": "5d8a2ec4a4dea250985e653ac4600aab",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 6010,
"upload_time": "2025-10-27T15:03:08",
"upload_time_iso_8601": "2025-10-27T15:03:08.564401Z",
"url": "https://files.pythonhosted.org/packages/20/a3/e6bbd2a3401089d0c10c654ccc94136fbdcfea6826b43413ec1110427eff/pyupgradecheck-0.1.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-27 15:03:08",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "pyupgradecheck"
}
JSON