Metadata-Version: 1.1
Name: python-redmine
Version: 0.6.0
Summary: Library for communicating with a Redmine project management application
Home-page: https://github.com/maxtepkeev/python-redmine
Author: Max Tepkeev
Author-email: tepkeev@gmail.com
License: Copyright 2014 Max Tepkeev

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Description: Python Redmine
        ==============
        
        .. image:: https://badge.fury.io/py/python-redmine.png
            :target: http://badge.fury.io/py/python-redmine
        
        .. image:: https://pypip.in/d/python-redmine/badge.png
            :target: https://crate.io/packages/python-redmine
        
        .. image:: https://travis-ci.org/maxtepkeev/python-redmine.png?branch=master
            :target: https://travis-ci.org/maxtepkeev/python-redmine
        
        .. image:: https://coveralls.io/repos/maxtepkeev/python-redmine/badge.png?branch=master
            :target: https://coveralls.io/r/maxtepkeev/python-redmine?branch=master
        
        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 redmine 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
            <redmine.resultsets.ResourceSet object with Issue resources>
        
            >>> project.issues[0]
            <redmine.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
            <redmine.resultsets.ResourceSet object with TimeEntry resources>
        
        Features
        --------
        
        * Supports 100% of Redmine API features
        * Supports Python 2.6 - 3.3
        * Extensively documented
        * Provides ORM-style Pythonic API
        
        Dependencies
        ------------
        
        Python Redmine relies heavily on great `Requests <http://docs.python-requests.org>`_
        library by Kenneth Reitz for all the http(s) calls.
        
        Installation
        ------------
        
        To install Python Redmine, simply:
        
        .. code-block:: bash
        
            $ pip install python-redmine
        
        or:
        
        .. code-block:: bash
        
            $ easy_install python-redmine
        
        Documentation
        -------------
        
        Documentation is available at http://python-redmine.readthedocs.org.
        
        Contact and Support
        -------------------
        
        I will be glad to get your feedback, pull requests, issues, whatever. Feel free to contact me for any questions.
        
        Donations
        ---------
        
        If you like this project and want to support it, please `GITTIP <https://www.gittip.com/maxtepkeev/>`_ it's author.
        
        Copyright and License
        ---------------------
        
        Python Redmine is licensed under Apache 2.0 license. Check the `LICENSE
        <https://github.com/maxtepkeev/python-redmine/blob/master/LICENSE>`_ for details.
        
        
        Changelog
        ---------
        
        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 <http://python-redmine.readthedocs.org/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 <http://python-redmine.readthedocs.org/advanced/
          custom_resources.html>`__ for details)
        - Added: An ability to add/remove watcher to/from issue (see `docs
          <http://python-redmine.readthedocs.org/resources/issue.html#watchers>`__ for details)
        - Added: An ability to add/remove users to/from group (see `docs
          <http://python-redmine.readthedocs.org/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 <http://python-redmine.readthedocs.org/operations.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 <http://python-redmine.readthedocs.org/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 <http://python-redmine.readthedocs.org/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
          <http://python-redmine.readthedocs.org/operations.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
          <http://python-redmine.readthedocs.org/operations.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
          <http://python-redmine.readthedocs.org/operations.html#create>`__ 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
        
Keywords: redmine
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Intended Audience :: Developers
Classifier: Environment :: Console
Classifier: Environment :: Web Environment
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
