summaryrefslogtreecommitdiff
path: root/lib/git/utils.py
blob: 39994bd594476ceb7e4324399244648701f1c9b7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
# utils.py
# Copyright (C) 2008, 2009 Michael Trier (mtrier@gmail.com) and contributors
#
# This module is part of GitPython and is released under
# the BSD License: http://www.opensource.org/licenses/bsd-license.php

import os

def dashify(string):
	return string.replace('_', '-')

def touch(filename):
	os.utime(filename)

def is_git_dir(d):
	""" This is taken from the git setup.c:is_git_directory
		function."""

	if os.path.isdir(d) and \
			os.path.isdir(os.path.join(d, 'objects')) and \
			os.path.isdir(os.path.join(d, 'refs')):
		headref = os.path.join(d, 'HEAD')
		return os.path.isfile(headref) or \
				(os.path.islink(headref) and
				os.readlink(headref).startswith('refs'))
	return False
	
	
class LazyMixin(object):
	__slots__ = tuple()
	
	def __getattr__(self, attr):
		"""
		Whenever an attribute is requested that we do not know, we allow it 
		to be created and set. Next time the same attribute is reqeusted, it is simply
		returned from our dict/slots.
		"""
		self._set_cache_(attr)
		# will raise in case the cache was not created
		return object.__getattribute__(self, attr)

	def _set_cache_(self, attr):
		""" This method should be overridden in the derived class. 
		It should check whether the attribute named by attr can be created
		and cached. Do nothing if you do not know the attribute or call your subclass
		
		The derived class may create as many additional attributes as it deems 
		necessary in case a git command returns more information than represented 
		in the single attribute."""
		pass