mirror of
https://gitlab.com/qemu-project/qemu
synced 2024-10-03 01:34:41 +00:00
Python: discourage direct setup.py install
When invoking setup.py directly, the default behavior for 'install' is to run the bdist_egg installation hook, which is ... actually deprecated by setuptools. It doesn't seem to work quite right anymore. By contrast, 'pip install' will invoke the bdist_wheel hook instead. This leads to differences in behavior for the two approaches. I advocate using pip in the documentation in this directory, but the 'setup.py' which has been used for quite a long time in the Python world may deceptively appear to work at first glance. Add an error message that will save a bit of time and frustration that points the user towards using the supported installation invocation. Reported-by: Daniel P. Berrangé <berrange@redhat.com> Signed-off-by: John Snow <jsnow@redhat.com> Reviewed-by: Beraldo Leal <bleal@redhat.com> Message-id: 20220207213039.2278569-1-jsnow@redhat.com Signed-off-by: John Snow <jsnow@redhat.com>
This commit is contained in:
parent
5c66d7d8de
commit
2ddaeb7b09
|
@ -5,9 +5,26 @@
|
||||||
"""
|
"""
|
||||||
|
|
||||||
import setuptools
|
import setuptools
|
||||||
|
from setuptools.command import bdist_egg
|
||||||
|
import sys
|
||||||
import pkg_resources
|
import pkg_resources
|
||||||
|
|
||||||
|
|
||||||
|
class bdist_egg_guard(bdist_egg.bdist_egg):
|
||||||
|
"""
|
||||||
|
Protect against bdist_egg from being executed
|
||||||
|
|
||||||
|
This prevents calling 'setup.py install' directly, as the 'install'
|
||||||
|
CLI option will invoke the deprecated bdist_egg hook. "pip install"
|
||||||
|
calls the more modern bdist_wheel hook, which is what we want.
|
||||||
|
"""
|
||||||
|
def run(self):
|
||||||
|
sys.exit(
|
||||||
|
'Installation directly via setup.py is not supported.\n'
|
||||||
|
'Please use `pip install .` instead.'
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
def main():
|
def main():
|
||||||
"""
|
"""
|
||||||
QEMU tooling installer
|
QEMU tooling installer
|
||||||
|
@ -16,7 +33,7 @@ def main():
|
||||||
# https://medium.com/@daveshawley/safely-using-setup-cfg-for-metadata-1babbe54c108
|
# https://medium.com/@daveshawley/safely-using-setup-cfg-for-metadata-1babbe54c108
|
||||||
pkg_resources.require('setuptools>=39.2')
|
pkg_resources.require('setuptools>=39.2')
|
||||||
|
|
||||||
setuptools.setup()
|
setuptools.setup(cmdclass={'bdist_egg': bdist_egg_guard})
|
||||||
|
|
||||||
|
|
||||||
if __name__ == '__main__':
|
if __name__ == '__main__':
|
||||||
|
|
Loading…
Reference in a new issue