• Contributors
• Overview
• Requirements
• Installation
• Usage
  • Using the Driver script
  • Add Recipient
  • Remove Recipient
  • Gather Jobs
  • Notifying Recipients
• Database
• Moving Forward

• Principal Author : William Lake
• PyPi Packaging : Greg Beam

A set of python scripts built to gather State of Montana IT jobs in Helena, MT on behalf of students in the UM Helena IT department, notifying them of a new job if one appears. Job data gathered from the State of Montana's central job site.

• Python >= 3.5
• OS - Tested on:
  • Ubuntu 18.04
  • Windows 10
• Postgresql Database (Written with 11)
  • (Ubuntu Install)[https://www.digitalocean.com/community/tutorials/how-to-install-and-use-postgresql-on-ubuntu-18-04]
  • (Windows Install)[https://www.postgresql.org/download/windows/]

NOTE: This process is to be used during development. When the package is ready for General Availability to the public, a standard pip install <package-name> will be used rather than the -e . convention. Likewise, there will be no need to clone the repository beforehand.

• Language
  • (https://www.python.org/downloads/windows/)[Windows Installer]
  • (https://www.digitalocean.com/community/tutorials/how-to-install-python-3-and-set-up-a-programming-environment-on-ubuntu-18-04-quickstart)[Ubuntu Install]
• Virtual Environment (Optional)
  • (VirtualEnv)[https://virtualenv.pypa.io/en/latest/]
  • (Anaconda)[https://www.anaconda.com/]
  • (Miniconda)[https://docs.conda.io/en/latest/miniconda.html]
• Dependencies
  • All the required modules are outlined in requirements.txt file, and can be installed via pip:

pip install -r requirements.txt

• If you haven't already, download and install Postgresql.
  • (Ubuntu Install)[https://www.digitalocean.com/community/tutorials/how-to-install-and-use-postgresql-on-ubuntu-18-04]
  • (Windows Install)[https://www.postgresql.org/download/windows/]
• Once installed, you'll need to perform some minor database setup. The required changes are outlined in the script job_finder\resources\postgres.sql which can be ran to implement the changes.
  • E.g. sudo -u postgres psql < job_finder/resources/postgres.sql
  • TODO: Need the equivalent command and/or instructions for Windows.

Before it can be used JobFinder needs to create its tables and gather some info needed for sending emails. The process can be started by using the --setup flag:

python job_finder --setup

You will be prompted for the smtp, port, email, and password.

The entry point for the application is aptly called, jobfinder. The purpose of this script is to manage interaction with the parser, recipient, and smtp-sender.

The jobfinder script provides three main functions:

• Add a recipient
• Remove a recipient
• Gather jobs/Review jobs/Notify recipients

Adding recipients is performed via the --add_recip flag:

python job_finder --add_recip test_recip@gmail.com list_of_recips.txt second_recip@mail.com

Notice that both email addresses and .txt files can be provided. The order doesn't matter, they can be intermixed. However, the text files must contain one email per line.

Removing recipients is performed via the --remove_recip flag:

python job_finder --remove_recip test_recip@gmail.com list_of_recips.txt second_recip@mail.com

Notice that both email addresses and .txt files can be provided. The order doesn't matter, they can be intermixed. However, the text files must contain one email per line.

To perform the default Job_Finder functions, you would execute the jobfinder script with no arguments:

# Launch jobfinder to parse jobs, and email recipients

python jobfinder

This repository currently only gathers State of Montana IT Jobs. It would be useful to combine this functionality with jobs gathered from the private and/or non-profit sector.

Additionally, it will likely be useful at some point to provide a web interface to display the currently gathered jobs. This list has some potentially useful apis that could help with this.