Question

 Add high level comments throughout the program to explain what each line of code does. Finally, use a diagramming tool (Visio, Lucidchart, MSPaint, paper & pen) to create a flowchart of the code below. 

path = "/Users/user1/data/baby_names/"
myyear = input("Please provide the year to be searched:")
babyname = input("Please provide the baby name to be searched:")
babyname = babyname.capitalize()

baby_counts = count_babies(myyear, babyname)

print("There were {0} boys and {1} girls with that name in {2}".format(
    baby_counts[0], 
    baby_counts[1], 
    myyear))

def count_babies(year, baby):

    file = "yob" + year + ".txt"
    bnames = []

    if file not in os.listdir(path):
        print("These are not the files you are looking for, move along")
        return 0
    else:
        f = open(path + file)
        f.readline()
        
        for each in f:
            fields = each.split(',')
            bnames.append(fields)
        f.close()
        print("Imported " + file)

        mcount = 0
        fcount = 0
        for fields in bnames:
            if baby in fields[0]:
                if 'M' in fields[1]:
                    mcount = int(fields[2])
                else:
                    fcount = int(fields[2])

        return [mcount, fcount]

Answer 1

path = "/Users/user1/data/baby_names/" #its path where all files of baby names stored
myyear = input("Please provide the year to be searched:") #take input from user of the year to be searched
babyname = input("Please provide the baby name to be searched:") # take name from the user to be search in the above path database
babyname = babyname.capitalize() #whatever name has entered by the user it will be stored in the variable babyname and that will be capitalize because all the names
# in the path files have all capital names

baby_counts = count_babies(myyear, babyname) #baby_counts is a variable and count_babies is a function with parameters of year and babyname that is taken from the user

print("There were {0} boys and {1} girls with that name in {2}".format(
baby_counts[0],
baby_counts[1],
myyear))

def count_babies(year, baby): #the user's input will bring here

file = "yob" + year + ".txt" # year of birth + year + txt file extension so eg yob2018.txt where 2018 is the entered by the user
bnames = [] #empty array of bnames

if file not in os.listdir(path): #if yob2018.txt not found on the path then it will print below message
print("These are not the files you are looking for, move along")
return 0
else:
f = open(path + file) #else open the file which is on that file will be opened with file object f
f.readline() # file object with f will read all the lines inside the file
  
for each in f: #there will be names with comma seprated values will be split and append all baby names in the bnames array which is created above
fields = each.split(',') #if , comma found execute below line
bnames.append(fields) # append will store all names without loosing any name
f.close() #at last file will be closed
print("Imported " + file) #print msg with imported and file name

mcount = 0 #variable are initialized with 0
fcount = 0
for fields in bnames: #now bnames have all the names with male female names
if baby in fields[0]:
if 'M' in fields[1]:# if names have the M fields then mcount will be incremented by 1 else fcount will be increment
mcount = int(fields[2])
else:
fcount = int(fields[2])

return [mcount, fcount] #from here it will return the number of male and female names to the baby_counts variable above

if you have any doubt then please ask me without any hesitation in the comment section below , if you like my answer then please thumbs up for the answer , before giving thumbs down please discuss the question it may possible that we may understand the question different way and we can edit and change the answers if you argue, thanks :)