Metadata-Version: 2.1
Name: ptonppl
Version: 0.0.3
Summary: An integration package to lookup Princeton campus users.
Home-page: https://github.com/jlumbroso/ptonppl
License: LGPL-3.0-or-later
Keywords: Princeton,directory
Author: Jérémie Lumbroso
Author-email: lumbroso@cs.princeton.edu
Requires-Python: >=3.6,<4.0
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: backoff (>=1.10.0,<2.0.0)
Requires-Dist: bs4 (>=0.0.1,<0.0.2)
Requires-Dist: click (>=7.1.2,<8.0.0)
Requires-Dist: click-option-group (>=0.5.1,<0.6.0)
Requires-Dist: click_help_colors (>=0.8,<0.9)
Requires-Dist: python-ldap (>=3.3.1,<4.0.0)
Requires-Dist: requests (>=2.24.0,<3.0.0)
Project-URL: Repository, https://github.com/jlumbroso/ptonppl
Description-Content-Type: text/markdown

# ptonppl — Princeton People

This provides a Python package and a command-line tool to lookup the
campus directory of any member of the Princeton community. The package
provides a unified search function that queries the following fields:
- PUID, *e.g.*, `902312554`
- NetID, *e.g.*, `lumbroso`
- Alias, when the user has defined one, *e.g.*, `jeremie.lumbroso`
- Email, *e.g.*, `lumbroso@princeton.edu`

This information is hard to come by consistently, and this tool seeks
to provide a robust interface to the information.

## Installation

The package is distributed on PyPI and can be installed using the usual
tools, such as `pip` or `pipenv`:
```shell
$ pip install --user ptonppl
```

## Help message

```
$ ptonppl --help

Usage: ptonppl [OPTIONS] QUERY...

  Lookup the directory information (PUID, NetID, email, name) of any
  Princeton campus person, using whichever of LDAP, web directory or proxy
  server is available.

Options:
  -f, --format FORMAT  Output format (e.g.: term, json, csv, ...)
  -u, --unique         Filter out duplicate records from the output.
  --version            Show the version and exit.
  --help               Show this message and exit.
```

## License

This project is licensed under the LGPLv3 license, with the understanding
that importing a Python modular is similar in spirit to dynamically linking
against it.

- You can use the library `ptonppl` in any project, for any purpose, as long
  as you provide some acknowledgement to this original project for use of
  the library.

- If you make improvements to `ptonppl`, you are required to make those
  changes publicly available.
