Metadata-Version: 2.4
Name: django-cropduster
Version: 4.15.0
Summary: Django image uploader and cropping tool
Author-email: The Atlantic <programmers@theatlantic.com>
License: BSD-2-Clause
Project-URL: Homepage, https://github.com/theatlantic/django-cropduster
Project-URL: Issues, https://github.com/theatlantic/django-cropduster/issues
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Framework :: Django
Classifier: Framework :: Django :: 2.2
Classifier: Framework :: Django :: 3.2
Classifier: Framework :: Django :: 4.2
Classifier: Framework :: Django :: 5.0
Classifier: Framework :: Django :: 5.1
Classifier: Framework :: Django :: 5.2
Requires-Python: >=3.8
Description-Content-Type: text/x-rst
License-File: LICENSE
License-File: LICENSE.Jcrop.txt
Requires-Dist: Pillow
Requires-Dist: python-xmp-toolkit
Requires-Dist: django-generic-plus>=2.0.3
Dynamic: license-file

django-cropduster
#################

**django-cropduster** is a project that makes a form field available
that uses the `Jcrop jQuery
plugin <https://github.com/tapmodo/Jcrop>`_. It is a drop-in
replacement for django's ``ImageField`` and allows users to generate
multiple crops from images, using predefined sizes and aspect ratios.
**django-cropduster** was created by developers at `The
Atlantic <http://www.theatlantic.com/>`_. It is compatible with python
2.7 and 3.4, and Django versions 1.4 - 1.8.

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

The recommended way to install django-cropduster is from
`PyPI <https://pypi.python.org/pypi/django-cropduster>`_::

        pip install django-cropduster

Alternatively, one can install a development copy of django-cropduster
from source::

        pip install -e git+git://github.com/theatlantic/django-cropduster.git#egg=django-cropduster

If the source is already checked out, use setuptools::

        python setup.py develop

Configuration
=============

To enable django-cropduster, ``"cropduster"`` must be added to
``INSTALLED_APPS`` in settings.py and you must include
``cropduster.urls`` in your django urlpatterns.

::

    # settings.py

    INSTALLED_APPS = (
        # ...
        'cropduster',
    )

    # urls.py

    urlpatterns = patterns('',
        # ...
        url(r'^cropduster/', include('cropduster.urls')),
    )

License
=======

The django code is licensed under the `Simplified BSD
License <http://opensource.org/licenses/BSD-2-Clause>`_. View the
``LICENSE`` file under the root directory for complete license and
copyright information.

The Jcrop jQuery library included is used under the `MIT
License <https://github.com/tapmodo/Jcrop/blob/master/MIT-LICENSE.txt>`_.
