swiftly icon indicating copy to clipboard operation
swiftly copied to clipboard
verified publisher icon swift-server

MacOS: Steps for Uninstalling Swiftly

Open louisunlimited opened this issue 8 months ago • 5 comments

Currently, I can't find any uninstall steps for swiftly on MacOS apart from the Upgrade section in README, but I guess this was initially written for linux users? Swiftly does not install under ~/.local/share/swiftly on MacOS, should there be better documentations on how to safely uninstall Swiftly?

louisunlimited avatar Mar 31 '25 06:03 louisunlimited

There is also issue #84 for add a self-uninstall option to swiftly, which would automate the process.

For macOS, the uninstallation is approximately these steps:

  • Remove all installed toolchains (optional) with swiftly uninstall all
  • Remove any "Added by swiftly" sections in ~/.zprofile, ~/.profile, or ~/.bash_profile files
  • Remove the swiftly home and bin directories, default is ~/.swiftpm
  • Restart your shell

cmcgee1024 avatar Mar 31 '25 13:03 cmcgee1024

There is also issue #84 for add a self-uninstall option to swiftly, which would automate the process.

For macOS, the uninstallation is approximately these steps:

  • Remove all installed toolchains (optional) with swiftly uninstall all
  • Remove any "Added by swiftly" sections in ~/.zprofile, ~/.profile, or ~/.bash_profile files
  • Remove the swiftly home and bin directories, default is ~/.swiftpm
  • Restart your shell

Hi @cmcgee1024 thank you! Now going towards a 1.0 release have we come to a consensus on what the desired procedure would be? Should we provide an uninstall script like Homebrew does or should we have something like swiftly self uninstall like rustup does. I personally don't mind having uninstallation scripts but was thinking letting the users decide which specific folder to remove was not very straight forward, specially for those new to swift and the ecosystem, and having a packaged command would be a lot more beneficial. Also I'm willing to take on this if no one's working on it already!

louisunlimited avatar Mar 31 '25 18:03 louisunlimited

In the near term, the manual uninstall procedure should be documented more generally in the README. The longer term plan is #84, which automates this.

cmcgee1024 avatar Apr 01 '25 12:04 cmcgee1024

In the near term, the manual uninstall procedure should be documented more generally in the README. The longer term plan is #84, which automates this.

Sounds good! Do you mind if I start with a small PR adding deleting instructions to the README?

louisunlimited avatar Apr 02 '25 01:04 louisunlimited

Do you mind if I start with a small PR adding deleting instructions to the README?

Not at all. Contributions are welcome for this.

cmcgee1024 avatar Apr 02 '25 12:04 cmcgee1024