Source code for yarg.release

# -*- coding: utf-8 -*-

# (The MIT License)
#
# Copyright (c) 2014 Kura
#
# Permission is hereby granted, free of charge, to any person obtaining a copy
# of this software and associated documentation files (the 'Software'), to deal
# in the Software without restriction, including without limitation the rights
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
# copies of the Software, and to permit persons to whom the Software is
# furnished to do so, subject to the following conditions:
#
# The above copyright notice and this permission notice shall be included in
# all copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
# SOFTWARE.


from datetime import datetime


class Release(object):
    """
    A release file from PyPI.

    :param release_id: A release id.
    :param pypi_dict: A dictionary of a release file.
    """

    def __init__(self, release_id, pypi_dict):
        self._release = pypi_dict
        self._release['release_id'] = release_id

    def __repr__(self):
        return "<Release {0}>".format(self.release_id)

    @property
    def release_id(self):
        """
            >>> package = yarg.get('yarg')
            >>> v = "0.1.0"
            >>> r = package.release(v)
            >>> r[0].release_id
            u'0.1.0'
        """
        return self._release['release_id']

    @property
    def uploaded(self):
        """
            >>> package = yarg.get('yarg')
            >>> v = "0.1.0"
            >>> r = package.release(v)
            >>> r.uploaded
            datetime.datime(2014, 8, 7, 21, 26, 19)
        """
        return datetime.strptime(self._release['upload_time'],
                                 '%Y-%m-%dT%H:%M:%S')

    @property
    def python_version(self):
        """
            >>> package = yarg.get('yarg')
            >>> v = "0.1.0"
            >>> r = package.release(v)
            >>> r.python_version
            u'2.7'
        """
        return self._release['python_version']

    @property
    def url(self):
        """
            >>> package = yarg.get('yarg')
            >>> v = "0.1.0"
            >>> r = package.release(v)
            >>> r.url
            u'https://pypi.python.org/packages/2.7/y/yarg/yarg...'
        """
        return self._release['url']

    @property
    def md5_digest(self):
        """
            >>> package = yarg.get('yarg')
            >>> v = "0.1.0"
            >>> r = package.release(v)
            >>> r.md5_digest
            u'bec88e1c1765ca6177360e8f37b44c5c'
        """
        return self._release['md5_digest']

    @property
    def filename(self):
        """
            >>> package = yarg.get('yarg')
            >>> v = "0.1.0"
            >>> r = package.release(v)
            >>> r.filename
            u'yarg-0.1.0-py27-none-any.whl'
        """
        return self._release['filename']

    @property
    def size(self):
        """
            >>> package = yarg.get('yarg')
            >>> v = "0.1.0"
            >>> r = package.release(v)
            >>> r.size
            52941
        """
        return self._release['size']

    @property
    def package_type(self):
        """
            >>> package = yarg.get('yarg')
            >>> v = "0.1.0"
            >>> r = package.release(v)
            >>> r.package_type
            u'wheel'
        """
        mapping = {'bdist_egg': u'egg', 'bdist_wheel': u'wheel',
                   'sdist': u'source'}
        ptype = self._release['packagetype']
        if ptype in mapping.keys():
            return mapping[ptype]
        return ptype

    @property
    def has_sig(self):
        """
            >>> package = yarg.get('yarg')
            >>> v = "0.1.0"
            >>> r = package.release(v)
            >>> r.has_sig
            True
        """
        return self._release['has_sig']