Development of an internal social media platform with personalised dashboards for students
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

version.py 2.8KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394
  1. import datetime
  2. import functools
  3. import os
  4. import subprocess
  5. from distutils.version import LooseVersion
  6. def get_version(version=None):
  7. """Return a PEP 440-compliant version number from VERSION."""
  8. version = get_complete_version(version)
  9. # Now build the two parts of the version number:
  10. # main = X.Y[.Z]
  11. # sub = .devN - for pre-alpha releases
  12. # | {a|b|rc}N - for alpha, beta, and rc releases
  13. main = get_main_version(version)
  14. sub = ''
  15. if version[3] == 'alpha' and version[4] == 0:
  16. git_changeset = get_git_changeset()
  17. if git_changeset:
  18. sub = '.dev%s' % git_changeset
  19. elif version[3] != 'final':
  20. mapping = {'alpha': 'a', 'beta': 'b', 'rc': 'rc'}
  21. sub = mapping[version[3]] + str(version[4])
  22. return main + sub
  23. def get_main_version(version=None):
  24. """Return main version (X.Y[.Z]) from VERSION."""
  25. version = get_complete_version(version)
  26. parts = 2 if version[2] == 0 else 3
  27. return '.'.join(str(x) for x in version[:parts])
  28. def get_complete_version(version=None):
  29. """
  30. Return a tuple of the django version. If version argument is non-empty,
  31. check for correctness of the tuple provided.
  32. """
  33. if version is None:
  34. from django import VERSION as version
  35. else:
  36. assert len(version) == 5
  37. assert version[3] in ('alpha', 'beta', 'rc', 'final')
  38. return version
  39. def get_docs_version(version=None):
  40. version = get_complete_version(version)
  41. if version[3] != 'final':
  42. return 'dev'
  43. else:
  44. return '%d.%d' % version[:2]
  45. @functools.lru_cache()
  46. def get_git_changeset():
  47. """Return a numeric identifier of the latest git changeset.
  48. The result is the UTC timestamp of the changeset in YYYYMMDDHHMMSS format.
  49. This value isn't guaranteed to be unique, but collisions are very unlikely,
  50. so it's sufficient for generating the development version numbers.
  51. """
  52. repo_dir = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
  53. git_log = subprocess.Popen(
  54. 'git log --pretty=format:%ct --quiet -1 HEAD',
  55. stdout=subprocess.PIPE, stderr=subprocess.PIPE,
  56. shell=True, cwd=repo_dir, universal_newlines=True,
  57. )
  58. timestamp = git_log.communicate()[0]
  59. try:
  60. timestamp = datetime.datetime.utcfromtimestamp(int(timestamp))
  61. except ValueError:
  62. return None
  63. return timestamp.strftime('%Y%m%d%H%M%S')
  64. def get_version_tuple(version):
  65. """
  66. Return a tuple of version numbers (e.g. (1, 2, 3)) from the version
  67. string (e.g. '1.2.3').
  68. """
  69. loose_version = LooseVersion(version)
  70. version_numbers = []
  71. for item in loose_version.version:
  72. if not isinstance(item, int):
  73. break
  74. version_numbers.append(item)
  75. return tuple(version_numbers)