8 * Fix previous release's style breaking in ASN.1 browser.
14 * Append offsets to tree elements in ASN.1 browser for ease of navigation.
20 * Trivial documentation fixes.
26 * Workability under Microsoft Windows OS should be restored: it has
27 different ``mmap`` constants and implementation, preventing
28 ``pyderasn`` importing
34 * **Incompatible** change: explicitly check that only naive datetime
35 objects are used for UTCTime and GeneralizedTime, raise an error
36 otherwise. Previously they silently ignored ``tzinfo``
42 * Strictly check that tag's long encoded form does not contain leading zero
44 * Strictly check that tag's long form is used in expected way for small values
51 * Proper strict alphabet validation of VisibleString
52 * VisibleString and IA5String also have ``allowable_chars`` property
53 * Fixed TeletexString, T61String use ``iso-8859-1`` encoding (instead of
54 ``ascii``), because they are 8-bit encodings
60 * Also print full TLVlen in ASN.1 browser
67 * Fix DEFINED BY pprinting when invoking as __main__ module
68 * Integer has ``tohex()`` for getting hexadecimal representation of its value
69 * ``hexdump()`` (``hexdump -C`` like output) and ``ascii_visualize()``
70 (visualize ASCII printable characters, like in ``hexdump -C``) pretty
71 printing functions appeared
72 * Experimental ASN.1 interactive terminal browser (``--browse`` and
74 You will need `urwid package <http://urwid.org/>`__ to use it
81 * SEQUENCE/SET fully performs default value existence validation in
82 evgen mode, by the cost of DEFAULTed value full decoding. That should
83 not be the problem, as DEFAULTs are relatively small in practice. Now
84 evgen mode has the same DER validation strictness as an ordinary one
91 * Restored workability of some command line options
92 * 2-pass DER encoding mode with very little memory footprint
105 * Fixed invalid behaviour where SET OF allowed multiple objects with the
106 same tag to be successfully decoded
107 * Fixed possibly invalid SET DER encoding where objects were not sorted
108 by tag, but by encoded representation
109 * ``Any`` does not allow empty data value now. Now it checks if it has
111 * ``SetOf`` is not treated as ready, if no value was set and minimum
112 bounds are greater than zero
113 * ``Any`` allows an ordinary ``Obj`` storing, without its forceful
114 encoded representation storage. That is required for CER encoding
115 mode, where we do not know in advance what encoding will be used
116 * ``ObjectIdentifier`` stores values as C unsigned long integer,
117 forbidding storage of huge integers, that must not be a problem in
119 * Initial support for so called ``evgen_mode``: event generation mode,
120 where no in-memory objects storing happens, giving ability to process
121 ASN.1 data without fully parsing it first. ``python -m pyderasn`` has
122 ``--evgen`` mode switcher
123 * Useful ``agg_octet_string`` that is able to streamingly decode string
124 from events of ``evgen_mode``, allowing strings retrieving without
125 copying them to memory first
126 * Initial experimental CER encoding mode, allowing streaming encoding of
127 the data directly to some writeable object
128 * Ability to use mmap-ed memoryviews to skip files loading to memory
129 * Ability to use memoryview as an input for \*Strings. If they are
130 mmap-ed, then you can encode any quantities of data streamingly
131 without copying to memory
137 * Fixed workability under Python 3.5. Previously only 2.7 and 3.6
144 * Python ``int()``'s accepts even more various non-decimal characters
145 than expected. Make validation fully strict in UTCTime and
146 GeneralizedTime, without relying on ``int()``
152 * UTCTime and GeneralizedTime allowed values to have plus sign in them,
153 passing ``int()`` check successfully. Prohibit that incorrect behaviour
154 * UTCTime and GeneralizedTime BER decoding support
155 * Faster UTCTime and GeneralizedTime decoding, and slightly better
157 * Workability under Cython
158 * Explicitly Check that all ObjectIdentifier arcs are non-negative
164 * ``.copy()`` method removed: ``copy.copy()`` is preferred way to copy
166 * Copies made previously with ``.copy()`` lacked ``.defined`` field,
168 * All objects are friendly to ``pickle`` libraries
169 * PrintableString has ``allow_asterisk`` and ``allow_ampersand``
171 * ``.hexencode()``, ``.hexdecode()`` and ``.hexdecod()`` methods
172 appeared, working with hexadecimal encoded data
178 * Convenient ``.decod()`` method, that raises if tail is not empty
179 * Control characters (like newlines) of text fields in pprinted output
181 * Ability to allow asterisk and ampersand characters
182 (``allow_asterisk``, ``allow_ampersand`` kwargs) in PrintableString,
183 that unfortunately could be met in X.509 certificates
189 * PEP-396 compatible module's ``__version__``
195 * Do not shadow underlying DecodeError during decoding of optional
202 * Forbid any later GNU GPL version autousage (project's licence now is
204 * Fix ``defines_by_path`` context option usage example
210 * Fix fallbacked ``colored()`` function workability,
211 if no ``termcolor`` is installed
217 * Fix empty ``--oids`` workability
223 * Ability to specify multiple OID mappings for pprinted output
224 (``oids`` keyword argument is renamed to ``oid_maps``)
230 * Minor decode speed improvements
231 * Much faster UTCTime/GeneralizedTime decoders
232 * Stricter UTCTime/GeneralizedTime DER encoding check: trailing zeroes
234 * Valid DER encoding of GeneralizedTime with microseconds: no trailing
241 * ObjectIdentifier has ``ber_encoded`` set to True, if non-normalized
243 * Preserve BER-related attributes during ``copy()``
249 * Added `COMPLI <https://github.com/YuryStrozhevsky/asn1-test-suite>`__
250 ASN.1:2008 test suite. PyDERASN passes it (except for REAL values),
251 but it is more strict sometimes and aimed to be compliant with X.690-201508
252 * Check for arc values normalization in ObjectIdentifier.
253 Forbid non-normalized in DER encoding
259 * ``ctx`` parameter can be safely used in .decode() and won't be muted
260 * PP nametuple contains reference to the ASN1Obj itself
261 * ``colonize_hex`` function useful for pretty printing
262 * Integer values are also pretty printed in hexadecimal form
268 * All errors are inherited from ASN1Error class
269 * NumericString/PrintableString has ``allowable_chars`` property holding
270 all allowed characters
276 * Fix NumericString: space is allowed character
277 * Strict PrintableString sanitizing
283 * Removed ``lenindef``, ``ber_encoded`` attributes from the Choice --
284 they must be taken from underlying value, as Choice does not have its
286 * Do not yield extra EOC PP for Any, having indefinite length encoding
287 and containing autodecoded DEFINED BY value
293 * ``bered`` attribute, meaning if object has BER-specific encoding, is
294 renamed to ``ber_encoded``
295 * ``bered`` attribute is replace with property showing if any of
296 underlying values are BER-encoded. If value has length indefinite
297 encoded explicit tag, value, if value contains BER-related encoding,
298 or if it contains other objects that are ``bered``, then it is ``bered``
304 * Default value is checked also for Sets, not for Sequences only
305 * **Incompatible** change: defaulted values in Sequence/Set are always
306 strictly checked, unless ``allow_default_values`` context option is
307 set. ``strict_default_existence`` option disappeared
308 * Strict Set/Set Of's values ordering check
314 * Additional encoding validness check: explicit tag must contain exactly
315 one object inside. Throw DecodeError otherwise
316 * ``allow_expl_oob`` context and command-line options allow skipping of
323 * DecodeError's decode paths are separated with ``:``, instead of ``.``,
324 because of colliding with dots in OIDs
325 * Ability to print element decode paths with ``--print-decode-path``
326 command line option (and corresponding keyword argument)
327 * Ability to print tree's branch specified with ``--decode-path-only``
333 * Fix possible uncaught TypeError in Py2 with zero bytes inside the value
334 * Fix SequenceOf/SetOf raising BoundsError instead of DecodeError
340 * Fix uncaught UTCTime/GeneralizedTime decode error when dealing with
341 non ASCII-encoded values
347 * Fix long-standing bug with explicitly tagged objects inside the
348 Choice. If Choice had explicitly tagged value, then its ``.tlvlen``
349 reports the size without taking value's explicit tag in advance
350 * Add ``.fulllen`` and ``.fulloffset`` properties for all objects
356 * SEQUENCE's values are printed with field's name. Previously there was
357 the following output::
359 AlgorithmIdentifier SEQUENCE[OBJECT IDENTIFIER 1.3.14.3.2.26, [UNIV 5] ANY 0500 OPTIONAL]
363 AlgorithmIdentifier SEQUENCE[algorithm: OBJECT IDENTIFIER 1.3.14.3.2.26; parameters: [UNIV 5] ANY 0500 OPTIONAL]
364 * Fixed EOC (Unicode character) repr printing issues under Python2
370 BER's EOC is explicitly shown during pprinting. Following notation::
372 15-2 [0,0,1576]-4 . content: [0] EXPLICIT [UNIV 16] ANY
376 15-2∞ [0,0,1576]∞ . content: [0] EXPLICIT [UNIV 16] ANY
378 1587 [1,1, 0] . content: BER EOC
379 1589 [1,1, 0] . content: EXPLICIT BER EOC
385 * BER decoding support
386 * BitString's ''H notation support
387 * ``termcolor`` package is included in the tarball
393 * Ability to set values during Sequence initialization
399 * Fix TagMismatch exception completeness during Choice and Set decoding.
400 Previously we will loose offset and decode_path information about
401 concrete TagMismatched entity
407 * Strict NumericString's value sanitation
408 * Invalid encoding in string types will raise ``DecodeError`` exception,
409 instead of ``Unicode*Error``
410 * Fixed DecodePathDefBy workability with Python 2.x
416 * Fix nasty BitString decoding bug: it could fail when data follows
417 encoded BitString value. There weren't any problems when BitString is
418 at the end of Sequence
424 * Slightly corrected colours, now visible on white background
430 * Fix bug related to DecodeError showing with DecodePathDefBy entities
431 * Respect ``NO_COLOR`` environment variable
437 * :py:func:`pyderasn.decode_path_defby` is replaced with
438 :py:class:`pyderasn.DecodePathDefBy`
439 * Ability to turn colourized terminal output by calling
440 ``pprint(..., with_colours=True)``. You will need
441 `termcolor package <https://pypi.org/project/termcolor/>`__
447 * Fixed invalid offset calculation when dealing with DEFINED BY objects
454 * BIT STRINGs can also be :ref:`DEFINED BY <definedby>`
455 * Decoding process can be governed with optional :ref:`ctx <ctx>`
456 keyword argument to ``decode()`` method
457 * :ref:`defines_by_path <defines_by_path_ctx>` option is now
458 :ref:`decode context <ctx>` option, not a keyword argument
459 * Ability to do ``strict validation``
460 of defaulted values met in sequence, raising an exception
466 Ability to skip specified number of bytes (``--skip``) in command line
473 * Generic decoder's schema and pretty printer
474 (:py:func:`pyderasn.generic_decoder`) can be used in libraries
475 * Ability to specify :ref:`defines_by_path <defines_by_path_ctx>`
476 during command line invocation
482 Ability to automatically decode :ref:`DEFINED BY <definedby>` fields
489 Removed ``__lt__``/``__eq__`` from base class, as pylint likes it.
495 Full rich comparison operators added.
502 Trivial README addition.