Why the python 3 virtual environment?
Since a change in python pip (which itself is now part of the newest debian/raspian release 12 "bookworm), pip does no longer allow the user to install libraries for the whole system. Yes, this can be an initial inconvenience, but it is way cleaner and the reason python devs push this change. There is also a theoretical solution to use a python environment with --user, but this is broken also. The smart solution is to use a virtual environment anyways but use as many system libs as possible. I tried to compile all the requirements on a RPi Zero but stopped the process after 10 hours ...
Also this PR includes the git commands to circumvent problems arising with newer git versions (see #245). The possible removal of the python call for git (self.currentGitHash) should be considered, but this is out of scope of this PR.
I tested this version on bullseye as much as possible and the setup is working on a freshly installed bookworm.
I would be happy if somebody else is testing this and is verifying if the documentation is done correctly, I never used sphinx before. Also I have my wordclock running on bookworm within a virtual environment for several weeks now without any issue.
This PR
Why the python 3 virtual environment? Since a change in python pip (which itself is now part of the newest debian/raspian release 12 "bookworm), pip does no longer allow the user to install libraries for the whole system. Yes, this can be an initial inconvenience, but it is way cleaner and the reason python devs push this change. There is also a theoretical solution to use a python environment with
--user, but this is broken also. The smart solution is to use a virtual environment anyways but use as many system libs as possible. I tried to compile all the requirements on a RPi Zero but stopped the process after 10 hours ...Also this PR includes the git commands to circumvent problems arising with newer git versions (see #245). The possible removal of the python call for git (
self.currentGitHash) should be considered, but this is out of scope of this PR.I tested this version on bullseye as much as possible and the setup is working on a freshly installed bookworm.
I would be happy if somebody else is testing this and is verifying if the documentation is done correctly, I never used sphinx before. Also I have my wordclock running on bookworm within a virtual environment for several weeks now without any issue.
This PR resolves #246