A tool to help PADI Scuba Diving Instructors complete the 'Record_and_Referral_Form.pdf'
"PADI® (Professional Association of Diving Instructors®) is the world’s largest ocean exploration and diver organization, operating in 186 countries and territories, with a global network of more than 6,600 dive centers and resorts and over 128,000 professional members worldwide. Issuing more than 1 million certifications each year, and with over 29 million certifications to date". https://www.padi.com/about/who-we-are
The Instructor's Assistant is a user-friendly tool tailored exclusively for PADI Instructors. With its intuitive interface and streamlined functionality, it empowers instructors to effortlessly and efficiently complete the PADI Open Water Student Completion form. Developed as an open-source Windows desktop application, it leverages the power of the Python programming language to provide a seamless experience for instructors in fulfilling their paperwork requirements.
Add, delete and save your instructor details for future use. After your password verification, The Instructor's Assistant will automatically complete the required fields. Keep in mind you will still need to physically sign the Instructor signature fields afterwords.
The user interface allows you to easily toggle single or entire sections on or off. Toggle off the Ocean Dive section with one click for Ocean Referrals for example. Any item in the off position will be unaffected when the Set Date/Dive or Set Instructor button is clicked. When team teaching, use this method to separate Instructor teaching assignments and produce a Record and Referral form with multiple Instructors.
Instructors often complete a number of tasks during the same session. Templates allow Instructors to save these methods to make completing the form even faster.
For “Confined Water One” an Instructor also completes “Knowledge Review Section One”, “200m Swim” and the “10min float” on the same day as a standard practice. After making a template with this parameter, an instructor can deploy the template which will read the date input from “Confined Water One” and automatically update the input dates for “Knowledge Review Section One” and “200 Swim” and “10 minute float”
Save time and with the option to import bulk student information from a course roster excel file.
Use the Set Student Set Instructor and Set Date/Dive buttons to confirm selections prior to pressing the Generate PDF button. The "Set" function will replace the stock text field with the desired text information in red. The red text is an indication to the user what information will be added to the Student Record File and where. To leave any field blank use the toggle button to turn the off desired section prior to using the Set function.
By default the Student Record Files will be saved to the users desktop and generated every time the Generate PDF button is pressed. To change the desired location select the Edit > Choose PDF Save Path Button to set a new save path.
Currently The Instructor's Assistant supports imports from an excel file with the following column headings.
'first_name'
'last_name'
'date_of_birth'
'sex'
'phone'
'email'
'street_address'
'city'
'province'
'postal'
'country'
For the date_of_birth column data can be in either a datetime or string format. If using a string, format date dd/mm/yyyy. See "assets/openwater_diver_course_example_import.xlsx" for an example student import file.
The purpose of a dive template is to make date-pairs for different skills completed on the same day. Each skill with a date has a unique integer code (0 - 27). For example, Confined Water One's code is 0. The user can set other skill boxes to 0 to make a date-pair with Confined Water One. After saving and selecting the template on the Main UI the user can press the Set Template button and the program will read the date for Confined Water One and match each of the corresponding date-pairs. Additionally, users can input Open Water Flexible Dive Completions, choose course options (rdp, erdpml, computer) or toggle any section they want to leave blank.
On the Releases section of this repository there is a Windows Installer users can download. Currently with version 0.1.0, this program is setup up to run on the local users directory and can be downloaded to C:\Users\<username>\AppData\Local\instructor_assistant. A Desktop and Startmenu shortcut is included as well as an Uninstaller.
Note: The Windows Installer doesn't have a Windows Publisher's Certificate which may prompt warnings during install about an unknown publisher. Included on the Release page is a SHA-256 hash digest of the Installer if a user wants to verify data integrity.
The Instructor's Assistant is written in Python. Users can download and run the source code directly on their machine. Below is a list of required libraries for this project.
Babel==2.12.1
customtkinter==5.2.0
darkdetect==0.8.0
et-xmlfile==1.1.0
fillpdf==0.7.2
numpy==1.24.3
openpyxl==3.1.2
pandas==2.0.1
pdf2image==1.16.3
pdfrw2==0.5.0
Pillow==9.5.0
PyMuPDF==1.22.3
python-dateutil==2.8.2
pytz==2023.3
six==1.16.0
tkcalendar==1.6.1
tzdata==2023.3
I hope to continue to develop this tool for the scuba community as I learn more. Please don't hesitate to reach out with any issues or feedback. brendan.development@pm.me