Mercurial > repos > shellac > sam_consensus_v3

comparison env/lib/python3.9/site-packages/isodate-0.6.0.dist-info/METADATA @ 0:4f3585e2f14b draft default tip

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
"planemo upload commit 60cee0fc7c0cda8592644e1aad72851dec82c959"
author shellac
date Mon, 22 Mar 2021 18:12:50 +0000
parents
children
comparison
equal deleted inserted replaced
-1:000000000000 0:4f3585e2f14b
1 Metadata-Version: 2.0
2 Name: isodate
3 Version: 0.6.0
4 Summary: An ISO 8601 date/time/duration parser and formatter
5 Home-page: https://github.com/gweis/isodate/
6 Author: Gerhard Weis
7 Author-email: gerhard.weis@proclos.com
8 License: BSD
9 Platform: UNKNOWN
10 Classifier: Development Status :: 4 - Beta
11 Classifier: Intended Audience :: Developers
12 Classifier: License :: OSI Approved :: BSD License
13 Classifier: Operating System :: OS Independent
14 Classifier: Programming Language :: Python
15 Classifier: Programming Language :: Python :: 2.6
16 Classifier: Programming Language :: Python :: 2.7
17 Classifier: Programming Language :: Python :: 3.3
18 Classifier: Programming Language :: Python :: 3.4
19 Classifier: Programming Language :: Python :: 3.5
20 Classifier: Programming Language :: Python :: 3.6
21 Classifier: Programming Language :: Python :: Implementation :: PyPy
22 Classifier: Topic :: Internet
23 Classifier: Topic :: Software Development :: Libraries :: Python Modules
24 Requires-Dist: six
25
26
27 ISO 8601 date/time parser
28 =========================
29
30 .. image:: https://travis-ci.org/gweis/isodate.svg?branch=master
31 :target: https://travis-ci.org/gweis/isodate
32 :alt: Travis-CI
33 .. image:: https://coveralls.io/repos/gweis/isodate/badge.svg?branch=master
34 :target: https://coveralls.io/r/gweis/isodate?branch=master
35 :alt: Coveralls
36 .. image:: https://img.shields.io/pypi/v/isodate.svg
37 :target: https://pypi.python.org/pypi/isodate/
38 :alt: Latest Version
39 .. image:: https://img.shields.io/pypi/l/isodate.svg
40 :target: https://pypi.python.org/pypi/isodate/
41 :alt: License
42
43
44 This module implements ISO 8601 date, time and duration parsing.
45 The implementation follows ISO8601:2004 standard, and implements only
46 date/time representations mentioned in the standard. If something is not
47 mentioned there, then it is treated as non existent, and not as an allowed
48 option.
49
50 For instance, ISO8601:2004 never mentions 2 digit years. So, it is not
51 intended by this module to support 2 digit years. (while it may still
52 be valid as ISO date, because it is not explicitly forbidden.)
53 Another example is, when no time zone information is given for a time,
54 then it should be interpreted as local time, and not UTC.
55
56 As this module maps ISO 8601 dates/times to standard Python data types, like
57 *date*, *time*, *datetime* and *timedelta*, it is not possible to convert
58 all possible ISO 8601 dates/times. For instance, dates before 0001-01-01 are
59 not allowed by the Python *date* and *datetime* classes. Additionally
60 fractional seconds are limited to microseconds. That means if the parser finds
61 for instance nanoseconds it will round it to microseconds.
62
63 Documentation
64 -------------
65
66 Currently there are four parsing methods available.
67 * parse_time:
68 parses an ISO 8601 time string into a *time* object
69 * parse_date:
70 parses an ISO 8601 date string into a *date* object
71 * parse_datetime:
72 parses an ISO 8601 date-time string into a *datetime* object
73 * parse_duration:
74 parses an ISO 8601 duration string into a *timedelta* or *Duration*
75 object.
76 * parse_tzinfo:
77 parses the time zone info part of an ISO 8601 string into a
78 *tzinfo* object.
79
80 As ISO 8601 allows to define durations in years and months, and *timedelta*
81 does not handle years and months, this module provides a *Duration* class,
82 which can be used almost like a *timedelta* object (with some limitations).
83 However, a *Duration* object can be converted into a *timedelta* object.
84
85 There are also ISO formatting methods for all supported data types. Each
86 *xxx_isoformat* method accepts a format parameter. The default format is
87 always the ISO 8601 expanded format. This is the same format used by
88 *datetime.isoformat*:
89
90 * time_isoformat:
91 Intended to create ISO time strings with default format
92 *hh:mm:ssZ*.
93 * date_isoformat:
94 Intended to create ISO date strings with default format
95 *yyyy-mm-dd*.
96 * datetime_isoformat:
97 Intended to create ISO date-time strings with default format
98 *yyyy-mm-ddThh:mm:ssZ*.
99 * duration_isoformat:
100 Intended to create ISO duration strings with default format
101 *PnnYnnMnnDTnnHnnMnnS*.
102 * tz_isoformat:
103 Intended to create ISO time zone strings with default format
104 *hh:mm*.
105 * strftime:
106 A re-implementation mostly compatible with Python's *strftime*, but
107 supports only those format strings, which can also be used for dates
108 prior 1900. This method also understands how to format *datetime* and
109 *Duration* instances.
110
111 Installation:
112 -------------
113
114 This module can easily be installed with Python standard installation methods.
115
116 Either use *python setup.py install* or in case you have *setuptools* or
117 *distribute* available, you can also use *easy_install*.
118
119 Limitations:
120 ------------
121
122 * The parser accepts several date/time representation which should be invalid
123 according to ISO 8601 standard.
124
125 1. for date and time together, this parser accepts a mixture of basic and extended format.
126 e.g. the date could be in basic format, while the time is accepted in extended format.
127 It also allows short dates and times in date-time strings.
128 2. For incomplete dates, the first day is chosen. e.g. 19th century results in a date of
129 1901-01-01.
130 3. negative *Duration* and *timedelta* value are not fully supported yet.
131
132 Further information:
133 --------------------
134
135 The doc strings and unit tests should provide rather detailed information about
136 the methods and their limitations.
137
138 The source release provides a *setup.py* script,
139 which can be used to run the unit tests included.
140
141 Source code is available at `<http://github.com/gweis/isodate>`_.
142
143 CHANGES
144 =======
145
146 0.6.0 (2017-10-13)
147 ------------------
148
149 - support incomplete month date (Fabien Loffredo)
150 - rely on duck typing when doing duration maths
151 - support ':' as separator in fractional time zones (usrenmae)
152
153
154 0.5.4 (2015-08-06)
155 ------------------
156
157 - Fix parsing of Periods (Fabien Bochu)
158 - Make Duration objects hashable (Geoffrey Fairchild)
159 - Add multiplication to duration (Reinoud Elhorst)
160
161
162 0.5.1 (2014-11-07)
163 ------------------
164
165 - fixed pickling of Duration objects
166 - raise ISO8601Error when there is no 'T' separator in datetime strings (Adrian Coveney)
167
168
169 0.5.0 (2014-02-23)
170 ------------------
171
172 - ISO8601Error are subclasses of ValueError now (Michael Hrivnak)
173 - improve compatibility across various python variants and versions
174 - raise exceptions when using fractional years and months in date
175 maths with durations
176 - renamed method todatetime on Duraction objects to totimedelta
177
178
179 0.4.9 (2012-10-30)
180 ------------------
181
182 - support pickling FixedOffset instances
183 - make sure parsed fractional seconds are in microseconds
184 - add leading zeros when formattig microseconds (Jarom Loveridge)
185
186
187 0.4.8 (2012-05-04)
188 ------------------
189
190 - fixed incompatibility of unittests with python 2.5 and 2.6 (runs fine on 2.7
191 and 3.2)
192
193
194 0.4.7 (2012-01-26)
195 ------------------
196
197 - fixed tzinfo formatting (never pass None into tzinfo.utcoffset())
198
199
200 0.4.6 (2012-01-06)
201 ------------------
202
203 - added Python 3 compatibility via 2to3
204
205 0.4.5 (2012-01-06)
206 ------------------
207
208 - made setuptools dependency optional
209
210 0.4.4 (2011-04-16)
211 ------------------
212
213 - Fixed formatting of microseconds for datetime objects
214
215 0.4.3 (2010-10-29)
216 ------------------
217
218 - Fixed problem with %P formating and fractions (supplied by David Brooks)
219
220 0.4.2 (2010-10-28)
221 ------------------
222
223 - Implemented unary - for Duration (supplied by David Brooks)
224 - Output fractional seconds with '%P' format. (partly supplied by David Brooks)
225
226 0.4.1 (2010-10-13)
227 ------------------
228
229 - fixed bug in comparison between timedelta and Duration.
230 - fixed precision problem with microseconds (reported by Tommi Virtanen)
231
232 0.4.0 (2009-02-09)
233 ------------------
234
235 - added method to parse ISO 8601 time zone strings
236 - added methods to create ISO 8601 conforming strings
237
238 0.3.0 (2009-1-05)
239 ------------------
240
241 - Initial release
242
243 TODOs
244 =====
245
246 This to do list contains some thoughts and ideas about missing features, and
247 parts to think about, whether to implement them or not. This list is probably
248 not complete.
249
250 Missing features:
251 -----------------
252
253 * time formating does not allow to create fractional representations.
254 * parser for ISO intervals.
255 * currently microseconds are always padded to a length of 6 characters.
256 trailing 0s should be optional
257
258 Documentation:
259 --------------
260
261 * parse_datetime:
262 - complete documentation to show what this function allows, but ISO forbids.
263 and vice verse.
264 - support other separators between date and time than 'T'
265
266 * parse_date:
267 - yeardigits should be always greater than 4
268 - dates before 0001-01-01 are not supported
269
270 * parse_duration:
271 - alternative formats are not fully supported due to parse_date restrictions
272 - standard duration format is fully supported but not very restrictive.
273
274 * Duration:
275 - support fractional years and month in calculations
276 - implement w3c order relation? (`<http://www.w3.org/TR/xmlschema-2/#duration-order>`_)
277 - refactor to have duration mathematics only at one place.
278 - localize __str__ method (does timedelta do this?)
279 - when is a Duration negative?
280 - normalize Durations. months [00-12] and years ]-inf,+inf[
281
282