Enhance comments

1 files changed, 5 insertions, 1 deletions

diff --git a/git-gmi/git.py b/git-gmi/git.py
index 79a59c4..52764d2 100644
--- a/git-gmi/git.py
+++ b/git-gmi/git.py
@@ -10,6 +10,7 @@ mimetypes.add_type("text/gemini", ".gemini")
 
 
 def convert_filesize(bytes: int) -> str:
+    # convert filesize in bytes to a human-friendly format
     return size(bytes, system=alternative)
 
 
@@ -23,6 +24,7 @@ class GitGmiRepo:
             raise FileNotFoundError(f"Error: no such repo: {name}")
 
     def generate_header(self):
+        # global "header" to display above all views (except raw files)
         header = (
             f"# {self.name}\n"
             f"=> {CGI_PATH} {GIT_GMI_SITE_TITLE}\n"
@@ -62,7 +64,7 @@ class GitGmiRepo:
         return response
 
     def get_commit_log(self) -> list:
-        # returns the commit log in a human-readable way.
+        # returns useful info from commit log.
         repo = self.repo
         commits = list(repo.walk(repo[repo.head.target].id, GIT_SORT_TIME))
         log = [
@@ -82,6 +84,7 @@ class GitGmiRepo:
         response = f"{STATUS_SUCCESS} {META_GEMINI}\n" + self.generate_header()
         log = self.get_commit_log()
         for cmt in log:
+            # looks like "2020-06-06 04:51:21 UTC"
             time = str(datetime.utcfromtimestamp(cmt["time"])) + " UTC"
             response += (
                 f"## {cmt['short_id']} - {cmt['author']} - {time}\n"
@@ -199,6 +202,7 @@ class GitGmiRepo:
 
     def view_raw_blob(self, branch: str, location=[]) -> str:
         blob = self.get_blob(branch, location)
+        # if mimetypes can't make out the type, set it to plaintext
         guessed_mimetype = mimetypes.guess_type(blob.name)[0] or "text/plain"
         response = f"{STATUS_SUCCESS} {guessed_mimetype}\n"
         response += blob.data.decode("utf-8")