Provide non-Debian setup instructions and tooling #524
Conversation
On macOS, I don't need the Linux build for cloud-sql-proxy but rather the darwin build. Parameterizing the platform allow this part of the Makefile to work more generally on developer systems.
|
I can understand if this is a bit too instrusive. I stumbled into an issue on arXiv last week and then figured I'd try post a fix but then ran into issues just getting the env to work since I'm on macOS. Hope that the changes are still considered halfway useful to help other macOS or non-Debian users to get up to speed quickly and start contributing to this project. Why devenv.sh: I really tried to keep devenv out but when I stumbled into the clang and grpcio issues (mentioned in the README), I realised that it would be a considerable timesync and poor UX to write-up a series of imperative steps that one would have to execute in order to get things to work. Declarative looked much clearer to me at that point. Even at the cost of introducing a new tool. Love arXiv BTW! 🏆 Definitely in my top 5 sites on the interwebs, so I was happy to spend a few minutes tinkering here. 😄 |
Started this because I was trying to look into the issue I reported (see arXiv/html_feedback#644) and then realised that I couldn't use the Makefile because it was written to be used on Debian (and Debian-derivative) systems (with its use of apt and its fetching of "linux" variants of packages). These changes parameterise the configuration a bit and also provide a more hands-off experience with the use of devenv.sh.
Hopefully this makes it easier for other folks (non-Debian Linux users and even macOS users) to quickly check out the codebase for issues, debug things and contribute patches. It's been parameterised in a way that we should still have the same UX for Debian users as they had prior to the changes. If I failed at this attempt, yell at me for a fix and I'll get on it.