https://github.com/inductivekickback/smiles
An application for filling in Eugene School District 4j mileage expense forms
https://github.com/inductivekickback/smiles
Last synced: 5 months ago
JSON representation
An application for filling in Eugene School District 4j mileage expense forms
- Host: GitHub
- URL: https://github.com/inductivekickback/smiles
- Owner: inductivekickback
- License: agpl-3.0
- Created: 2024-08-18T00:48:24.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-03-06T05:21:29.000Z (over 1 year ago)
- Last Synced: 2025-03-06T06:26:03.181Z (over 1 year ago)
- Language: Python
- Homepage:
- Size: 9.92 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
This application gives Eugene School District 4j employees a convenient way to fill in mileage expense reports. It was created by Rebecca Medley on the Mentor Team.
---
### Features
- Parses the table of 'official' distances between buildings that is embedded in the mileage form itself
- A vanilla copy of the mileage form is bundled with the application and a new PDF is created every time it's filled in -- this precludes annoying errors that can happen when the same PDF is edited multiple times.
- Auto-complete is enabled for school and purpose columns
- Documents can be opened and saved to allow for incremental progress before creating the final PDF
### Releases
The [current macOS version](https://github.com/inductivekickback/smiles/releases/) is tested on Big Sur and newer (Intel and Apple silicon). It's not a problem if your IT department prevents you from dragging things to the Applications folder -- drag this to your Desktop and run it from there instead.
### Building
This application relies on the [pyqt6](https://pypi.org/project/PyQt6/), [pymupdf](https://pypi.org/project/PyMuPDF/), and [pyinstaller](https://pypi.org/project/pyinstaller/) projects. It was built with Python 3.8 but later Python versions are probably fine. The recommended process is to clone the repository and then:
```
$ python3 -m venv smiles/venv
$ cd smiles
$ source venv/bin/activate
$ pip install --upgrade pip
$ pip install -r requirements.txt
```
It can be run directly from the command line. Specify an optional document to open when starting:
```
$ python3 smiles.py PATH-TO-DOCUMENT
```
Use pyinstaller to build the macOS bundle:
```
$ pyinstaller smiles.spec
```