iland-sdk 0.7.5

iland cloud Python SDK

===============================
iland-sdk
===============================

.. image:: https://img.shields.io/pypi/v/iland-sdk.svg
:target: https://pypi.python.org/pypi/iland-sdk

.. image:: https://travis-ci.org/ilanddev/python-sdk.svg?branch=master
:target: https://travis-ci.org/ilanddev/python-sdk

.. image:: https://readthedocs.org/projects/iland-sdk/badge/?version=latest
:target: https://iland-sdk.readthedocs.org/en/latest/
:alt: Documentation Status

.. image:: https://requires.io/github/ilanddev/python-sdk/requirements.svg?branch=master
:target: https://requires.io/github/ilanddev/python-sdk/requirements/?branch=master
:alt: Requirements Status


iland cloud Python SDK

* Free software: BSD License
* Documentation: https://iland-sdk.readthedocs.org.
* iland cloud API doc: https://api.ilandcloud.com.

============
Introduction
============

This library provides a pure Python interface for the `iland cloud API
<https://www.iland.com/>`_. It works with Python versions from 2.7+.

`iland cloud <http://www.iland.com>`_ provides Enterprise-grade IaaS and this
library is intended to make it even easier for Python programmers to use.

================
Getting the code
================

The code is hosted at https://github.com/ilanddev/python-sdk

Check out the latest development version anonymously with::

$ git clone https://github.com/ilanddev/python-sdk.git
$ cd python-sdk

============
Installation
============

At the command line::

$ pip install iland-sdk

Or, if you have virtualenvwrapper installed::

$ mkvirtualenv iland-sdk
$ pip install iland-sdk

You can also install iland-sdk using the actual source checkout::

$ git clone https://github.com/ilanddev/python-sdk.git

$ cd python-sdk

$ pip install -e .

=============
Running Tests
=============

To run the unit tests::

$ make test

To run the unit tests for all supported Python interpreters::

$ make test-all

To check your changes before submitting a pull request::

$ make lint

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage


=======
History
=======

0.7.5 (2017-06-27)
------------------

* Force iland API v0.8.
* Update dev requirements.
* Dependencies definition shared with `setup.py`
* Add support for passing additional headers with api requests.

0.7.4 (2017-05-26)
------------------

* Use a `requests.Session` object for all api calls
* Remove `base_url`, `access_token_url`, and `verify_ssl` from Api constructor

0.7.3 (2017-05-18)
------------------

* Fix internal use of `REFRESH_URL` when overriding `access_token_url` at \
constructor time.

0.7.2 (2017-05-17)
------------------

* optional `access_url_token` `Api` constructor param allowing one to override
token exchange URL.
* update dependencies.
* lower required version of `requests` module from `==2.14.2` to `>=2.2.1`.

0.7.1 (2017-02-08)
------------------

* update outdated dependencies
* drop Python 3.3 support "just like everybody"
* update token exchange endpoint. We keeping BBB for old client implementations

0.7.0 (2016-10-13)
------------------

* update token exchange endpoint. We keeping BBB for old client implementations
* update requests lib
* update dev dependencies
* promote to stable

0.6.0 (2016-6-28)
-----------------

* update dependencies
* default resource path update

0.5.0 (2016-3-22)
-----------------

* promote to beta status
* extra `verify_ssl` `Api` constructor to allow one to not verify endpoints SSL

0.4.0 (2016-3-08)
-----------------

* support 204 no content HTTP return code
* fix naming of _validate_token method
* update Sphynx dependency
* full unit tests coverage
* fix return on POST, PUT and DELETE operations
* fix use of custom BASE API URL

0.3.0 (2016-2-18)
-----------------

* implement exceptions handling
* docstrings and documentation
* Housekeeping and refactoring
* Better CI setup
* Sphynx doc and readthedocs.org publishing.

0.2.0 (2016-2-09)
-----------------

* Minor fixes.

0.1.0 (2016-2-09)
-----------------

* First release on PyPI.