Simple Python (2.7, 3.3+) package for using the Polr Project REST API. Has CLI-support (3.4+).
Clone or download
Latest commit 50050bb Nov 27, 2018

README.rst

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 Python versions supported LICENCE
Latest git tag PyPI version conda version Version Scheme
Git Last commit Open issues Close issues
Repo size Repo size
Statuses Status ReadTheDocs.io build status Travis CI build and test status
Wheel support VersionEye dependency watch

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:

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.