117 lines
3.4 KiB
Python
117 lines
3.4 KiB
Python
import datetime
|
|
import functools
|
|
import os
|
|
import subprocess
|
|
import sys
|
|
|
|
from django.utils.regex_helper import _lazy_re_compile
|
|
|
|
# Private, stable API for detecting the Python version. PYXY means "Python X.Y
|
|
# or later". So that third-party apps can use these values, each constant
|
|
# should remain as long as the oldest supported Django version supports that
|
|
# Python version.
|
|
PY36 = sys.version_info >= (3, 6)
|
|
PY37 = sys.version_info >= (3, 7)
|
|
PY38 = sys.version_info >= (3, 8)
|
|
PY39 = sys.version_info >= (3, 9)
|
|
PY310 = sys.version_info >= (3, 10)
|
|
|
|
|
|
def get_version(version=None):
|
|
"""Return a PEP 440-compliant version number from VERSION."""
|
|
version = get_complete_version(version)
|
|
|
|
# Now build the two parts of the version number:
|
|
# main = X.Y[.Z]
|
|
# sub = .devN - for pre-alpha releases
|
|
# | {a|b|rc}N - for alpha, beta, and rc releases
|
|
|
|
main = get_main_version(version)
|
|
|
|
sub = ''
|
|
if version[3] == 'alpha' and version[4] == 0:
|
|
git_changeset = get_git_changeset()
|
|
if git_changeset:
|
|
sub = '.dev%s' % git_changeset
|
|
|
|
elif version[3] != 'final':
|
|
mapping = {'alpha': 'a', 'beta': 'b', 'rc': 'rc'}
|
|
sub = mapping[version[3]] + str(version[4])
|
|
|
|
return main + sub
|
|
|
|
|
|
def get_main_version(version=None):
|
|
"""Return main version (X.Y[.Z]) from VERSION."""
|
|
version = get_complete_version(version)
|
|
parts = 2 if version[2] == 0 else 3
|
|
return '.'.join(str(x) for x in version[:parts])
|
|
|
|
|
|
def get_complete_version(version=None):
|
|
"""
|
|
Return a tuple of the django version. If version argument is non-empty,
|
|
check for correctness of the tuple provided.
|
|
"""
|
|
if version is None:
|
|
from django import VERSION as version
|
|
else:
|
|
assert len(version) == 5
|
|
assert version[3] in ('alpha', 'beta', 'rc', 'final')
|
|
|
|
return version
|
|
|
|
|
|
def get_docs_version(version=None):
|
|
version = get_complete_version(version)
|
|
if version[3] != 'final':
|
|
return 'dev'
|
|
else:
|
|
return '%d.%d' % version[:2]
|
|
|
|
|
|
@functools.lru_cache
|
|
def get_git_changeset():
|
|
"""Return a numeric identifier of the latest git changeset.
|
|
|
|
The result is the UTC timestamp of the changeset in YYYYMMDDHHMMSS format.
|
|
This value isn't guaranteed to be unique, but collisions are very unlikely,
|
|
so it's sufficient for generating the development version numbers.
|
|
"""
|
|
# Repository may not be found if __file__ is undefined, e.g. in a frozen
|
|
# module.
|
|
if '__file__' not in globals():
|
|
return None
|
|
repo_dir = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
|
|
git_log = subprocess.run(
|
|
'git log --pretty=format:%ct --quiet -1 HEAD',
|
|
capture_output=True, shell=True, cwd=repo_dir, text=True,
|
|
)
|
|
timestamp = git_log.stdout
|
|
tz = datetime.timezone.utc
|
|
try:
|
|
timestamp = datetime.datetime.fromtimestamp(int(timestamp), tz=tz)
|
|
except ValueError:
|
|
return None
|
|
return timestamp.strftime('%Y%m%d%H%M%S')
|
|
|
|
|
|
version_component_re = _lazy_re_compile(r'(\d+|[a-z]+|\.)')
|
|
|
|
|
|
def get_version_tuple(version):
|
|
"""
|
|
Return a tuple of version numbers (e.g. (1, 2, 3)) from the version
|
|
string (e.g. '1.2.3').
|
|
"""
|
|
version_numbers = []
|
|
for item in version_component_re.split(version):
|
|
if item and item != '.':
|
|
try:
|
|
component = int(item)
|
|
except ValueError:
|
|
break
|
|
else:
|
|
version_numbers.append(component)
|
|
return tuple(version_numbers)
|