Package: poetpy
# Poetpy[![Documentation Status](https://readthedocs.org/projects/poetpy/badge/?version=latest)](https://poetpy.readthedocs.io/en/latest/?badge=latest)
[![Build Status](https://travis-ci.org/aschleg/poetpy.svg?branch=master)](https://travis-ci.org/aschleg/poetpy)
[![Build status](https://ci.appveyor.com/api/projects/status/jprq31sokv9rlbuh?svg=true)](https://ci.appveyor.com/project/aschleg/poetpy)
[![Codacy Badge](https://api.codacy.com/project/badge/Grade/7abf894070ba46418181f9d07af68838)](https://www.codacy.com/app/aschleg/poetpy?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=aschleg/poetpy&amp;utm_campaign=Badge_Grade)
[![Coverage Status](https://coveralls.io/repos/github/aschleg/poetpy/badge.svg?branch=master)](https://coveralls.io/github/aschleg/poetpy?branch=master)
![https://pypi.org/project/poetpy/](https://img.shields.io/badge/pypi%20version-1.1.1-blue.svg)
![https://pypi.org/project/petpy/](https://img.shields.io/badge/python-3.4%2C%203.5%2C%203.6%2C%203.7-blue.svg)Python wrapper of the [PoetryDB API](http://poetrydb.org/).## Installationpoetpyis must easily installed usingpip.~~~ python
pip install poetpy
~~~Otherwise, the project repository can be download and installed through invoking thepython installcommand.~~~ python
python setup.py install
~~~## ExamplesExtracting poetry and poets from the PoetryDB API requires at least oneinput_termparameter. Theinput_termparameter results can be further refined with a corresponding
search term. For example, let’s say we are interested in finding all of William Shakespeare’s
poems and sonnets available in the PoetryDB API.~~~ python
w = poetpy.get_poetry(‘author’, ‘William Shakespeare’)
~~~In the above example, theinput_termis ‘author’ and the author we are interested
in finding is ‘William Shakespeare’.If we wanted to only output the lines and line counts of all of Shakespeare’s poetry and sonnets,
we can use theoutputparameter to narrow the returned results.~~~ python
w = poetpy.get_poetry(‘author’, ‘William Shakespeare’, ‘lines,linecounts’)
~~~The default output format from the PoetryDB API is JSON; however, we can change the
output to text by specifying theoutput_formatparameter.~~~ python
w = poetpy.get_poetry(‘author’, ‘William Shakespeare’, ‘lines,linecounts’, ‘text’)
~~~The output text format will be newline escaped.Combination searches are also allowed to enable users to further refine the returned search results.
Eachinput_termshould be given a corresponding search term delimited by a semi-colon. For example,
let’s say we want to find all of []John Milton’s](https://en.wikipedia.org/wiki/John_Milton) poetry
with [Paradise Lost](https://en.wikipedia.org/wiki/Paradise_Lost) in the title.~~~ python
get_poetry(‘title,author’, ‘Paradise Lost;Milton’)
~~~Differentinput_termparameter combinations can also be performed. Taking the above example,
let’s say we are actually only interested in finding Wordworth’s poemI Wandered Lonely As A Cloud.~~~ python
w = poetpy.get_poetry(‘author,title’, ‘William Shakespeare;I Wandered Lonely As A Cloud’)
~~~## Further Examples and Notebooks[![Binder](https://mybinder.org/badge.svg)](https://mybinder.org/v2/gh/aschleg/poetpy/master?filepath=notebooks)A set of [Jupyter Notebooks](http://jupyter.org/) that further explore the potential usage ofpoetpyand the PoetryDB API. The notebooks can also be opened interactively using [binder](https://mybinder.org/)[Introduction topoetpy](https://github.com/aschleg/poetpy/blob/master/notebooks/Introduction%20to%20Poetpy.ipynb)[Building a Poetry Database inPostgreSQLwith Python,poetpy,pandasandsqlalchemy](https://github.com/aschleg/poetpy/blob/master/notebooks/Building%20a%20Poetry%20Database%20in%20PostgreSQL%20with%20Python%2C%20poetpy%2C%20pandas%20and%20sqlalchemy.ipynb)## RequirementsPython 3.4+requests >= 2.18## See Also[PoetryDB](https://github.com/thundercomb/poetrydb) Github page with more information
regarding the implementation and design of PoetryDB and its API. The README of the
repository also contains other examples for working with the API (though not in Python).## About PoetryDB[PoetryDB](http://poetrydb.org/index.html) was created and is currently maintained by
[@thundercomb](https://twitter.com/thundercomb). They blog about poetry and related technology and
other topics at [thecombedthunderclap.blogspot.com](http://thecombedthunderclap.blogspot.com/).Please note, I am in no way affiliated with the creator of PoetryDB. My intention withpoetpyis to
help spread the word and hopefully increase interest in poetry and related projects that attempt to
create comprehensive databases of publicly available knowledge.## LicenseGPL-2.0