Skip to main content
PyCon US is happening May 14th-22nd in Pittsburgh, PA USA.  Learn more

Simple wrapper around the Wordpress REST API

Project description

# Python Wordpress API

[![Pypi][pypi-image]][pypi-url]
[![Updates][pyup-image]][pyup-url]


Simple python wrapper around the Wordpress REST API. Supports authentication using Basic Auth.

All endpoints for the following resources are available:

* Posts
* Media
* Post Types
* Taxonomies
* Categories
* Tags
* Users

These endpoints will be implemented soon:

* Post Revisions
* Pages
* Post Types
* Post Statuses
* Comments

Use the [official api documentation](http://v2.wp-api.org/reference) as reference for what is possible.

## Installation

```
pip install python_wpapi
```

## Usage

```
from python_wpapi import WpApi

api1 = WpApi('http://example.com') # No authentication. Public endpoints only
api2 = WpApi('http://example.com', user='User', password='pwd') # Basic Auth

posts = api1.get_posts()
new_post = api2.create_post(title='Foo', content='Bar')
```

## TODO

* Documentation
* OAuth authentication

## Tests

```
make test
```

* Free software: MIT licensea

[pypi-image]: https://img.shields.io/pypi/v/python_wpapi.svg
[pypi-url]: https://pypi.python.org/pypi/python_wpapi
[pyup-image]: https://pyup.io/repos/github/Lobosque/python_wpapi/shield.svg
[pyup-url]: https://pyup.io/repos/github/Lobosque/python_wpapi/


# History

## 0.3.1 (2017-08-07)

* Fixed bug where GET would send content in the request body.

## 0.2.1 (2016-11-16)

* Converted rst to markdown.

## 0.2.0 (2016-11-16)

* Added test suite.
* Fixed bugs with api exception raising.

## 0.1.0 (2016-11-16)

* First release on PyPI.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page