add_hash.py program

Purpose: to make a unique filename for a PDF, starting with a LaTeX file. The goal is to prevent anyone from guessing how to find alternate versions of the document in the same directory.

To set up:

1. Install Python 3, pip for Python 3, and pyvenv.

2. Install whatever you need for LaTeX. Here we assume you are using Xelatex; if you use pdflatex or lualatex, replace xelatex in the following line of code in add_hash.py:

   subprocess.call(['xelatex', new_filename], stdout=subprocess.DEVNULL)

3. Create and populate a Python virtual environment (one-time step):

   pyvenv v_env3
   . v_env3/bin/activate
   pip install -Ur requirements.txt

4. Activate virtual environment:

   . v_env3/bin/activate
   python add_hash.py <path to .tex file>

   The .tex file should be in a subdirectory, specified in <path to .tex file>. The program will

   2. calculate a hash value of the whole .tex file
   3. generate a PDF of the .tex file using xelatex
   4. append the hash to the filename of the PDF and save it in the main directory
   5. leave the original .tex file untouched in its subdirectory
   6. delete all auxiliary tex files.

5. If a PDF with the expected filename already exists, the program will exit and the files will be untouched.

6. Here is an example file: https://brannerchinese.com/resumes/resume_20150816_458973cad2d3d8aca53d0ea0932ef7bac82b728dfe2a32552c16dbbb2f197251.pdf

[end]