durham-directory 1.2.3

Python Bindings for the Durham University (UK) Directory

Python bindings for the Durham University (UK) Directory

This package provides basic python bindings for the Durham University Directory, where Durham University students and staff can look up fellow students and staff.

It is nothing more than a wrapper around requests and bs4, and absolutely nothing clever is being done (although I do think the code is pleasantly simple).

Installation

python -m pip install durham-directory

CLI Usage

durham-directory --help
durham-directory --oname John --surname Morris

API Usage

from durham_directory import Query
query = Query(username="me") # will prompt for password when evaluated
query(oname="John", surname="Morris", type_="any")

Or if you want to choose one result:

from durham_directory import QueryOne
query = QueryOne()
query(oname="John", surname="Morris", type_="any")

We use fuzzy string matching via fuzzywuzzy (ignoring the title) to sort results, as Durham appears to return them bogosorted.

Scripts

An example script parsing a csv extracted from the spreadsheets it seems timetabling send around and printing Org-mode tables is in parse_csv.py.