search

rudof-project / rudof

RDF data shapes implementation in Rust
https://rudof-project.github.io
Apache License 2.0
35 stars 3 forks source link

Improve installation instructions on Mac #156

Open labra opened 1 month ago

labra commented 1 month ago

We generate binaries for Mac in releases but I was assuming that Mac users would know how to run those binaries and maybe it is not so obvious?

Maybe we should improve the README instructions explaining how to install those binaries and run them on a Mac...

flecktarn121 commented 1 month ago

I have encountered some problems when trying to use the binaries.

After downloading both executables in a Mac, I run chmod +x on them and tried to execute via the command line, getting the following output:

./rudof_v0.1.25_aarch64_apple: Bad CPU type in executable
./rudof_v0.1.25_x86_64_apple: Bad CPU type in executable

The machine has the following characteristics:

labra commented 1 month ago

I asked a colleague to check if it worked in his Mac and he said that it worked. He said that he has the latest OS (Sonoma) and an M1 processor.

kcoyle commented 1 month ago

chmod +x rudof_v0.1.25_aarch64_apple then ./rudof_v0.1.25_aarch64_apple -h worked for me on an M3 Mac. As per its protections, the Mac complains about the unknown program so you have to go into settings and agree to let the OS open it.

Note - I had to get help from someone to give me the chmod command since I know NOTHING about using binaries on a Mac. It would be good to add the chmod instruction to the documentation, which currently says something vague about using a package -- Mac package (Brew) didn't work.

labra commented 1 month ago

Hi!, Karen!!

Indeed the colleague that checked it in his mac also advised my about the chmod +x and going into settings and agree to let the OS open it.

Thanks for your info and I hope you have fun trying rudof...if you have any issues, don't hesitate to open a issue or just send me a direct email.

labra commented 1 month ago

Yesterday, I found this command line tool bat which is also written in Rust and it is available in several platforms.

The instructions to install it in Mac suggest either Homebrew or MacPorts. Maybe we should do something like that?

kcoyle commented 1 month ago

I would think that most - even all - Mac command line users are familiar with Homebrew. That would help a lot.

MarcAntoine-Arnaud commented 4 weeks ago

Yes it's very easy to declare new Homebrew Tap. By creating a repo like: https://github.com/MarcAntoine-Arnaud/homebrew-video

You have to ad some ruby files to give dependencies and installation commands.