$"""$

Module that validates the flight school's records.

This is the primary module that does all of the work. It loads the files, loops through

the lessons, and searches for any takeoffs that violate insurance requirements.

Technically, we could have put many of these functions in $\_\_$main$\_\_.$py$.$ That is the

main module of this application anyway. However, for testing purposes we want all

functions in modules and we only want script code in the file $\_\_$main$\_\_.$py

Author: YOUR NAME HERE

Date: THE DATE HERE

$"""$

import utils

import tests

import os$.$path

import violations

# Uncomment for the extra credit

#import endorsements

#import inspections

def discover$\_$violations$($directory$,$output$)$:

$"""$

Searches the dataset directory for any flight lessons the violation regulations.

This function will call list$\_$weather$\_$violations$()$ to get the list of weather violations.

If list$\_$endorsment$\_$violations $($optional$)$ is completed, it will call that too, as

well as list$\_$inspection$\_$violations. It will concatenate all of these $2$d lists

into a single $2$d list of violations $($so a flight may be listed more than once for

each of the three types of violations$).$

If the parameter output is not None, it will create the CSV file with name output

and write the $2$d list of violations to this file. This CSV file should have the

following header:

STUDENT,AIRPLANE,INSTRUCTOR,TAKEOFF,LANDING,FILED,AREA,REASON

Regardless of whether output is None, this function will print out the number of

violations, as follows:

$\text{'}23$ violations found.$\text{'}$

If no violations are found, it will say

$\text{'}$No violations found.$\text{'}$

Parameter directory: The directory of files to audit

Precondition: directory is the name of a directory containing the files 'daycycle.json',

'weather.json', 'minimums.csv$\text{'},$ 'students.csv$\text{'},$ 'teachers.csv$\text{'},$ 'lessons.csv$\text{'},$

'fleet.csv$\text{'},$ and 'repairs.csv$\text{'}.$

Parameter output: The CSV file to store the results

Precondition: output is None or a string that is a valid file name

$"""$

list$\_$weather$\_$violations $=$ violations.list$\_$weather$\_$violations$($directory$)$

total$\_$violations $=$ len$($list$\_$weather$\_$violations$)$

if total$\_$violations $==0$:

print$(\text{'}$No violations found.$\text{'})$

else:

violation$\_$violations $=$ 'violation' if total$\_$violations $==1$ else 'violations'

print $($f$\text{'}\{$total$\_$violations$\}\{$violation$\_$violations$\}$ found.$\text{'})$

if output is not None:

header $=["$STUDENT$",$"AIRPLANE","INSTRUCTOR","TAKEOFF","LANDING","FILED","AREA","REASON"$]$

utils.write$\_$csv$([$header$]+$ list$\_$weather$\_$violations, output$)$

def execute$($args$)$:

$"""$

Executes the application or prints an error message if executed incorrectly.

The arguments to the application $($EXCLUDING the application name$)$ are provided to

the list args. This list should contain either $1$ or $2$ elements. If there is one

element, it should be the name of the data set folder or the value $\text{'}--$test'. If

there are two elements, the first should be the data set folder and the second

should be the name of a CSV file $($for output of the results$).$

If the user calls this script incorrectly $($with the wrong number of arguments$),$ this

function prints:

Usage: python auditor dataset $[$output$.$csv$]$

This function does not do much error checking beyond counting the number of arguments.

Parameter args: The command line arguments for the application $($minus the application name$)$

Precondition: args is a list of strings

$"""$

folders $=[\text{'}$KITH$-2017\text{'},$ 'KITH$-2018\text{'},$ 'KITH$-2019\text{'}]$

n $=$ len$($args$)$

if n $!=1$ and n $!=2$:

print$("$Usage: python auditor dataset $[$output$.$csv$]")$

return

if n $==1$:

if args$[0]==\text{'}--$test':

tests.test$\_$all$()$

else:

print$("$Folder name:", args$[0])$

else:

folder$\_$name $=$ args$[0]$

csv$\_$file$\_$name $=$ args$[1]$

if csv$\_$file$\_$name is not None and csv$\_$file$\_$name $!=\text{'}--$test' and not csv$\_$file$\_$name.endswith$(\text{'}.$csv$\text{'})$:

print$(\text{'}$Usage: python auditor dataset $[$output$.$csv$]\text{'})$

discover$\_$violations$($folder$\_$name, None$)$

print$(\text{'}$Usage: python auditor dataset $[$output$.$csv$]\text{'})$