Debian Codegraph @

yarg/release.py

raw
1 # -*- coding: utf-8 -*-
2
3 # (The MIT License)
4 #
5 # Copyright (c) 2014 Kura
6 #
7 # Permission is hereby granted, free of charge, to any person obtaining a copy
8 # of this software and associated documentation files (the 'Software'), to deal
9 # in the Software without restriction, including without limitation the rights
10 # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
11 # copies of the Software, and to permit persons to whom the Software is
12 # furnished to do so, subject to the following conditions:
13 #
14 # The above copyright notice and this permission notice shall be included in
15 # all copies or substantial portions of the Software.
16 #
17 # THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18 # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19 # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
20 # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21 # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
22 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
23 # SOFTWARE.
24
25
26 from datetime import datetime
27
28
29 class Release(object):
30 """
31 A release file from PyPI.
32
33 :param release_id: A release id.
34 :param pypi_dict: A dictionary of a release file.
35 """
36
37 def __init__(self, release_id, pypi_dict):
38 self._release = pypi_dict
39 self._release['release_id'] = release_id
40
41 def __repr__(self):
42 return "<Release {0}>".format(self.release_id)
43
44 @property
45 def release_id(self):
46 """
47 >>> package = yarg.get('yarg')
48 >>> v = "0.1.0"
49 >>> r = package.release(v)
50 >>> r[0].release_id
51 '0.1.0'
52 """
53 return self._release['release_id']
54
55 @property
56 def uploaded(self):
57 """
58 >>> package = yarg.get('yarg')
59 >>> v = "0.1.0"
60 >>> r = package.release(v)
61 >>> r.uploaded
62 datetime.datime(2014, 8, 7, 21, 26, 19)
63 """
64 return datetime.strptime(self._release['upload_time'],
65 '%Y-%m-%dT%H:%M:%S')
66
67 @property
68 def python_version(self):
69 """
70 >>> package = yarg.get('yarg')
71 >>> v = "0.1.0"
72 >>> r = package.release(v)
73 >>> r.python_version
74 '2.7'
75 """
76 return self._release['python_version']
77
78 @property
79 def url(self):
80 """
81 >>> package = yarg.get('yarg')
82 >>> v = "0.1.0"
83 >>> r = package.release(v)
84 >>> r.url
85 'https://pypi.python.org/packages/2.7/y/yarg/yarg...'
86 """
87 return self._release['url']
88
89 @property
90 def md5_digest(self):
91 """
92 >>> package = yarg.get('yarg')
93 >>> v = "0.1.0"
94 >>> r = package.release(v)
95 >>> r.md5_digest
96 'bec88e1c1765ca6177360e8f37b44c5c'
97 """
98 return self._release['md5_digest']
99
100 @property
101 def filename(self):
102 """
103 >>> package = yarg.get('yarg')
104 >>> v = "0.1.0"
105 >>> r = package.release(v)
106 >>> r.filename
107 'yarg-0.1.0-py27-none-any.whl'
108 """
109 return self._release['filename']
110
111 @property
112 def size(self):
113 """
114 >>> package = yarg.get('yarg')
115 >>> v = "0.1.0"
116 >>> r = package.release(v)
117 >>> r.size
118 52941
119 """
120 return self._release['size']
121
122 @property
123 def package_type(self):
124 """
125 >>> package = yarg.get('yarg')
126 >>> v = "0.1.0"
127 >>> r = package.release(v)
128 >>> r.package_type
129 'wheel'
130 """
131 mapping = {'bdist_egg': 'egg', 'bdist_wheel': 'wheel',
132 'sdist': 'source'}
133 ptype = self._release['packagetype']
134 if ptype in mapping.keys():
135 return mapping[ptype]
136 return ptype
137
138 @property
139 def has_sig(self):
140 """
141 >>> package = yarg.get('yarg')
142 >>> v = "0.1.0"
143 >>> r = package.release(v)
144 >>> r.has_sig
145 True
146 """
147 return self._release['has_sig']