Coverage for /var/srv/projects/api.amasfac.comuna18.com/tmp/venv/lib/python3.9/site-packages/django/utils/version.py: 62%
62 statements
« prev ^ index » next coverage.py v6.4.4, created at 2023-07-17 14:22 -0600
« prev ^ index » next coverage.py v6.4.4, created at 2023-07-17 14:22 -0600
1import datetime
2import functools
3import os
4import subprocess
5import sys
7from django.utils.regex_helper import _lazy_re_compile
9# Private, stable API for detecting the Python version. PYXY means "Python X.Y
10# or later". So that third-party apps can use these values, each constant
11# should remain as long as the oldest supported Django version supports that
12# Python version.
13PY36 = sys.version_info >= (3, 6)
14PY37 = sys.version_info >= (3, 7)
15PY38 = sys.version_info >= (3, 8)
16PY39 = sys.version_info >= (3, 9)
17PY310 = sys.version_info >= (3, 10)
20def get_version(version=None):
21 """Return a PEP 440-compliant version number from VERSION."""
22 version = get_complete_version(version)
24 # Now build the two parts of the version number:
25 # main = X.Y[.Z]
26 # sub = .devN - for pre-alpha releases
27 # | {a|b|rc}N - for alpha, beta, and rc releases
29 main = get_main_version(version)
31 sub = ""
32 if version[3] == "alpha" and version[4] == 0: 32 ↛ 33line 32 didn't jump to line 33, because the condition on line 32 was never true
33 git_changeset = get_git_changeset()
34 if git_changeset:
35 sub = ".dev%s" % git_changeset
37 elif version[3] != "final": 37 ↛ 38line 37 didn't jump to line 38, because the condition on line 37 was never true
38 mapping = {"alpha": "a", "beta": "b", "rc": "rc"}
39 sub = mapping[version[3]] + str(version[4])
41 return main + sub
44def get_main_version(version=None):
45 """Return main version (X.Y[.Z]) from VERSION."""
46 version = get_complete_version(version)
47 parts = 2 if version[2] == 0 else 3
48 return ".".join(str(x) for x in version[:parts])
51def get_complete_version(version=None):
52 """
53 Return a tuple of the django version. If version argument is non-empty,
54 check for correctness of the tuple provided.
55 """
56 if version is None:
57 from django import VERSION as version
58 else:
59 assert len(version) == 5
60 assert version[3] in ("alpha", "beta", "rc", "final")
62 return version
65def get_docs_version(version=None):
66 version = get_complete_version(version)
67 if version[3] != "final":
68 return "dev"
69 else:
70 return "%d.%d" % version[:2]
73@functools.lru_cache()
74def get_git_changeset():
75 """Return a numeric identifier of the latest git changeset.
77 The result is the UTC timestamp of the changeset in YYYYMMDDHHMMSS format.
78 This value isn't guaranteed to be unique, but collisions are very unlikely,
79 so it's sufficient for generating the development version numbers.
80 """
81 # Repository may not be found if __file__ is undefined, e.g. in a frozen
82 # module.
83 if "__file__" not in globals():
84 return None
85 repo_dir = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
86 git_log = subprocess.run(
87 "git log --pretty=format:%ct --quiet -1 HEAD",
88 stdout=subprocess.PIPE,
89 stderr=subprocess.PIPE,
90 shell=True,
91 cwd=repo_dir,
92 universal_newlines=True,
93 )
94 timestamp = git_log.stdout
95 tz = datetime.timezone.utc
96 try:
97 timestamp = datetime.datetime.fromtimestamp(int(timestamp), tz=tz)
98 except ValueError:
99 return None
100 return timestamp.strftime("%Y%m%d%H%M%S")
103version_component_re = _lazy_re_compile(r"(\d+|[a-z]+|\.)")
106def get_version_tuple(version):
107 """
108 Return a tuple of version numbers (e.g. (1, 2, 3)) from the version
109 string (e.g. '1.2.3').
110 """
111 version_numbers = []
112 for item in version_component_re.split(version):
113 if item and item != ".":
114 try:
115 component = int(item)
116 except ValueError:
117 break
118 else:
119 version_numbers.append(component)
120 return tuple(version_numbers)