python-redmine 2.5.0

Description:

pythonredmine 2.5.0

Python-Redmine is a library for communicating with a Redmine
project management application. Redmine exposes some of its data via REST API for which Python-Redmine provides
a simple but powerful Pythonic API inspired by a well-known Django ORM:
>>> 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 3.7 - 3.12 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:
$ pip install python-redmine


Pro Edition
License for a Pro Edition can be bought
here.
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
only, while support for Pro Edition is provided both via GitHub
and [email protected]. 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
for details.


Changelog

2.5.0 (2024-03-31)
Deprecations:

Requests version required >= 2.31.0

New Features:

Pro Edition: RedmineUP Products plugin support
Issue copying (see docs for details)
(Issue #203)

Improvements:

Migrated CI to GitHub Actions, also we now test not only on Linux, but on macOS and Windows as well
dir(resource) and list(resource) now also show properties of an object
Support for issues_assigned and issues_authored relations in User object
(Issue #317)
Original filename will be used as a filename for all uploaded files if a path was provided and filename wasn’t set
Pro Edition: Added support for RedmineUP Contact avatar add/update operations
(see docs for details)
Pro Edition: Added support for RedmineUP DealCategory create(), update(), delete() operations
(see docs for details)
Pro Edition: RedmineUP CrmQuery resource now supports invoices and expenses relation attributes
PerformanceWarning will be issued when Python-Redmine does some unnecessary redirects before the actual
request is made

Changes:

Backwards Incompatible: API key is now being sent in the X-Redmine-API-Key header instead of the key GET
parameter which makes things more secure in case of a failed connection, but it might created issues for servers
that don’t do custom request header forwarding by default, so be sure to check your web server before upgrading
(Issue #328 and
Issue #330) (thanks to Tom Misilo
and Ricardo Branco)
Backwards Incompatible: User all operation now really returns all users, i.e. not only active, but locked,
registered and anonymous as well instead of only returning just active users in previous versions due to the
respect to Redmine’s standard behaviour (Issue #327)

Bugfixes:

Tests were failing on Windows OS
Tests were failing on Python 3.12 (Issue #332)
(thanks to Michał Górny)
Some closed Issues weren’t converted to Resource objects using redmine.search()
Pro Edition: RedmineUP Invoice resource order attribute was returned as a dict instead of being converted to
Resource object
Pro Edition: RedmineUP CrmQuery resource deals and contacts relation attributes didn’t work
Pro Edition: RedmineUP DealStatus resource deals relation attribute didn’t work

Documentation:

Mentioned support for author_id in Issue’s resource filter operation



2.4.0 (2023-01-18)
Deprecations:

Requests version required >= 2.28.2
Removed Python 2.7, 3.5, 3.6 support as it’s not supported by Requests anymore
Removed support for python setup.py test as it became deprecated by setuptools

New Features:

Pro Edition: RedmineUP Helpdesk plugin support
(Issue #116)
Pro Edition: RedmineUP Invoices plugin support
(Issue #301)
Timezone support (see docs for details)
(Issue #271)

Improvements:

Added support for Python 3.10, 3.11 and latest PyPy
Added support for allowed_statuses to include param and on demand includes for Issue resource (requires
Redmine >= 5.0.0)
Added support for issue_custom_fields to include param and on demand includes for Project resource (requires
Redmine >= 4.2.0)
Added support for comments and attachments to include param and on demand includes for News resource
(requires Redmine >= 4.1.0)
Pro Edition: Added support for RedmineUP Contact projects to include param and on demand includes for
all() and filter() operations
Pro Edition: Added support for RedmineUP Note create(), update(), delete() operations (see docs for details)
Added support for Project close(), reopen(), archive(), unarchive() operations (see docs for details, requires Redmine >= 5.0.0)
Added support for updating and deleting issue journals (see docs for details, requires Redmine >= 5.0.0)

Changes:

Backwards Incompatible: Switched to pytest instead of nose as nose project is dead
(Issue #312)
Backwards Incompatible: Removed usage of distutils.LooseVersion internally since it became deprecated and
caused warnings, because of that all version info internally is now being represented as tuples and not strings
as before

Bugfixes:

Stop raising ResourceAttrError for attributes that actually exist, but their value is None
(Issue #261)
Pro Edition: RedmineUP Deal resource related_contacts attribute was returned as a list instead of being converted to
ResourceSet object
Project resource default_assignee attribute was returned as a dict instead of being converted to
Resource object
Project resource time_entry_activities attribute was returned as a list instead of being converted to
ResourceSet object

Documentation:

Document requirement of project_id param for query_id filter (Issue #285) (thanks to Doezer)
Mentioned support for user_id in TimeEntry’s resource create/update (Issue #298)
Mentioned support for additional scopes for Search API



2.3.0 (2020-05-21)
Deprecations:

Requests version required >= 2.23.0
Removed Python 3.4 support as it’s not supported by Requests anymore

Improvements:

Support custom filename in redmine.upload()
Support for get() and update() operations for /my/account endpoint which doesn’t require admin
privileges by using me as an id, i.e. redmine.user.get('me') or redmine.user.update('me',firstname='John')
(requires Redmine >= 4.1.0)
News create(), update(), delete() operations support (requires Redmine >= 4.1.0)
ResourceSet’s export() method now supports columns keyword argument which can be either an iterable
of column names, an “all” string which tells Python-Redmine to export all available columns, “all_gui” string
for GUI like behaviour or iterable of elements with “all_gui” string and additional columns to export
Added support for special characters in WikiPage titles (Issue #222) (thanks to Radek Czajka)
Added return_response and ignore_response parameters to engine which allow to skip response processing
and speed up the create/update/delete operation in case response body isn’t needed (see
docs for details)

Bugfixes:

User’s send_information field wasn’t sent correctly to Redmine so account information emails were
never sent (Issue #227) (thanks to
wodny)
Project resource default_version attribute was returned as a dict instead of being converted to
Resource object
Resource object was leaking memory during initialization (Issue #257) (thanks to yihli)

Documentation:

Introduced detailed parameter list for redmine.session
Mentioned support for admin in User’s resource create/update



2.2.1 (2019-02-28)
Bugfixes:

ProjectMembership resource group attribute was returned as a dict instead of being converted to
Resource object (Issue #220) (thanks
to Samuel Harmer)



2.2.0 (2019-01-13)
Deprecations:

Removed vendored Requests package and make it an external dependency as Requests did
the same with its own dependencies
Removed Python 2.6 and 3.3 support as they’re not supported by Requests anymore

Improvements:

PerformanceWarning will be issued when Python-Redmine does some unnecessary work under the hood to fix the
clients code problems

Bugfixes:

Redmine.upload() fails under certain circumstances when used with a file-like object and it contains unicode
instead of bytes (Issue #216)
Redmine.session() doesn’t restore previous engine if fails (Issue #211) (thanks to Dmitry Logvinenko)



2.1.1 (2018-05-02)

Fix PyPI package



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 its 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.99insteadoftheusual24.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.
New Features:

Files API support (Issue #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 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) (thanks to hjpotter92)
Support for retrieving project’s time entry activities (see docs 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) (thanks to dotSlashLu)
Raise ValidationError instead of not helpful TypeError exception when trying to create a WikiPage
resource that already exists (Issue #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
Pro Edition: RedmineUP CRM Contact and Deal resources export functionality didn’t work
Pro Edition: 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) (thanks to 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 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:

Pro Edition: RedmineUP Checklist plugin support
Request Engines 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)
Export functionality (Issue #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)
Pro Edition: RedmineUP CRM Note resource now provides type attribute which shows text representation of type_id
Pro Edition: 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 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)
Unsupported Redmine resource error while trying to use Python-Redmine without installation (Issue #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
Introduction
Request Engines


Added info about Issue Journals (Issue #120)
Added note about open/closed issues (Issue #136)
Added note about regexp custom field filter (Issue #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 (project.url
now uses identifier rather than id to generate url for the project resource)
Fixed: Issue #122 (ValidationError for
empty custom field values was possible under some circumstances with Redmine < 2.5.0)
Fixed: Issue #112 (UnicodeEncodeError
on Python 2 if resource_id was of unicode type) (thanks to Digenis)



1.5.0 (2015-11-26)

Added: Documented support for new fields and values in User, Issue and IssueRelation resources
Added: Issue #109 (Smart imports for
vendored packages (see docs
for details)
Added: Issue #115 (File upload support
for WikiPage resource)



1.4.0 (2015-10-18)

Added: Requests 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 (Tests are now
built-in into source package distributed via PyPI)



1.2.0 (2015-07-09)

Added: wheel support
Added: Issue #93 (JSONDecodeError
exception now contains a response attribute which can be inspected to identify the cause of the
exception)
Added: Issue #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 (Python-Redmine
fails to install on systems with LC_ALL=C) (thanks to spikergit1)



1.1.1 (2015-03-26)

Fixed: Issue #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 (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 for details)
Fixed: Issue #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 (Contact’s
resource tag_list attribute was always splitted into single chars) (thanks to Alexander
Loechel)



1.0.3 (2015-02-03)

Fixed: Issue #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 (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 (TypeError was
raised during processing validation errors from Redmine when one of the errors was returned as
a list)
Fixed: Issue #59 (Raise ForbiddenError
when a 403 is encountered) (thanks to Rick Harris)
Fixed: Issue #64 (Redmine and Resource
classes weren’t picklable) (thanks to Rick Harris)
Fixed: A ResourceSet object with a limit=100, actually returned 125 Resource objects



1.0.1 (2014-09-23)

Fixed: Issue #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 resources:

Contact
ContactTag
Note
Deal
DealStatus
DealCategory
CrmQuery


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 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 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 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
(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 (It was
impossible to create a Project resource via new() method)



0.8.3 (2014-08-01)

Fixed: Issue #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 for details (thanks to
hsum)
Fixed: Issue #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 (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 (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 (File uploads
via update() method didn’t work)



0.7.2 (2014-03-17)

Fixed: Issue #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 (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 its 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 (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 (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
for details)
Fixed: JSONDecodeError was raised in some Redmine versions during some create/update
operations (thanks to 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
for details)
Added: An ability to add/remove watcher to/from issue (see docs for details)
Added: An ability to add/remove users to/from group (see docs 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 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 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)
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 for
details or Issue #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 for details)
Added: Allow daterange TimeEntry resource filtering via from_date and to_date
keyword arguments (thanks to Antoni Aloy)
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 (limit/offset
as keyword arguments were broken)
Fixed: Issue #5 (Version
resource status attribute was converted to IssueStatus resource by mistake) (thanks
to Andrei Avram)
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 (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 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 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 its 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