pyqver - query required Python version
Greg Hewgill
http://hewgill.com
INTRODUCTION
This script attempts to identify the minimum version of Python that is required to execute a particular source file.
When developing Python scripts for distribution, it is desirable to identify
which minimum version of the Python interpreter is required. pyqver
attempts to
answer this question using a simplistic analysis of the output of the Python
compiler.
When run without the -v
argument, sources are listed along with the minimum
version of Python required. When run with the -v
option, each version is
listed along with the reasons why that version is required. For example, for
the pyqver2.py
script itself:
pyqver2.py
2.3 platform
This means that pyqver2.py
uses the platform
module, which is a 2.3
feature.
The pyqver2.py
script is specific to Python 2.x, and pyqver3.py
is specific
to Python 3.x.
This script was inspired by the following question on Stack Overflow: Tool to determine what lowest version of Python required?
REQUIREMENTS
This script requires at least Python 2.3.
USAGE
Usage: pyqver[23].py [options] source ...
Report minimum Python version required to run given source files.
-m x.y or --min-version x.y (default M.N)
report version triggers at or above version x.y in verbose mode
-l or --lint
print a lint style report showing each offending line
-v or --verbose
print more detailed report of version triggers for each version
-l or --lint
print a lint style report showing each offending line
M.N
is the default minimum version depending on whether pyqver2.py
or
pyqver3.py
is run.
BUGS
There are currently a few features which are not detected. For example, the 2.6 syntax
try:
# ...
except Exception as x:
# ...
is not detected because the output of the compiler
module is the same for
both the old and the new syntax.
The TODO
file has a few notes of things to do.