From 66eacad0fcc7c7038996483a6c8139b7b9ff53ab Mon Sep 17 00:00:00 2001
From: Guido Sterbini <sterbini@hpc-201-11-01-a.cr.cnaf.infn.it>
Date: Mon, 5 Jul 2021 11:30:58 +0200
Subject: [PATCH] cosmetics

---
 tree_maker/repository.py | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/tree_maker/repository.py b/tree_maker/repository.py
index 8e0203f..379817c 100644
--- a/tree_maker/repository.py
+++ b/tree_maker/repository.py
@@ -1,3 +1,6 @@
+'''
+This package helps to create download a update a list of git repository.
+'''
 # conda env export -n base > environment.yml
 # conda env create --prefix /home/HPC/sterbini/test1 -f environment.yml  
 # import git
@@ -10,12 +13,17 @@ from pathlib import Path
 
 # https://stackoverflow.com/questions/14989858/
 def get_hash(repo):
+    ''' Given the repository path it gives the hash of the present git version.'''
     #os.chdir(str(Path(repo).expanduser()))
     return subprocess.check_output([f'git', '-C', f'{str(Path(repo).expanduser())}',
            'rev-parse', 'HEAD'])[0:-1].decode("utf-8") 
 
 
-def create_base(my_base, my_list, verbose=False):
+def create_base(my_list, verbose=False):
+    '''Given a path a list of dictionary containint the *folder_name* and 
+    the *repo* field (address of the repository) it *git clone* the 
+    the repositories (or *git pull* if already cloned). 
+    '''
     for ii in my_list:
         print(f'**** {ii["repo"]} to {ii["folder_name"]} ****')
         if Path(ii["folder_name"]).is_dir():
-- 
GitLab