https://github.com/corey-richardson/certificate-generator
Creates certificates for the Engineers Week 2023 'Young Inventors' Challenge
https://github.com/corey-richardson/certificate-generator
Last synced: 2 months ago
JSON representation
Creates certificates for the Engineers Week 2023 'Young Inventors' Challenge
- Host: GitHub
- URL: https://github.com/corey-richardson/certificate-generator
- Owner: corey-richardson
- Created: 2023-01-13T13:49:09.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-02-16T16:05:46.000Z (over 2 years ago)
- Last Synced: 2025-02-05T14:40:59.995Z (4 months ago)
- Language: Python
- Homepage:
- Size: 7.39 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# generator.py
## Imports
- warnings
- `import warnings`
- Used to disable the 'DeprecationWarning' warning in the terminal. This is definetly not best practice however... oh well.
- pandas
- `import pandas as pd`
- Used to read and manage the user information passed in from `information.csv` as a dataframe.
- os
- `import os`
- Used to open a file explorer instance of the output directory after the certificates have been created.
- pillow
- `from PIL import Image, ImageDraw, ImageFont`
- Used for image manipulation.
- filedialog
- `from tkinter import filedialog as fd`
- Used to select input / output files via GUI
- messagebox
- `from tkinter import messagebox as mb`
- Used to display runtime updates to user in GUI format
---
## Setup Variables
```py
font_name = "WinterSong-owRGB.ttf"
font_size = 200
text_y_pos = 250
tagline_FONT_TYPE = "calibri.ttf"
tagline_font_size = 48
tagline_spacing = 370
PREFIX = "assets/"
FONT_TYPE = PREFIX + font_name
```
Set fonts, text sizes and spacings between lines.
Constants `PREFIX` and `FONT_TYPE` are NOT to be changed.
---
## Main
- Reads "information.csv" into a pandas dataframe
- Error Handling: If the file cannot be found in the current directory then open a file explorer instance for the user to manually select the file.
- Open a file explorer instance for the user to select the output directory.
- For each name in the dataframe, call the function `make_cert()` passing the name in as a parameter.
- Update the information / input CSV file with the file path of the created certificate.
- Show a message box letting the user know the process is completed.
- Opens a file explorer instance of the output directory.
---
## Make Cert[ificate]
- Sets `draw` and `img_width` as global variables to be used in `write_subline()`.
- Opens the base image and saves to `img`.
- Saves the width of the image to `img_width`. This is used when centrally aligning text.
- Creates a 'draw object'.
- Creates a font object with arguments assigned in 'setup variables'.
- Gets the text width of the name. This is used when centrally aligning text.
- Draws the text onto the base image
- Sublines
- Initialises / resets `line_num` to 0.
- Calls `write_subline()` twice^, passing in the text to write and the current line number as arguments.
- This function returns an incremented `line_num` which gets called by the next function call.
- Saves the manipulated image into the 'out' directory.
> ^I have it calling twice. If you want more than two line of text then you will have to call it that many times.
---
## Write Subline
- Creates a font object with arguments assigned in 'setup variables'.
- Gets the text width. This is used to centrally align the text.
- Draws the text onto the image.
- `+ (50*line_num)` for each new line it will add 50 pixels of spacing between the previous line of text. `line_num` is zero indexed.
- Returns `line_num + 1`; this value gets called by the next function call.
---
# add_names.py
```py
# ctrl+c / keyboard interrupt to stop
with open("information.csv","a") as info_file:
while True:
name = input("child first name: ")
guardian_name = input("guardian full name: ")
email = input("email: ")
to_write = f"\n{name.title()},{guardian_name.title()},{email.lower()}"
info_file.write(to_write)
print("added " + to_write)
```
This script is used to write new entries into `information.csv`. Of course this could be done manually but this script produces a consistent format for all entries via data cleansing.