<div align="center">
<h1>
<img alt="Topgrade" src="doc/topgrade_transparent.png" width="850px">
</h1>
<a href="https://github.com/topgrade-rs/topgrade/releases"><img alt="GitHub Release" src="https://img.shields.io/github/release/topgrade-rs/topgrade.svg"></a>
<a href="https://crates.io/crates/topgrade"><img alt="crates.io" src="https://img.shields.io/crates/v/topgrade.svg"></a>
<a href="https://aur.archlinux.org/packages/topgrade"><img alt="AUR" src="https://img.shields.io/aur/version/topgrade.svg"></a>
<a href="https://formulae.brew.sh/formula/topgrade"><img alt="Homebrew" src="https://img.shields.io/homebrew/v/topgrade.svg"></a>
<img alt="Demo" src="doc/topgrade_demo.gif">
</div>
## Introduction
> **Note**
> This is a fork of [topgrade by r-darwish](https://github.com/r-darwish/topgrade) to keep it maintained.
Keeping your system up to date usually involves invoking multiple package managers.
This results in big, non-portable shell one-liners saved in your shell.
To remedy this, **Topgrade** detects which tools you use and runs the appropriate commands to update them.
## Installation
[](https://repology.org/project/topgrade/versions)
- Arch Linux: [AUR](https://aur.archlinux.org/packages/topgrade)
- NixOS: [Nixpkgs](https://search.nixos.org/packages?show=topgrade)
- Void Linux: [XBPS](https://voidlinux.org/packages/?arch=x86_64&q=topgrade)
- macOS: [Homebrew](https://formulae.brew.sh/formula/topgrade) or [MacPorts](https://ports.macports.org/port/topgrade/)
- Windows: [Scoop](https://github.com/ScoopInstaller/Main/blob/master/bucket/topgrade.json)
- PyPi: [pip](https://pypi.org/project/topgrade/)
Other systems users can either use `cargo install` or the compiled binaries from the release page.
The compiled binaries contain a self-upgrading feature.
> Currently, Topgrade requires Rust 1.65 or above. In general, Topgrade tracks
> the latest stable toolchain.
## Usage
Just run `topgrade`.
## Configuration
See `config.example.toml` for an example configuration file.
## Migration and Breaking Changes
Whenever there is a **breaking change**, the major version number will be bumped,
and we will document these changes in the release note, please take a look at
it when updated to a major release.
> Got a question? Feel free to open an issue or discussion!
### Configuration Path
#### `CONFIG_DIR` on each platform
- **Windows**: `%APPDATA%`
- **macOS** and **other Unix systems**: `${XDG_CONFIG_HOME:-~/.config}`
`topgrade` will look for the configuration file in the following places, in order of priority:
1. `CONFIG_DIR/topgrade.toml`
2. `CONFIG_DIR/topgrade/topgrade.toml`
If the file with higher priority is present, no matter it is valid or not, the other configuration files will be ignored.
On the first run(no configuration file exists), `topgrade` will create a configuration file at `CONFIG_DIR/topgrade.toml` for you.
### Custom Commands
Custom commands can be defined in the config file which can be run before, during, or after the inbuilt commands, as required.
By default, the custom commands are run using a new shell according to the `$SHELL` environment variable on unix (falls back to `sh`) or `pwsh` on windows (falls back to `powershell`).
On unix, if you want to run your command using an interactive shell, for example to source your shell's rc files, you can add `-i` at the start of your custom command.
But note that this requires the command to exit the shell correctly or else the shell will hang indefinitely.
## Remote Execution
You can specify a key called `remote_topgrades` in the configuration file.
This key should contain a list of hostnames that have Topgrade installed on them.
Topgrade will use `ssh` to run `topgrade` on remote hosts before acting locally.
To limit the execution only to specific hosts use the `--remote-host-limit` parameter.
## Contribution
### Problems or missing features?
Open a new issue describing your problem and if possible provide a solution.
### Missing a feature or found an unsupported tool/distro?
Just let us now what you are missing by opening an issue.
For tools, please open an issue describing the tool, which platforms it supports and if possible, give us an example of its usage.
### Want to contribute to the code?
Just fork the repository and start coding.
### Contribution Guidelines
See [CONTRIBUTING.md](https://github.com/topgrade-rs/topgrade/blob/master/CONTRIBUTING.md)
## Roadmap
- [ ] Add a proper testing framework to the code base.
- [ ] Add unit tests for package managers.
- [ ] Split up code into more maintainable parts, eg. putting every linux package manager in a own submodule of linux.rs.
Raw data
{
"_id": null,
"home_page": null,
"name": "topgrade",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "upgrade,update",
"author": "Roey Darwish Dror <roey.ghost@gmail.com>, Thomas Sch\u00f6nauer <t.schoenauer@hgs-wt.at>",
"author_email": "Roey Darwish Dror <roey.ghost@gmail.com>, Thomas Sch\u00f6nauer <t.schoenauer@hgs-wt.at>",
"download_url": "https://files.pythonhosted.org/packages/fb/24/eabacbadf62b16030eb591fd1a062c08829dc73a2389ded4c1ce280b6eff/topgrade-14.0.1.tar.gz",
"platform": null,
"description": "<div align=\"center\">\n <h1>\n <img alt=\"Topgrade\" src=\"doc/topgrade_transparent.png\" width=\"850px\">\n </h1>\n \n <a href=\"https://github.com/topgrade-rs/topgrade/releases\"><img alt=\"GitHub Release\" src=\"https://img.shields.io/github/release/topgrade-rs/topgrade.svg\"></a>\n <a href=\"https://crates.io/crates/topgrade\"><img alt=\"crates.io\" src=\"https://img.shields.io/crates/v/topgrade.svg\"></a>\n <a href=\"https://aur.archlinux.org/packages/topgrade\"><img alt=\"AUR\" src=\"https://img.shields.io/aur/version/topgrade.svg\"></a>\n <a href=\"https://formulae.brew.sh/formula/topgrade\"><img alt=\"Homebrew\" src=\"https://img.shields.io/homebrew/v/topgrade.svg\"></a>\n\n <img alt=\"Demo\" src=\"doc/topgrade_demo.gif\">\n</div>\n\n\n## Introduction\n\n> **Note**\n> This is a fork of [topgrade by r-darwish](https://github.com/r-darwish/topgrade) to keep it maintained.\n\nKeeping your system up to date usually involves invoking multiple package managers.\nThis results in big, non-portable shell one-liners saved in your shell.\nTo remedy this, **Topgrade** detects which tools you use and runs the appropriate commands to update them.\n\n## Installation\n\n[](https://repology.org/project/topgrade/versions)\n\n- Arch Linux: [AUR](https://aur.archlinux.org/packages/topgrade)\n- NixOS: [Nixpkgs](https://search.nixos.org/packages?show=topgrade)\n- Void Linux: [XBPS](https://voidlinux.org/packages/?arch=x86_64&q=topgrade)\n- macOS: [Homebrew](https://formulae.brew.sh/formula/topgrade) or [MacPorts](https://ports.macports.org/port/topgrade/)\n- Windows: [Scoop](https://github.com/ScoopInstaller/Main/blob/master/bucket/topgrade.json)\n- PyPi: [pip](https://pypi.org/project/topgrade/)\n\nOther systems users can either use `cargo install` or the compiled binaries from the release page.\nThe compiled binaries contain a self-upgrading feature.\n\n> Currently, Topgrade requires Rust 1.65 or above. In general, Topgrade tracks \n> the latest stable toolchain.\n\n## Usage\n\nJust run `topgrade`.\n\n## Configuration \n\nSee `config.example.toml` for an example configuration file.\n\n## Migration and Breaking Changes\n\nWhenever there is a **breaking change**, the major version number will be bumped,\nand we will document these changes in the release note, please take a look at \nit when updated to a major release.\n\n> Got a question? Feel free to open an issue or discussion!\n\n### Configuration Path\n\n#### `CONFIG_DIR` on each platform\n- **Windows**: `%APPDATA%`\n- **macOS** and **other Unix systems**: `${XDG_CONFIG_HOME:-~/.config}`\n\n`topgrade` will look for the configuration file in the following places, in order of priority:\n\n1. `CONFIG_DIR/topgrade.toml`\n2. `CONFIG_DIR/topgrade/topgrade.toml`\n\nIf the file with higher priority is present, no matter it is valid or not, the other configuration files will be ignored.\n\nOn the first run(no configuration file exists), `topgrade` will create a configuration file at `CONFIG_DIR/topgrade.toml` for you.\n\n### Custom Commands\n\nCustom commands can be defined in the config file which can be run before, during, or after the inbuilt commands, as required.\nBy default, the custom commands are run using a new shell according to the `$SHELL` environment variable on unix (falls back to `sh`) or `pwsh` on windows (falls back to `powershell`).\n\nOn unix, if you want to run your command using an interactive shell, for example to source your shell's rc files, you can add `-i` at the start of your custom command.\nBut note that this requires the command to exit the shell correctly or else the shell will hang indefinitely.\n\n## Remote Execution\n\nYou can specify a key called `remote_topgrades` in the configuration file.\nThis key should contain a list of hostnames that have Topgrade installed on them.\nTopgrade will use `ssh` to run `topgrade` on remote hosts before acting locally.\nTo limit the execution only to specific hosts use the `--remote-host-limit` parameter.\n\n## Contribution\n\n### Problems or missing features?\n\nOpen a new issue describing your problem and if possible provide a solution.\n\n### Missing a feature or found an unsupported tool/distro?\n\nJust let us now what you are missing by opening an issue.\nFor tools, please open an issue describing the tool, which platforms it supports and if possible, give us an example of its usage.\n\n### Want to contribute to the code?\n\nJust fork the repository and start coding.\n\n### Contribution Guidelines\n\nSee [CONTRIBUTING.md](https://github.com/topgrade-rs/topgrade/blob/master/CONTRIBUTING.md)\n\n## Roadmap\n\n- [ ] Add a proper testing framework to the code base.\n- [ ] Add unit tests for package managers.\n- [ ] Split up code into more maintainable parts, eg. putting every linux package manager in a own submodule of linux.rs.\n\n",
"bugtrack_url": null,
"license": "GPL-3.0",
"summary": "Upgrade all the things",
"version": "14.0.1",
"project_urls": {
"Source Code": "https://github.com/topgrade-rs/topgrade"
},
"split_keywords": [
"upgrade",
"update"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "2406aa4597206c38734f6f569976ff49155492593d7453b80ead96a87f2d7762",
"md5": "26dd57b4e59e5a1d33746ed0d28fb149",
"sha256": "868ff0fa1b029d929af2b7f07682e45c681f5877d52fdc805d710f863e626a14"
},
"downloads": -1,
"filename": "topgrade-14.0.1-py3-none-macosx_10_12_x86_64.whl",
"has_sig": false,
"md5_digest": "26dd57b4e59e5a1d33746ed0d28fb149",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 2544312,
"upload_time": "2024-01-25T07:54:22",
"upload_time_iso_8601": "2024-01-25T07:54:22.446908Z",
"url": "https://files.pythonhosted.org/packages/24/06/aa4597206c38734f6f569976ff49155492593d7453b80ead96a87f2d7762/topgrade-14.0.1-py3-none-macosx_10_12_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "b139a1b56eb95e2bde2ef67209e606e7cea0748f14514f0002e81fc852b70721",
"md5": "15eab6ebc43ccd9338123522b2f8fc04",
"sha256": "39329510f0098b83c21e1b5435fd282c4b023853417de255611bb220699be8ee"
},
"downloads": -1,
"filename": "topgrade-14.0.1-py3-none-macosx_11_0_arm64.whl",
"has_sig": false,
"md5_digest": "15eab6ebc43ccd9338123522b2f8fc04",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 2376800,
"upload_time": "2024-01-25T07:54:25",
"upload_time_iso_8601": "2024-01-25T07:54:25.490948Z",
"url": "https://files.pythonhosted.org/packages/b1/39/a1b56eb95e2bde2ef67209e606e7cea0748f14514f0002e81fc852b70721/topgrade-14.0.1-py3-none-macosx_11_0_arm64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "765a5289e34c7d2a064775bdebf434c1bb6d588321893df422c613ecb3a445a5",
"md5": "77b880d27b25087d81cbb1917b8bbe74",
"sha256": "7d915c8aff2c741a9e1487e85f933631addc1531397ce8781329883a9f3ecd08"
},
"downloads": -1,
"filename": "topgrade-14.0.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl",
"has_sig": false,
"md5_digest": "77b880d27b25087d81cbb1917b8bbe74",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 4048034,
"upload_time": "2024-01-25T07:54:28",
"upload_time_iso_8601": "2024-01-25T07:54:28.071684Z",
"url": "https://files.pythonhosted.org/packages/76/5a/5289e34c7d2a064775bdebf434c1bb6d588321893df422c613ecb3a445a5/topgrade-14.0.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "5bc8a7c873d6646b53fd0a5f93497fe442956c7fdb39cc8c4c9d750a0ab31b55",
"md5": "a4e80dcda0419c7870750177df95c29a",
"sha256": "2fad76627d2839889ea40ae3d0c0d612acd7ae2d97c3946f2d2453b3c1c1a45a"
},
"downloads": -1,
"filename": "topgrade-14.0.1-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl",
"has_sig": false,
"md5_digest": "a4e80dcda0419c7870750177df95c29a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 4027744,
"upload_time": "2024-01-25T07:54:31",
"upload_time_iso_8601": "2024-01-25T07:54:31.003942Z",
"url": "https://files.pythonhosted.org/packages/5b/c8/a7c873d6646b53fd0a5f93497fe442956c7fdb39cc8c4c9d750a0ab31b55/topgrade-14.0.1-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "da70c71499b33a5619e943a29bf7809504446c7192962d6e851170a7acc645ae",
"md5": "7aa257f716341afa1c0222b440090e83",
"sha256": "80d26c8742df4878406e64cd242049980a5dac1339157485101bcd45457e5957"
},
"downloads": -1,
"filename": "topgrade-14.0.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"has_sig": false,
"md5_digest": "7aa257f716341afa1c0222b440090e83",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 4097728,
"upload_time": "2024-01-25T07:54:33",
"upload_time_iso_8601": "2024-01-25T07:54:33.181172Z",
"url": "https://files.pythonhosted.org/packages/da/70/c71499b33a5619e943a29bf7809504446c7192962d6e851170a7acc645ae/topgrade-14.0.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "9bd177e8b9209e1f1c1903d3d385bc29ad7875cb213d065b6711c9474f9ad8c1",
"md5": "7a437cb337b32a8b61dd36bc783cdcba",
"sha256": "4a373ae368d5f71dfe344015a490c1b8bf1435efaf37b61e54934da64d27b6e7"
},
"downloads": -1,
"filename": "topgrade-14.0.1-py3-none-win32.whl",
"has_sig": false,
"md5_digest": "7a437cb337b32a8b61dd36bc783cdcba",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 1913757,
"upload_time": "2024-01-25T07:54:35",
"upload_time_iso_8601": "2024-01-25T07:54:35.866590Z",
"url": "https://files.pythonhosted.org/packages/9b/d1/77e8b9209e1f1c1903d3d385bc29ad7875cb213d065b6711c9474f9ad8c1/topgrade-14.0.1-py3-none-win32.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "e177b4214869b1cd13012caf7e68a460750bbc48fece91fd215a7de59fe64653",
"md5": "23ad223a319c3d8df900aa785037ad46",
"sha256": "98e3ba5d2a80cec45563b42b776c47c06cc3c610e2f0acc71d668701508d4080"
},
"downloads": -1,
"filename": "topgrade-14.0.1-py3-none-win_amd64.whl",
"has_sig": false,
"md5_digest": "23ad223a319c3d8df900aa785037ad46",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 2161518,
"upload_time": "2024-01-25T07:54:38",
"upload_time_iso_8601": "2024-01-25T07:54:38.030648Z",
"url": "https://files.pythonhosted.org/packages/e1/77/b4214869b1cd13012caf7e68a460750bbc48fece91fd215a7de59fe64653/topgrade-14.0.1-py3-none-win_amd64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "fb24eabacbadf62b16030eb591fd1a062c08829dc73a2389ded4c1ce280b6eff",
"md5": "0c4d74eb4e6d21d364537b7086a2d228",
"sha256": "1562d60f569f1058981e981172ef50d2ec3efb0017dbf649754d5cfcab91813d"
},
"downloads": -1,
"filename": "topgrade-14.0.1.tar.gz",
"has_sig": false,
"md5_digest": "0c4d74eb4e6d21d364537b7086a2d228",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 4398021,
"upload_time": "2024-01-25T07:54:40",
"upload_time_iso_8601": "2024-01-25T07:54:40.411377Z",
"url": "https://files.pythonhosted.org/packages/fb/24/eabacbadf62b16030eb591fd1a062c08829dc73a2389ded4c1ce280b6eff/topgrade-14.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-25 07:54:40",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "topgrade-rs",
"github_project": "topgrade",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "topgrade"
}
JSON
