Metadata-Version: 2.1
Name: durham-directory
Version: 1.2.2
Summary: Python Bindings for the Durham University (UK) Directory
Home-page: https://github.com/2e0byo/durham-directory
License: MIT
Author: John Maximilian
Author-email: 2e0byo@gmail.com
Requires-Python: >=3.9,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: bs4 (>=0.0.1,<0.0.2)
Requires-Dist: lxml (>=4.6.3,<5.0.0)
Requires-Dist: requests (>=2.26.0,<3.0.0)
Project-URL: Repository, https://github.com/2e0byo/durham-directory
Description-Content-Type: text/markdown

# Python bindings for the Durham University (UK) Directory

This package provides basic python bindings for [the Durham University
Directory](https://dur.ac.uk/directory/password), 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

```bash
python -m pip install durham-directory
```

## CLI Usage

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

## API Usage

```python
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:

```python
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.

