<commit_before>Wand
====

.. image:: https://badge.fury.io/py/Wand.svg?
   :alt: Latest PyPI version
   :target: https://pypi.python.org/pypi/Wand

.. image:: https://readthedocs.org/projects/wand/badge/
   :alt: Documentation Status
   :target: http://docs.wand-py.org/en/latest/

.. image:: https://secure.travis-ci.org/dahlia/wand.svg?branch=master
   :alt: Build Status
   :target: https://travis-ci.org/dahlia/wand

.. image:: https://img.shields.io/coveralls/dahlia/wand.svg?style=flat
   :alt: Coverage Status
   :target: https://coveralls.io/r/dahlia/wand

Wand is a :mod:`ctypes`-based simple ImageMagick_ binding for Python. ::

    from wand.image import Image
    from wand.display import display

    with Image(filename='mona-lisa.png') as img:
        print(img.size)
        for r in 1, 2, 3:
            with img.clone() as i:
                i.resize(int(i.width * r * 0.25), int(i.height * r * 0.25))
                i.rotate(90 * r)
                i.save(filename='mona-lisa-{0}.png'.format(r))
                display(i)

You can install it from PyPI_ (and it requires MagickWand library):

.. sourcecode:: bash

   $ apt-get install libmagickwand-dev
   $ pip install Wand

.. _ImageMagick: http://www.imagemagick.org/
.. _PyPI: https://pypi.python.org/pypi/Wand


Why just another binding?
-------------------------

There are already many MagickWand API bindings for Python, however they
are lacking something we need:

- Pythonic and modern interfaces
- Good documentation
- Binding through :mod:`ctypes` (not C API) --- we are ready to go PyPy!
- Installation using :program:`pip` or :program:`easy_install`


Requirements
------------

- Python 2.6 or higher

  - CPython 2.6 or higher
  - CPython 3.2 or higher
  - PyPy 1.5 or higher

- MagickWand library

  - ``libmagickwand-dev`` for APT on Debian/Ubuntu
  - ``imagemagick`` for MacPorts/Homebrew on Mac
  - ``ImageMagick-devel`` for Yum on CentOS


User's guide
------------

.. toctree::
   :maxdepth: 2

   whatsnew/0.3
   guide/install
   guide/read
   guide/write
   guide/resizecrop
   guide/transform
   guide/draw
   guide/colorspace
   guide/exif
   guide/sequence
   guide/resource<commit_msg>Fix link to what's new guide<commit_after>Wand
====

.. image:: https://badge.fury.io/py/Wand.svg?
   :alt: Latest PyPI version
   :target: https://pypi.python.org/pypi/Wand

.. image:: https://readthedocs.org/projects/wand/badge/
   :alt: Documentation Status
   :target: http://docs.wand-py.org/en/latest/

.. image:: https://secure.travis-ci.org/dahlia/wand.svg?branch=master
   :alt: Build Status
   :target: https://travis-ci.org/dahlia/wand

.. image:: https://img.shields.io/coveralls/dahlia/wand.svg?style=flat
   :alt: Coverage Status
   :target: https://coveralls.io/r/dahlia/wand

Wand is a :mod:`ctypes`-based simple ImageMagick_ binding for Python. ::

    from wand.image import Image
    from wand.display import display

    with Image(filename='mona-lisa.png') as img:
        print(img.size)
        for r in 1, 2, 3:
            with img.clone() as i:
                i.resize(int(i.width * r * 0.25), int(i.height * r * 0.25))
                i.rotate(90 * r)
                i.save(filename='mona-lisa-{0}.png'.format(r))
                display(i)

You can install it from PyPI_ (and it requires MagickWand library):

.. sourcecode:: bash

   $ apt-get install libmagickwand-dev
   $ pip install Wand

.. _ImageMagick: http://www.imagemagick.org/
.. _PyPI: https://pypi.python.org/pypi/Wand


Why just another binding?
-------------------------

There are already many MagickWand API bindings for Python, however they
are lacking something we need:

- Pythonic and modern interfaces
- Good documentation
- Binding through :mod:`ctypes` (not C API) --- we are ready to go PyPy!
- Installation using :program:`pip` or :program:`easy_install`


Requirements
------------

- Python 2.6 or higher

  - CPython 2.6 or higher
  - CPython 3.2 or higher
  - PyPy 1.5 or higher

- MagickWand library

  - ``libmagickwand-dev`` for APT on Debian/Ubuntu
  - ``imagemagick`` for MacPorts/Homebrew on Mac
  - ``ImageMagick-devel`` for Yum on CentOS


User's guide
------------

.. toctree::
   :maxdepth: 2

   whatsnew/0.4
   guide/install
   guide/read
   guide/write
   guide/resizecrop
   guide/transform
   guide/draw
   guide/colorspace
   guide/exif
   guide/sequence
   guide/resource
{'fraction_non_alphanumeric': 0.1475484606613455, 'fraction_numerical': 0.0104903078677309, 'mean_word_length': 2.5485436893203883, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 16, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3340156', 'n_tokens_mistral': 1574, 'n_tokens_neox': 1510, 'n_words': 380}