python-redmine 2.1.0

Library for communicating with a Redmine project management application

Python-Redmine
==============

.. image:: https://badge.fury.io/py/python-redmine.svg
:target: https://badge.fury.io/py/python-redmine

.. image:: https://img.shields.io/travis/maxtepkeev/python-redmine/master.svg
:target: https://travis-ci.org/maxtepkeev/python-redmine

.. image:: https://img.shields.io/coveralls/maxtepkeev/python-redmine/master.svg
:target: https://coveralls.io/r/maxtepkeev/python-redmine?branch=master

|

**!!!** Until the end of May 2018 - Pro Edition for **14.99$** instead of *24.99$*, more
info `here <https://python-redmine.com/editions.html#pro-edition>`_ **!!!**

Python-Redmine is a library for communicating with a `Redmine <http://www.redmine.org>`_
project management application. Redmine exposes some of it's data via `REST API
<http://www.redmine.org/projects/redmine/wiki/Rest_api>`_ for which Python-Redmine provides
a simple but powerful Pythonic API inspired by a well-known `Django ORM
<https://docs.djangoproject.com/en/dev/topics/db/queries/>`_:

.. code-block:: python

>>> from redminelib import Redmine

>>> redmine = Redmine('http://demo.redmine.org', username='foo', password='bar')
>>> project = redmine.project.get('vacation')

>>> project.id
30404

>>> project.identifier
'vacation'

>>> project.created_on
datetime.datetime(2013, 12, 31, 13, 27, 47)

>>> project.issues
<redminelib.resultsets.ResourceSet object with Issue resources>

>>> project.issues[0]
<redminelib.resources.Issue #34441 "Vacation">

>>> dir(project.issues[0])
['assigned_to', 'author', 'created_on', 'description', 'done_ratio',
'due_date', 'estimated_hours', 'id', 'priority', 'project', 'relations',
'start_date', 'status', 'subject', 'time_entries', 'tracker', 'updated_on']

>>> project.issues[0].subject
'Vacation'

>>> project.issues[0].time_entries
<redminelib.resultsets.ResourceSet object with TimeEntry resources>

Features
--------

* Supports 100% of Redmine API
* Supports external Redmine plugins API
* Supports Python 2.6, 2.7, 3.3 - 3.6, PyPy and PyPy3
* Supports different request engines
* Extendable via custom resources and custom request engines
* Extensively documented
* Provides ORM-style Pythonic API
* And many more...

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

Standard Edition
++++++++++++++++

The recommended way to install is from Python Package Index (PyPI) with `pip <http://www.pip-installer.org>`_:

.. code-block:: bash

$ pip install python-redmine

Pro Edition
+++++++++++

License for a Pro Edition can be bought
`here <https://secure.avangate.com/order/checkout.php?PRODS=4708754&QTY=1&CART=1&CARD=1&DISABLE_SHORT_FORM_MOBILE=1>`_.
You will receive an email with all the details regarding Pro Edition installation process.

Documentation
-------------

Documentation is available at https://python-redmine.com.

Contacts and Support
--------------------

Support for Standard Edition is provided via `GitHub <https://github.com/maxtepkeev/python-redmine/issues>`__
only, while support for Pro Edition is provided both via `GitHub <https://github.com/maxtepkeev/python-redmine/issues>`__
and [e-mail]. Be sure to write from email that was specified during the purchase procedure.

Copyright and License
---------------------

Python-Redmine Standard Edition is licensed under Apache 2.0 license. Python-Redmine Pro Edition is licensed
under the Python-Redmine Pro Edition 1.0 license. Check the `License <https://python-redmine.com/license.html>`_
for details.


Changelog
---------

2.1.0 (2018-05-02)
++++++++++++++++++

This release concentrates mostly on stability and adds small features here and there. Some of them
are backwards incompatible and are marked as such. They shouldn't affect many users since most of
them were used internally by Python-Redmine. A support for the Files API has been finally added, but
please be sure to check it's documentation as the implementation on the Redmine side is horrible and
there are things to keep in mind while working with Files API. Lastly, only until the end of May 2018
there is a chance to buy a Pro Edition for only 14.99$ instead of the usual 24.99$, this is your
chance to get an edition with additional features for a good price and to support the further development
of Python-Redmine, more info `here <https://python-redmine.com/editions.html#pro-edition>`_.

**New Features**:

- Files API support (`Issue #117 <https://github.com/maxtepkeev/python-redmine/issues/117>`__)

**Improvements**:

- *Backwards Incompatible:* ResourceSet's ``filter()`` method became more advanced. It is now possible
to filter on all available resource attributes, to follow resource relationships and apply lookups to
the filters (see `docs <https://python-redmine.com/introduction.html#methods>`__ for details)
- ResourceManager class has been refactored:

* ``manager_class`` attribute on the ``Resource`` class can now be used to assign a separate
``ResourceManager`` to a resource, that allows outsourcing a resource specific functionality to a
separate manager class (see ``WikiPageManager`` as an example)
* *Backwards Incompatible:* ``request()`` method has been removed
* ``_construct_*_url()``, ``_prepare_*_request()``, ``_process_*_response()`` methods have been added
for create, update and delete methods to allow a fine-grained control over these operations

- Ability to upload file-like objects (`Issue #186 <https://github.com/maxtepkeev/python-redmine/issues/
186>`__) (thanks to `hjpotter92 <https://github.com/hjpotter92>`__)
- Support for retrieving project's time entry activities (see `docs <https://python-redmine.com/resources/
project.html#get>`__ for details)
- Attachment ``update()`` operation support (requires Redmine >= 3.4.0)
- ``Resource.save()`` now accepts ``**attrs`` that need to be changed/set and returns ``self`` instead of a
boolean ``True``, which makes it chainable, so you can now do something like ``project.save(name='foo',
description='bar').export('txt', '/home/foo')``
- ``get`` operation support for News, Query, Enumeration, IssueStatus, Tracker, CustomField, ContactTag,
DealStatus, DealCategory and CRMQuery resources
- ``include`` param in ``get``, ``all`` and ``filter`` operations now accepts lists and tuples instead of
comma-separated string which is still accepted for backward compatibility reasons, i.e. one can use
``include=['foo', 'bar']`` instead of ``include='foo,bar'``
- It is now possible to use ``None`` and ``0`` in addition to ``''`` in ``assigned_to_id`` attribute in
Issue resource if an assignee needs to be removed from an issue

**Changes**:

- *Backwards Incompatible:* Issue ``all`` operation now really returns all issues, i.e. both open and closed,
instead of only returning open issues in previous versions due to the respect to Redmine's standard behaviour
- *Backwards Incompatible:* Instead of only returning a token string, ``upload()`` method was modified to return
a dict that contains all the data for an upload returned from Redmine, i.e. id and token for Redmine >= 3.4.0,
token only for Redmine < 3.4.0. Also it is now possible to use this token and pass it using a ``token`` key
instead of the ``path`` key with path to the file in ``uploads`` parameter when doing an upload, this gives
more control over the uploading process if needed
- *Backwards Incompatible:* Removed ``resource_paths`` argument from Redmine object since ``ResourceManager``
now uses a special resource registry, to which, all resources that inherit from any Python-Redmine resource
are being automatically added
- *Backwards Incompatible:* Removed ``container_many`` in favor of ``container_filter``, ``container_create``
and ``container_update`` attributes on ``Resource`` object to allow more fine-grained resource setup
- *Backwards Incompatible:* ``return_raw`` parameter on ``engine.request()`` and ``engine.process_response()``
methods has been removed in favor of ``return_raw_response`` attribute on engine object
- Updated bundled requests library to v2.15.1

**Bugfixes**:

- Support 204 status code when deleting a resource (`Issue #189 <https://github.com/maxtepkeev/python-redmine/
pull/189>`__) (thanks to `dotSlashLu <https://github.com/dotSlashLu>`__)
- Raise ``ValidationError`` instead of not helpful ``TypeError`` exception when trying to create a WikiPage
resource that already exists (`Issue #182 <https://github.com/maxtepkeev/python-redmine/issues/182>`__)
- Enumeration, Version, Group and Notes ``custom_fields`` attribute was returned as a list of dicts instead
of being converted to ``ResourceSet`` object
- Downloads were downloaded fully into memory instead of being streamed as needed
- ``ResourceRequirementsError`` exception was broken since v2.0.0
- RedmineUP CRM Contact and Deal resources export functionality didn't work
- RedmineUP CRM Contact and Deal resources sometimes weren't converted to Resource objects using Search API

**Documentation**:

- Mentioned support for ``generate_password`` and ``send_information`` in User's resource create/update
methods, ``status`` in User's resource update method, ``parent_id`` in Issue's filter method and ``include``
in Issue's all method

2.0.2 (2017-04-19)
++++++++++++++++++

**Bugfixes**:

- Filter doesn't work when there are > 100 resources requested (`Issue #175 <https://github.com/maxtepkeev/
python-redmine/pull/175>`__) (thanks to `niwatolli3 <https://github.com/niwatolli3>`__)

2.0.1 (2017-04-10)
++++++++++++++++++

- Fix PyPI package

2.0.0 (2017-04-10)
++++++++++++++++++

This version brings a lot of new features and changes, some of them are backward-incompatible, so please
look carefully at the changelog below to find out what needs to be changed in your code to make it work
with this version. Also Python-Redmine now comes in 2 editions: Standard and Pro, please have a look at
this `document <https://python-redmine.com/editions.html>`__ for more details. Documentation was
also significantly rewritten, so it is recommended to reread it even if you are an experienced Python-Redmine
user.

**New Features**:

- RedmineUP `Checklist plugin <https://www.redmineup.com/pages/plugins/checklists>`__ support
- `Request Engines <https://python-redmine.com/advanced/request_engines.html>`__ support. It is
now possible to create engines to define how requests to Redmine are made, e.g. synchronous (one by one)
or asynchronous using threads or processes etc
- ``redmine.session()`` context manager which allows to temporary redefine engine's behaviour
- Search API support (`Issue #138 <https://github.com/maxtepkeev/python-redmine/issues/138>`__)
- Export functionality (`Issue #58 <https://github.com/maxtepkeev/python-redmine/issues/58>`__)
- REDMINE_USE_EXTERNAL_REQUESTS environmental variable for emergency cases which allows to use external
requests instead of bundled one even if external requests version is lower than the bundled one
- Wrong HTTP protocol usage detector, e.g. one use HTTP when HTTPS should be used

**Improvements**:

- ResourceSet objects were completely rewritten:

* ``ResourceSet`` object that was already sliced now supports reslicing
* ``ResourceSet`` object's ``delete()``, ``update()``, ``filter()`` and ``get()`` methods have been
optimized for speed
* ``ResourceSet`` object's ``delete()`` and ``update()`` methods now call the corresponding Resource's
``pre_*()`` and ``post_*()`` methods
* ``ResourceSet`` object's ``get()`` and ``filter()`` methods now supports non-integer id's, e.g.
WikiPage's title can now be used with it
* *Backwards Incompatible:* ``ValuesResourceSet`` class has been removed
* *Backwards Incompatible:* ``ResourceSet.values()`` method now returns an iterable of dicts instead of
``ValuesResourceSet`` object
* ``ResourceSet.values_list()`` method has been added which returns an iterable of tuples with Resource
values or single values if flattened, i.e. ``flat=True``

- New ``Resource`` object methods:

* ``delete()`` deletes current resource from Redmine
* ``pre_delete()`` and ``post_delete()`` can be used to execute tasks that should be done before/after
deleting the resource through ``delete()`` method
* ``bulk_decode()``, ``bulk_encode()``, ``decode()`` and ``encode()`` which are used to translate
attributes of the resource to/from Python/Redmine

- Attachment ``delete()`` method support (requires Redmine >= 3.3.0)
- RedmineUP CRM Note resource now provides ``type`` attribute which shows text representation of ``type_id``
- RedmineUP CRM DealStatus resource now provides ``status`` attribute which shows text representation of
``status_type``
- WikiPage resource now provides ``project_id`` attribute
- Unicode handling was significantly rewritten and shouldn't cause any more troubles
- ``UnknownError`` exception now contains ``status_code`` attribute which can be used to handle the
exception instead of parsing code from exception's text
- Sync engine's speed improved to 8-12% depending on the amount of resources fetched

**Changes**:

- *Backwards Incompatible:* Renamed package name from ``redmine`` to ``redminelib``
- Resource class attributes that were previously tuples are now lists
- *Backwards Incompatible:* ``_Resource`` class renamed to ``Resource``
- *Backwards Incompatible:* ``Redmine.custom_resource_paths`` keyword argument renamed to ``resource_paths``
- *Backwards Incompatible:* ``Redmine.download()`` method now returns a `requests.Response
<http://docs.python-requests.org/en/latest/api/#requests.Response>`__ object directly instead of
``iter_content()`` method if a ``savepath`` param wasn't provided, this gives user even more control over
response data
- *Backwards Incompatible:* ``Resource.refresh()`` now really refreshes itself instead of returning a new
refreshed resource, to get the previous behaviour use ``itself`` param, e.g. ``Resource.refresh(itself=False)``
- *Backwards Incompatible:* Removed Python 3.2 support
- *Backwards Incompatible:* Removed ``container_filter``, ``container_create`` and ``container_update`` attributes
on ``Resource`` object in favor of ``container_many`` attribute
- *Backwards Incompatible:* Removed ``Resource.translate_params()`` and ``ResourceManager.prepare_params()`` in
favor of ``Resource.bulk_decode()``
- *Backwards Incompatible:* Removed ``is_unicode()``, ``is_string()`` and ``to_string()`` from
``redminelib.utilities``
- Updated bundled requests library to v2.13.0

**Bugfixes**:

- Infinite loop when uploading zero-length files (`Issue #152 <https://github.com/maxtepkeev/python-redmine/
issues/152>`__)
- Unsupported Redmine resource error while trying to use Python-Redmine without installation (`Issue #156
<https://github.com/maxtepkeev/python-redmine/issues/156>`__)
- It was impossible to set ``data``, ``params`` and ``headers`` via ``requests`` keyword argument on
Redmine object
- Calling ``str()`` or ``repr()`` on a Resource was giving incorrect results if exception raising
was turned off for a resource

**Documentation**:

- Switched to the alabaster theme
- Added new sections:

* `Editions <https://python-redmine.com/editions.html>`__
* `Introduction <https://python-redmine.com/introduction.html>`__
* `Request Engines <https://python-redmine.com/advanced/request_engines.html>`__

- Added info about Issue Journals (`Issue #120 <https://github.com/maxtepkeev/python-redmine/issues/120>`__)
- Added note about open/closed issues (`Issue #136 <https://github.com/maxtepkeev/python-redmine/issues/136>`__)
- Added note about regexp custom field filter (`Issue #164 <https://github.com/maxtepkeev/python-redmine/
issues/164>`__)
- Added some new information here and there

1.5.1 (2016-03-27)
++++++++++++++++++

- Changed: Updated bundled requests package to 2.9.1
- Changed: `Issue #124 <https://github.com/maxtepkeev/python-redmine/issues/124>`__ (``project.url``
now uses ``identifier`` rather than ``id`` to generate url for the project resource)
- Fixed: `Issue #122 <https://github.com/maxtepkeev/python-redmine/issues/122>`__ (``ValidationError`` for
empty custom field values was possible under some circumstances with Redmine < 2.5.0)
- Fixed: `Issue #112 <https://github.com/maxtepkeev/python-redmine/issues/112>`__ (``UnicodeEncodeError``
on Python 2 if ``resource_id`` was of ``unicode`` type) (thanks to `Digenis <https://github.com/Digenis>`__)

1.5.0 (2015-11-26)
++++++++++++++++++

- Added: Documented support for new fields and values in User, Issue and IssueRelation resources
- Added: `Issue #109 <https://github.com/maxtepkeev/python-redmine/issues/109>`__ (Smart imports for
vendored packages (see `docs <https://python-redmine.com/installation.html#dependencies>`__
for details)
- Added: `Issue #115 <https://github.com/maxtepkeev/python-redmine/issues/115>`__ (File upload support
for WikiPage resource)

1.4.0 (2015-10-18)
++++++++++++++++++

- Added: `Requests <http://docs.python-requests.org>`__ is now embedded into Python-Redmine
- Added: Python-Redmine is now embeddable to other libraries
- Fixed: Previous release was broken on PyPI

1.3.0 (2015-10-18)
++++++++++++++++++

- Added: `Issue #108 <https://github.com/maxtepkeev/python-redmine/issues/108>`__ (Tests are now
built-in into source package distributed via PyPI)

1.2.0 (2015-07-09)
++++++++++++++++++

- Added: `wheel <http://wheel.readthedocs.io>`__ support
- Added: `Issue #93 <https://github.com/maxtepkeev/python-redmine/issues/93>`__ (``JSONDecodeError``
exception now contains a ``response`` attribute which can be inspected to identify the cause of the
exception)
- Added: `Issue #98 <https://github.com/maxtepkeev/python-redmine/issues/98>`__ (Support for setting
WikiPage resource parent title and converting parent attribute to Resource object instead of being
a dict)

1.1.2 (2015-05-20)
++++++++++++++++++

- Fixed: `Issue #90 <https://github.com/maxtepkeev/python-redmine/issues/90>`__ (Python-Redmine
fails to install on systems with LC_ALL=C) (thanks to `spikergit1 <https://github.com/spikergit1>`__)

1.1.1 (2015-03-26)
++++++++++++++++++

- Fixed: `Issue #85 <https://github.com/maxtepkeev/python-redmine/issues/85>`__ (Python-Redmine
was trying to convert field to date/datetime even when it shouldn't, i.e. if a field looked like
YYYY-MM-DD but wasn't actually a date/datetime field, e.g. wiki page title or issue subject)

1.1.0 (2015-02-20)
++++++++++++++++++

- Added: PyPy2/3 is now officially supported
- Added: Introduced ``enabled_modules`` on demand include in Project resource
- Fixed: `Issue #78 <https://github.com/maxtepkeev/python-redmine/issues/78>`__ (Redmine <2.5.2
returns only single tracker instead of a list of all available trackers when requested from
a CustomField resource which caused an Exception in Python-Redmine, see `this <http://www.
redmine.org/issues/16739>`__ for details)
- Fixed: `Issue #80 <https://github.com/maxtepkeev/python-redmine/issues/80>`__ (If a project
is read-only or doesn't have CRM plugin enabled, an attempt to add/remove Contact resource
to/from it will lead to improper error message)
- Fixed: `Issue #81 <https://github.com/maxtepkeev/python-redmine/issues/81>`__ (Contact's
resource ``tag_list`` attribute was always splitted into single chars) (thanks to `Alexander
Loechel <https://github.com/loechel>`__)

1.0.3 (2015-02-03)
++++++++++++++++++

- Fixed: `Issue #72 <https://github.com/maxtepkeev/python-redmine/issues/72>`__ (If an exception is
raised during JSON decoding process, it should be catched and reraised as Python-Redmine's own
exception, i.e ``redmine.exceptions.JSONDecodeError``)
- Fixed: `Issue #76 <https://github.com/maxtepkeev/python-redmine/issues/76>`__ (It was impossible
to retrieve more than 100 resources for resources which don't support limit/offset natively by
Redmine, i.e. this functionality is emulated by Python-Redmine, e.g. WikiPage, Groups, Roles etc)

1.0.2 (2014-11-13)
++++++++++++++++++

- Fixed: `Issue #55 <https://github.com/maxtepkeev/python-redmine/issues/55>`__ (TypeError was
raised during processing validation errors from Redmine when one of the errors was returned as
a list)
- Fixed: `Issue #59 <https://github.com/maxtepkeev/python-redmine/issues/59>`__ (Raise ForbiddenError
when a 403 is encountered) (thanks to `Rick Harris <https://github.com/rconradharris>`__)
- Fixed: `Issue #64 <https://github.com/maxtepkeev/python-redmine/issues/64>`__ (Redmine and Resource
classes weren't picklable) (thanks to `Rick Harris <https://github.com/rconradharris>`__)
- Fixed: A ResourceSet object with a limit=100, actually returned 125 Resource objects

1.0.1 (2014-09-23)
++++++++++++++++++

- Fixed: `Issue #50 <https://github.com/maxtepkeev/python-redmine/issues/50>`__ (IssueJournal's
``notes`` attribute was converted to Note resource by mistake, bug was introduced in v1.0.0)

1.0.0 (2014-09-22)
++++++++++++++++++

- Added: Support for the `CRM plugin <https://www.redmineup.com/pages/plugins/crm>`__ resources:

* `Contact <https://python-redmine.com/resources/contact.html>`__
* `ContactTag <https://python-redmine.com/resources/contact_tag.html>`__
* `Note <https://python-redmine.com/resources/note.html>`__
* `Deal <https://python-redmine.com/resources/deal.html>`__
* `DealStatus <https://python-redmine.com/resources/deal_status.html>`__
* `DealCategory <https://python-redmine.com/resources/deal_category.html>`__
* `CrmQuery <https://python-redmine.com/resources/crm_query.html>`__

- Added: Introduced new relations for the following resource objects:

* Project - time_entries, deals, contacts and deal_categories relations
* User - issues, time_entries, deals and contacts relations
* Tracker - issues relation
* IssueStatus - issues relation

- Added: Introduced a ``values()`` method in a ResourceSet which returns ValuesResourceSet - a
ResourceSet subclass that returns dictionaries when used as an iterable, rather than resource-instance
objects (see `docs <https://python-redmine.com/introduction.html#methods>`__ for details)
- Added: Introduced ``update()`` and ``delete()`` methods in a ResourceSet object which allow to
bulk update or bulk delete all resources in a ResourceSet object (see
`docs <https://python-redmine.com/introduction.html#methods>`__ for details)
- Fixed: It was impossible to use ResourceSet's ``get()`` and ``filter()`` methods with WikiPage
resource
- Fixed: Several small fixes and enhancements here and there

0.9.0 (2014-09-11)
++++++++++++++++++

- Added: Introduced support for file downloads (see
`docs <https://python-redmine.com/advanced/working_with_files.html>`__ for details)
- Added: Introduced new ``_Resource.requirements`` class attribute where all Redmine plugins
required by resource should be listed (preparations to support non-native resources)
- Added: New exceptions:

* ResourceRequirementsError

- Fixed: It was impossible to set a custom field of date/datetime type using date/datetime
Python objects
- Fixed: `Issue #46 <https://github.com/maxtepkeev/python-redmine/issues/46>`__
(A UnicodeEncodeError was raised in Python 2.x while trying to access a ``url`` property of
a WikiPage resource if it contained non-ascii characters)

0.8.4 (2014-08-08)
++++++++++++++++++

- Added: Support for anonymous Attachment resource (i.e. attachment with ``id`` attr only)
- Fixed: `Issue #42 <https://github.com/maxtepkeev/python-redmine/issues/42>`__ (It was
impossible to create a Project resource via ``new()`` method)

0.8.3 (2014-08-01)
++++++++++++++++++

- Fixed: `Issue #39 <https://github.com/maxtepkeev/python-redmine/issues/39>`__ (It was
impossible to save custom_fields in User resource via ``new()`` method)

0.8.2 (2014-05-27)
++++++++++++++++++

- Added: ResourceSet's ``get()`` method now supports a ``default`` keyword argument which is
returned when a requested Resource can't be found in a ResourceSet and defaults to ``None``,
previously this was hardcoded to ``None``
- Added: It is now possible to use ``getattr()`` with default value without raising a
``ResourceAttrError`` when calling non-existent resource attribute, see `Issue #30
<https://github.com/maxtepkeev/python-redmine/issues/30>`__ for details (thanks to
`hsum <https://github.com/hsum>`__)
- Fixed: `Issue #31 <https://github.com/maxtepkeev/python-redmine/issues/31>`__ (Unlimited
recursion was possible in some situations when on demand includes were used)

0.8.1 (2014-04-02)
++++++++++++++++++

- Added: New exceptions:

* RequestEntityTooLargeError
* UnknownError

- Fixed: `Issue #27 <https://github.com/maxtepkeev/python-redmine/issues/27>`__ (Project and
Issue resources ``parent`` attribute was returned as a dict instead of being converted to
Resource object)

0.8.0 (2014-03-27)
++++++++++++++++++

- Added: Introduced the detection of conflicting packages, i.e. if a conflicting package is
found (PyRedmineWS at this time is the only one), the installation procedure will be aborted
and a warning message will be shown with the detailed description of the problem
- Added: Introduced new ``_Resource._members`` class attribute where all instance attributes
which are not started with underscore should be listed. This will resolve recursion issues
in custom resources because of how ``__setattr__()`` works in Python
- Changed: ``_Resource.attributes`` renamed to ``_Resource._attributes``
- Fixed: Python-Redmine was unable to upload any binary files
- Fixed: `Issue #20 <https://github.com/maxtepkeev/python-redmine/issues/20>`__ (Lowered
Requests version requirements. Python-Redmine now requires Requests starting from 0.12.1
instead of 2.1.0 in previous versions)
- Fixed: `Issue #23 <https://github.com/maxtepkeev/python-redmine/issues/23>`__ (File uploads
via ``update()`` method didn't work)

0.7.2 (2014-03-17)
++++++++++++++++++

- Fixed: `Issue #19 <https://github.com/maxtepkeev/python-redmine/issues/19>`__ (Resources
obtained via ``filter()`` and ``all()`` methods have incomplete url attribute)
- Fixed: Redmine server url with forward slash could cause errors in rare cases
- Fixed: Python-Redmine was incorrectly raising ``ResourceAttrError`` when trying to call
``repr()`` on a News resource

0.7.1 (2014-03-14)
++++++++++++++++++

- Fixed: `Issue #16 <https://github.com/maxtepkeev/python-redmine/issues/16>`__ (When a resource
was created via a ``new()`` method, the next resource created after that inherited all the
attribute values of the previous resource)

0.7.0 (2014-03-12)
++++++++++++++++++

- Added: WikiPage resource now automatically requests all of it's available attributes from
Redmine in case if some of them are not available in an existent resource object
- Added: Support for setting date/datetime resource attributes using date/datetime Python objects
- Added: Support for using date/datetime Python objects in all ResourceManager methods, i.e.
``new()``, ``create()``, ``update()``, ``delete()``, ``get()``, ``all()``, ``filter()``
- Fixed: `Issue #14 <https://github.com/maxtepkeev/python-redmine/issues/14>`__ (Python-Redmine
was incorrectly raising ``ResourceAttrError`` when trying to call ``repr()``, ``str()`` and
``int()`` on resources, created via ``new()`` method)

0.6.2 (2014-03-09)
++++++++++++++++++

- Fixed: Project resource ``status`` attribute was converted to IssueStatus resource by mistake

0.6.1 (2014-02-27)
++++++++++++++++++

- Fixed: `Issue #10 <https://github.com/maxtepkeev/python-redmine/issues/10>`__ (Python
Redmine was incorrectly raising ``ResourceAttrError`` while creating some resources via
``new()`` method)

0.6.0 (2014-02-19)
++++++++++++++++++

- Added: ``Redmine.auth()`` shortcut for the case if we just want to check if user provided
valid auth credentials, can be used for user authentication on external resource based on
Redmine user database (see `docs <https://python-redmine.com/advanced/external_auth.html>`__
for details)
- Fixed: ``JSONDecodeError`` was raised in some Redmine versions during some create/update
operations (thanks to `0x55aa <https://github.com/0x55aa>`__)
- Fixed: User resource ``status`` attribute was converted to IssueStatus resource by mistake

0.5.0 (2014-02-09)
++++++++++++++++++

- Added: An ability to create custom resources which allow to easily redefine the behaviour
of existing resources (see `docs <https://python-redmine.com/advanced/custom_resources.html>`__
for details)
- Added: An ability to add/remove watcher to/from issue (see `docs
<https://python-redmine.com/resources/issue.html#watchers>`__ for details)
- Added: An ability to add/remove users to/from group (see `docs
<https://python-redmine.com/resources/group.html#users>`__ for details)

0.4.0 (2014-02-08)
++++++++++++++++++

- Added: New exceptions:

* ConflictError
* ReadonlyAttrError
* ResultSetTotalCountError
* CustomFieldValueError

- Added: Update functionality via ``update()`` and ``save()`` methods for resources (see
`docs <https://python-redmine.com/introduction.html#update>`__ for details):

* User
* Group
* IssueCategory
* Version
* TimeEntry
* ProjectMembership
* WikiPage
* Project
* Issue

- Added: Limit/offset support via ``all()`` and ``filter()`` methods for resources that
doesn't support that feature via Redmine:

* IssueRelation
* Version
* WikiPage
* IssueStatus
* Tracker
* Enumeration
* IssueCategory
* Role
* Group
* CustomField

- Added: On demand includes, e.g. in addition to ``redmine.group.get(1, include='users')``
users for a group can also be retrieved on demand via ``group.users`` if include wasn't set
(see `docs <https://python-redmine.com/resources/index.html>`__ for details)
- Added: ``total_count`` attribute to ResourceSet object which holds the total number
of resources for the current resource type available in Redmine (thanks to
`Andrei Avram <https://github.com/andreiavram>`__)
- Added: An ability to return ``None`` instead of raising a ``ResourceAttrError`` for all
or selected resource objects via ``raise_attr_exception`` kwarg on Redmine object (see
`docs <https://python-redmine.com/configuration.html#exception-control>`__ for
details or `Issue #6 <https://github.com/maxtepkeev/python-redmine/issues/6>`__)
- Added: ``pre_create()``, ``post_create()``, ``pre_update()``, ``post_update()`` resource
object methods which can be used to execute tasks that should be done before/after
creating/updating the resource through ``save()`` method
- Added: Allow to create resources in alternative way via ``new()`` method (see `docs
<https://python-redmine.com/introduction.html#new>`__ for details)
- Added: Allow daterange TimeEntry resource filtering via ``from_date`` and ``to_date``
keyword arguments (thanks to `Antoni Aloy <https://github.com/aaloy>`__)
- Added: An ability to retrieve Issue version via ``version`` attribute in addition to
``fixed_version`` to be more obvious
- Changed: Documentation for resources rewritten from scratch to be more understandable
- Fixed: Saving custom fields to Redmine didn't work in some situations
- Fixed: Issue's ``fixed_version`` attribute was retrieved as dict instead of Version resource
object
- Fixed: Resource relations were requested from Redmine every time instead of caching the
result after first request
- Fixed: `Issue #2 <https://github.com/maxtepkeev/python-redmine/issues/2>`__ (limit/offset
as keyword arguments were broken)
- Fixed: `Issue #5 <https://github.com/maxtepkeev/python-redmine/issues/5>`__ (Version
resource ``status`` attribute was converted to IssueStatus resource by mistake) (thanks
to `Andrei Avram <https://github.com/andreiavram>`__)
- Fixed: A lot of small fixes, enhancements and refactoring here and there

0.3.1 (2014-01-23)
++++++++++++++++++

- Added: An ability to pass Requests parameters as a dictionary via ``requests`` keyword
argument on Redmine initialization, i.e. Redmine('\http://redmine.url', requests={}).
- Fixed: `Issue #1 <https://github.com/maxtepkeev/python-redmine/issues/1>`__ (unable
to connect to Redmine server with invalid ssl certificate).

0.3.0 (2014-01-18)
++++++++++++++++++

- Added: Delete functionality via ``delete()`` method for resources (see `docs
<https://python-redmine.com/introduction.html#delete>`__ for details):

* User
* Group
* IssueCategory
* Version
* TimeEntry
* IssueRelation
* ProjectMembership
* WikiPage
* Project
* Issue

- Changed: ResourceManager ``get()`` method now raises a ``ValidationError`` exception if
required keyword arguments aren't passed

0.2.0 (2014-01-16)
++++++++++++++++++

- Added: New exceptions:

* ServerError
* NoFileError
* ValidationError
* VersionMismatchError
* ResourceNoFieldsProvidedError
* ResourceNotFoundError

- Added: Create functionality via ``create()`` method for resources (see `docs
<https://python-redmine.com/introduction.html#id1>`__ for details):

* User
* Group
* IssueCategory
* Version
* TimeEntry
* IssueRelation
* ProjectMembership
* WikiPage
* Project
* Issue

- Added: File upload support, see ``upload()`` method in Redmine class
- Added: Integer representation to all resources, i.e. ``__int__()``
- Added: Informal string representation to all resources, i.e. ``__str__()``
- Changed: Renamed ``version`` attribute to ``redmine_version`` in all resources to avoid
name intersections
- Changed: ResourceManager ``get()`` method now raises a ``ResourceNotFoundError`` exception
if resource wasn't found instead of returning None in previous versions
- Changed: reimplemented fix for ``__repr__()`` from 0.1.1
- Fixed: Conversion of issue priorities to enumeration resource object didn't work

0.1.1 (2014-01-10)
++++++++++++++++++

- Added: Python 2.6 support
- Changed: WikiPage resource ``refresh()`` method now automatically determines it's project_id
- Fixed: Resource representation, i.e. ``__repr__()``, was broken in Python 2.7
- Fixed: ``dir()`` call on a resource object didn't work in Python 3.2

0.1.0 (2014-01-09)
++++++++++++++++++

- Initial release