matteob99 / mypolr

Simple Python (2.7, 3.3+) package for using the Polr Project REST API. Has CLI-support (3.4+).

Overview

This package, mypolr, is a python package to easily create and manage short links using the Polr Project's REST API. Mypolr also has CLI support.

User Guide and documentation:

https://mypolr.readthedocs.io

GitHub:

https://github.com/fauskanger/mypolr

Clone source:

git clone git://github.com/fauskanger/mypolr.git

PyPI:

pip install mypolr [ PyPI.org | Legacy ]

---

Project
Git
Statuses

Requirements

Polr Project

Documentation:

https://docs.polrproject.org

To use mypolr, you need a valid API key to a server with the Polr Project installed.

You can obtain the API key by logging in to your Polr site and navigate to <polr project root>/admin#developer.

Note

Disclaimer: This package, mypolr, is not affiliated with the Polr Project.

Python

There is only one requirement:

• requests, an awesome HTTP library. (Documentation).

When installing with pip or conda this will be installed automatically (if not already installed).

Tested on Python 2.7, 3.4+, but should also work with version 3.3.

Installation

With pip:

pip install mypolr

With conda:

conda install -c fauskanger mypolr

ToBeDone

• Add :raises: docstring fields to methods/docs.
• Implement the /data/link-endpoint if necessary.

License

This project is licensed under the MIT Licence. (See link for details.)

Epilogue

This project has served several purposes:

1. Have a tool to easily utilize the Polr Project API from Python.
2. Be an exercise in packaging and distributing Python modules (with pip and conda).
3. Be an exercise in reStructuredText, Sphinx documentation, and ReadTheDocs.
4. Be an exercise in testing Python along best practices and conventions.