Coverage for /pythoncovmergedfiles/medio/medio/usr/local/lib/python3.11/site-packages/git/objects/blob.py: 95%

1# Copyright (C) 2008, 2009 Michael Trier (mtrier@gmail.com) and contributors 

2# 

3# This module is part of GitPython and is released under the 

4# 3-Clause BSD License: https://opensource.org/license/bsd-3-clause/ 

5 

6__all__ = ["Blob"] 

7 

8from mimetypes import guess_type 

9import os 

10 

11from typing import Literal 

12 

13from . import base 

14 

15 

16class Blob(base.IndexObject): 

17 """A Blob encapsulates a git blob object. 

18 

19 See :manpage:`gitglossary(7)` on "blob": 

20 https://git-scm.com/docs/gitglossary#def_blob_object 

21 """ 

22 

23 DEFAULT_MIME_TYPE = "text/plain" 

24 type: Literal["blob"] = "blob" 

25 

26 # Valid blob modes 

27 executable_mode = 0o100755 

28 file_mode = 0o100644 

29 link_mode = 0o120000 

30 

31 __slots__ = () 

32 

33 @property 

34 def mime_type(self) -> str: 

35 """ 

36 :return: 

37 String describing the mime type of this file (based on the filename) 

38 

39 :note: 

40 Defaults to ``text/plain`` in case the actual file type is unknown. 

41 """ 

42 guesses = None 

43 if self.path: 

44 guesses = guess_type(os.fspath(self.path)) 

45 return guesses and guesses[0] or self.DEFAULT_MIME_TYPE