|Build Status| |Coverage Status|

Abraia API client for Python
============================

Python client for the `Abraia <https://abraia.me>`__ API, used to
smartly transform and optimize (compress) images on-line. Read more at
https://abraia.me/docs.

Installation
------------

Install the API client and CLI with a simple command:

::

    pip install -U abraia

Verify that the abraia CLI is correctly installed:

::

    abraia --version

Configuration
-------------

For configuration you just need to `create an
account <https://abraia.me/login>`__ and introduce the API KEYS using
the command bellow:

::

    abraia configure

Usage
-----

API usage:

The fluent design of the Abraia API makes easy to compress and transform
images. You just need to define the source of the image, the
transformation operation, and the sink for the resultant image.

.. code:: python

    import abraia

    abraia.from_file('images/lion.jpg').resize(
      width=600, height=600).to_file('images/lion_600x600.jpg')
    abraia.from_url('https://abraia.me/images/random.jpg').resize(
      width=600, height=400).to_file('images/random_600x400.jpg')

CLI usage:

With the CLI tool you can compress all the images in a folder with a
simple command:

::

    abraia optimize images

.. figure:: ./images/batch_output.png
   :alt: Resized lion

   Resized lion

Or resize or crop your images and folders:

::

    abraia resize --width 500 images/lion.jpg images/resized.jpg
    abraia resize --width 333 --height 333 images/lion.jpg images/cropped.jpg

|Resized lion| |Cropped lion|

License
-------

This software is licensed under the MIT License. `View the
license <LICENSE>`__.

.. |Build Status| image:: https://travis-ci.org/abraia/abraia-python.svg
   :target: https://travis-ci.org/abraia/abraia-python
.. |Coverage Status| image:: https://coveralls.io/repos/github/abraia/abraia-python/badge.svg?branch=develop
   :target: https://coveralls.io/github/abraia/abraia-python?branch=develop
.. |Resized lion| image:: ./images/resized.jpg
.. |Cropped lion| image:: ./images/cropped.jpg

