rye icon indicating copy to clipboard operation
rye copied to clipboard

[Request] Update installation methods

Open yozachar opened this issue 2 years ago • 9 comments

Edit

Outdated comment

Linux and MacOS users can use asdf to install rye.

$ asdf plugin add rye
$ asdf install rye latest
$ asdf global rye latest
redirect url: https://github.com/mitsuhiko/rye/releases/tag/0.5.0
$ rye --version
rye 0.5.0
commit: 0.5.0 (5f96294de 2023-05-31)
platform: linux (x86_64)
self-python: [email protected]
symlink support: true

Windows users can use scoop as soon as this PR (https://github.com/ScoopInstaller/Main/pull/4849) is merged.

$ scoop install rye

This can be included in the docs here:

https://github.com/mitsuhiko/rye/blob/b4caf51f3648e6c24ad047438a75608d4118e378/docs/guide/installation.md?plain=1#L19-L44

These installation methods will automatically take care of adding rye shims to the path.

See: https://github.com/mitsuhiko/rye/issues/278#issuecomment-1696644586

yozachar avatar Jun 01 '23 02:06 yozachar

See https://repology.org/project/rye/versions for the complete list of packages so far: Packaging status

sitiom avatar Jun 01 '23 03:06 sitiom

The challenge with alternative installation methods is that I neither control them nor have the capacity to support them at the moment. I would need to figure out how to best approach this as I have little experience with that.

mitsuhiko avatar Jun 01 '23 06:06 mitsuhiko

Perhaps you can add a separate "Third-party packages" section with a disclaimer and point to the Repology list.

sitiom avatar Jun 01 '23 07:06 sitiom

The challenge with alternative installation methods is that I neither control them nor have the capacity to support them at the moment. I would need to figure out how to best approach this as I have little experience with that.

Having a rye GitHub org, may help, ref: https://github.com/mitsuhiko/rye/discussions/46 You can create a repo called distributions which tracks status on repology / third-party etc.

yozachar avatar Jun 01 '23 16:06 yozachar

These installation methods will automatically take care of adding rye shims to the path.

Using asdf and this was not the case for me. I still had to manually add them to my path.

doolio avatar Aug 28 '23 09:08 doolio

Using asdf and this was not the case for me. I still had to manually add them to my path.

Did you try asdf reshim after installation, also, are you sourcing asdf before starting your shell?


I used rtx an alternative to asdf found it far more robust.

$ rtx i rye@latest

But I suspect, that anyone would want to fiddle with multiple versions of rye, unless they are developing the same. Instead since rye publishes releases on GitHub, I recommend using bin to manage binaries.

$ bin i https://github.com/mitsuhiko/rye 
   • Getting latest release for mitsuhiko/rye

Multiple matches found, please select one:

 [1] rye-x86_64-linux.gz
 [2] rye-x86_64-linux.gz.sha256
 Select an option: 1
   • Starting download of https://api.github.com/repos/mitsuhiko/rye/releases/assets/123323774
7.39 MiB / 7.39 MiB [--------------------------------------------------------------------------] 100.00% 1.46 MiB p/s 5s
   • Copying for [email protected] into /home/user/.local/bin/rye
   • Done installing rye 0.12.0

$ rye --version                                                                             
rye 0.12.0
commit: 0.12.0 (f5525c985 2023-08-27)
platform: linux (x86_64)
self-python: [email protected]
symlink support: true

yozachar avatar Aug 29 '23 01:08 yozachar

Did you try asdf reshim after installation, also, are you sourcing asdf before starting your shell?

No and Yes.

asdf reshim will simply reshim the asdf rye shim not the shims python and python3 provided by rye.

The rye docs state you have to manually add its shims to your PATH and it is still necessary to do that even if installing with asdf. A potential issue in doing that though is if you also use asdf-python you may not be using the python version you want depending on which shim comes first on your PATH and whether you are in a rye managed python project or not. To avoid any issues it is important to ensure the python version within your virtual environment is first on your PATH when your environment is activated.

I used rtx an alternative to asdf found it far more robust.

Thanks I was not aware of rtx. I might consider it as an alternative but asdf has been working well for me.

But I suspect, that anyone would want to fiddle with multiple versions of rye, unless they are developing the same.

I presume you mean would not want to fiddle with multiple versions of rye. I agree. Thanks also for making me aware of bin I may also consider it.

doolio avatar Aug 29 '23 09:08 doolio

Why is this issue closed?

sitiom avatar Nov 02 '23 04:11 sitiom

The official installation instructions seems sufficient for an overall new user. Anybody else well acquainted with packaging, probably always checks repology.

Apart from that I did not find rtx (esp. asdf) as suitable candidates to manage rye. bin seems fine, but is less known. So I thought maybe adding more installation methods isn't worth the apparent confusion it might cause new users.

But after seeing this:

image

Adding another tab titled Using Package Managers might not be a bad idea after all.

yozachar avatar Nov 02 '23 05:11 yozachar