Coverage for /pythoncovmergedfiles/medio/medio/usr/local/lib/python3.8/site-packages/django/utils/version.py: 10%

1import datetime 

2import functools 

3import os 

4import subprocess 

5import sys 

6 

7from django.utils.regex_helper import _lazy_re_compile 

8 

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) 

18PY311 = sys.version_info >= (3, 11) 

19 

20 

21def get_version(version=None): 

22 """Return a PEP 440-compliant version number from VERSION.""" 

23 version = get_complete_version(version) 

24 

25 # Now build the two parts of the version number: 

26 # main = X.Y[.Z] 

27 # sub = .devN - for pre-alpha releases 

28 # | {a|b|rc}N - for alpha, beta, and rc releases 

29 

30 main = get_main_version(version) 

31 

32 sub = "" 

33 if version[3] == "alpha" and version[4] == 0: 

34 git_changeset = get_git_changeset() 

35 if git_changeset: 

36 sub = ".dev%s" % git_changeset 

37 

38 elif version[3] != "final": 

39 mapping = {"alpha": "a", "beta": "b", "rc": "rc"} 

40 sub = mapping[version[3]] + str(version[4]) 

41 

42 return main + sub 

43 

44 

45def get_main_version(version=None): 

46 """Return main version (X.Y[.Z]) from VERSION.""" 

47 version = get_complete_version(version) 

48 parts = 2 if version[2] == 0 else 3 

49 return ".".join(str(x) for x in version[:parts]) 

50 

51 

52def get_complete_version(version=None): 

53 """ 

54 Return a tuple of the django version. If version argument is non-empty, 

55 check for correctness of the tuple provided. 

56 """ 

57 if version is None: 

58 from django import VERSION as version 

59 else: 

60 assert len(version) == 5 

61 assert version[3] in ("alpha", "beta", "rc", "final") 

62 

63 return version 

64 

65 

66def get_docs_version(version=None): 

67 version = get_complete_version(version) 

68 if version[3] != "final": 

69 return "dev" 

70 else: 

71 return "%d.%d" % version[:2] 

72 

73 

74@functools.lru_cache 

75def get_git_changeset(): 

76 """Return a numeric identifier of the latest git changeset. 

77 

78 The result is the UTC timestamp of the changeset in YYYYMMDDHHMMSS format. 

79 This value isn't guaranteed to be unique, but collisions are very unlikely, 

80 so it's sufficient for generating the development version numbers. 

81 """ 

82 # Repository may not be found if __file__ is undefined, e.g. in a frozen 

83 # module. 

84 if "__file__" not in globals(): 

85 return None 

86 repo_dir = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) 

87 git_log = subprocess.run( 

88 "git log --pretty=format:%ct --quiet -1 HEAD", 

89 capture_output=True, 

90 shell=True, 

91 cwd=repo_dir, 

92 text=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") 

101 

102 

103version_component_re = _lazy_re_compile(r"(\d+|[a-z]+|\.)") 

104 

105 

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)