# pkgu
Find the out-dated packages installed by the Pip tool and update them. Inspired by 👉[depu(Go)](https://github.com/kevwan/depu).
However, `pkgu` supports full and partial updates, which is more convenient and flexible. It also supports cross-platform(Windows, linux, macos). 🤓 To retrieve the data more fast after the first-time(Or don't have to execute command again), I use sqlite as cache db to store the data and can quickly read it from db and present it to the console💻.
👉 However, only python3.10 and above are available now.
## Usage
- Run code from source code
First, you need to install dependencies.
if you don't have `poetry` tool, please install it first. 🔗: [poetry installation](https://python-poetry.org/docs/#installation), otherwise, install packages directly.
```bash
poetry install
```
and then, run `pkgu.py` script.
```bash
python3 pkgu.py
```
- Use it through pip - ***Highly Recommended***
```bash
pip3 install pkgu
```
after the installation is complete, `pkgu` executable file will be written to the python bin directory and you can enter `pkgu -h` command on your terminal to learn how to use it.
```bash
# Usage
usage: pkgu [-h] [-v] {update,remove} ...
Upgrade and uninstall python package.
options:
-h, --help show this help message and exit
-v, --version Display pkgu version and information
Available commands:
{update,remove} Available commands
update Update python package.
remove remove python package with its dependencies.
# ------ update ------
options:
-h, --help show this help message and exit
-a, --async_upgrade Update the library asynchronously. Default: False
-d CACHE_FOLDER, --cache_folder CACHE_FOLDER
The cache.db file. Default: ~/.cache/cache.db
-e EXPIRE_TIME, --expire_time EXPIRE_TIME
The expiration time. Default: 43200
--no-cache Whether to use db cache. Default: False
# ------ remove ------
options:
-h, --help show this help message and exit
-l, --list list unused dependencies, but don't uninstall them.
-L, --leaves list leaves (packages which are not used by any others).
-y, --yes don't ask for confirmation of uninstall deletions.
-f, --freeze list leaves (packages which are not used by any others) in requirements.txt format
```
## ScreenShoot
> 1. No packages need to be upgraded.
> 2. Upgrade some expired packages.
> 3. Update the pkg synchronously
> 4. Update the pkg asynchronously
We can see that the async method is faster than sync method about 9 seconds(Only in this test situation).
So now it can support to update the python libraries asynchronously. 🥳
> 5. Support for selectable update packages
- List all availbable packages
- Select ths part of package to be updated
> 6. Support to use cache result from sqlite db file.
This improve the expirence that how we list the out-dated packages when they are huge to collect, and then there also is a cli flag `--no-cache` to control whether should to use cache.
> 7. !!!New - Support to uninstall package with its dependencies together.
Raw data
{
"_id": null,
"home_page": "https://github.com/Abeautifulsnow/pkgu",
"name": "pkgu",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "python3,pip,pip install pkg --upgrade,pip-update,uninstall",
"author": "Abeautifulsnow <lnrunstone.0727@gmail.com>",
"author_email": "lcprunstone@163.com",
"download_url": "",
"platform": null,
"description": "# pkgu\n\nFind the out-dated packages installed by the Pip tool and update them. Inspired by \ud83d\udc49[depu(Go)](https://github.com/kevwan/depu).\nHowever, `pkgu` supports full and partial updates, which is more convenient and flexible. It also supports cross-platform(Windows, linux, macos). \ud83e\udd13 To retrieve the data more fast after the first-time(Or don't have to execute command again), I use sqlite as cache db to store the data and can quickly read it from db and present it to the console\ud83d\udcbb.\n\n\ud83d\udc49 However, only python3.10 and above are available now.\n\n## Usage\n\n- Run code from source code\n\nFirst, you need to install dependencies.\n\nif you don't have `poetry` tool, please install it first. \ud83d\udd17: [poetry installation](https://python-poetry.org/docs/#installation), otherwise, install packages directly.\n\n```bash\npoetry install\n```\n\nand then, run `pkgu.py` script.\n\n```bash\npython3 pkgu.py\n```\n\n- Use it through pip - ***Highly Recommended***\n\n```bash\npip3 install pkgu\n```\n\nafter the installation is complete, `pkgu` executable file will be written to the python bin directory and you can enter `pkgu -h` command on your terminal to learn how to use it.\n\n```bash\n# Usage\nusage: pkgu [-h] [-v] {update,remove} ...\n\nUpgrade and uninstall python package.\n\noptions:\n -h, --help show this help message and exit\n -v, --version Display pkgu version and information\n\nAvailable commands:\n {update,remove} Available commands\n update Update python package.\n remove remove python package with its dependencies.\n\n# ------ update ------\noptions:\n -h, --help show this help message and exit\n -a, --async_upgrade Update the library asynchronously. Default: False\n -d CACHE_FOLDER, --cache_folder CACHE_FOLDER\n The cache.db file. Default: ~/.cache/cache.db\n -e EXPIRE_TIME, --expire_time EXPIRE_TIME\n The expiration time. Default: 43200\n --no-cache Whether to use db cache. Default: False\n\n# ------ remove ------\noptions:\n -h, --help show this help message and exit\n -l, --list list unused dependencies, but don't uninstall them.\n -L, --leaves list leaves (packages which are not used by any others).\n -y, --yes don't ask for confirmation of uninstall deletions.\n -f, --freeze list leaves (packages which are not used by any others) in requirements.txt format\n```\n\n## ScreenShoot\n\n> 1. No packages need to be upgraded.\n\n\n\n> 2. Upgrade some expired packages.\n\n\n\n\n\n> 3. Update the pkg synchronously\n\n\n\n> 4. Update the pkg asynchronously\n\n\n\nWe can see that the async method is faster than sync method about 9 seconds(Only in this test situation).\nSo now it can support to update the python libraries asynchronously. \ud83e\udd73\n\n> 5. Support for selectable update packages\n\n- List all availbable packages\n\n\n\n- Select ths part of package to be updated\n\n\n\n> 6. Support to use cache result from sqlite db file.\n\nThis improve the expirence that how we list the out-dated packages when they are huge to collect, and then there also is a cli flag `--no-cache` to control whether should to use cache.\n\n> 7. !!!New - Support to uninstall package with its dependencies together.\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Manage the installed package by providing support for updating and uninstalling.",
"version": "0.0.27",
"project_urls": {
"Homepage": "https://github.com/Abeautifulsnow/pkgu"
},
"split_keywords": [
"python3",
"pip",
"pip install pkg --upgrade",
"pip-update",
"uninstall"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "17b53e5554f3355e3e0fa8c26a645a701438b9e6e8b306625a05f5bab6e04f72",
"md5": "48f84b9ddd4e14466f13fddcc16630a0",
"sha256": "6122098a2e3a934ab1f3971d63c738eb3965d1a1771b447658517efb1eb1e1e4"
},
"downloads": -1,
"filename": "pkgu-0.0.27-py3-none-any.whl",
"has_sig": false,
"md5_digest": "48f84b9ddd4e14466f13fddcc16630a0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 13974,
"upload_time": "2024-03-10T06:07:41",
"upload_time_iso_8601": "2024-03-10T06:07:41.555872Z",
"url": "https://files.pythonhosted.org/packages/17/b5/3e5554f3355e3e0fa8c26a645a701438b9e6e8b306625a05f5bab6e04f72/pkgu-0.0.27-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-10 06:07:41",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Abeautifulsnow",
"github_project": "pkgu",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pkgu"
}
JSON
