PyPew

PyPew is a Flask app that helps you generate pew sheets for services using texts from the Book of Common Prayer. You can specify the date of your service, the Feast from which the texts should be used, the hymns to be sung, as well as other details such as the name of the priest, and all this information is assembled into a web page or .docx file for editing or printing.

There is a demonstration deployment at https://jmft2.user.srcf.net/pypew/ but it is also possible to run PyPew as a desktop app.

Running as a Flask app

1. Edit the variables in .env to your taste (the defaults should be reasonable)
2. Install the requirements: pip install -r requirements.txt
3. python pypew.py

This should start up the Flask server as well as automatically opening up your browser to http://localhost:5000.

Packaging

It is also possible to compile binaries for PyPew that can be run without needing Python to be setup.

Windows

1. Set up a Python environment with the required packages: pip install -r requirements.txt

2. pip install pyinstaller

3. Run build.bat to create a folder in dist/pypew, containing the executable pypew.exe as well as all the necessary files and DLLs. (This is rather large as it includes an entire Python distribution as well as packages like Pandas.)

4. If desired, use Advanced Installer to create an .msi that will install PyPew into the 'Program Files' directory, together with shortcuts in the Start Menu.

MacOS

The build.sh script runs PyInstaller to build dist/pypew.app, which may then be put into your 'Applications' directory.

Licensing

PyPew is licensed under the MIT License.

Distributions of the PyPew include extracts from the Book of Common Prayer. Extracts from The Book of Common Prayer, the rights of which are vested in the Crown, are reproduced by permission of the Crown's patentee, Cambridge University Press.

Information about hymns is courtesy of Hymnary.org.