8 * Strictly check that tag's long encoded form does not contain leading zero
10 * Strictly check that tag's long form is used in expected way for small values
17 * Proper strict alphabet validation of VisibleString
18 * VisibleString and IA5String also have ``allowable_chars`` property
19 * Fixed TeletexString, T61String use ``iso-8859-1`` encoding (instead of
20 ``ascii``), because they are 8-bit encodings
26 * Also print full TLVlen in ASN.1 browser
33 * Fix DEFINED BY pprinting when invoking as __main__ module
34 * Integer has ``tohex()`` for getting hexadecimal representation of its value
35 * ``hexdump()`` (``hexdump -C`` like output) and ``ascii_visualize()``
36 (visualize ASCII printable characters, like in ``hexdump -C``) pretty
37 printing functions appeared
38 * Experimental ASN.1 interactive terminal browser (``--browse`` and
40 You will need `urwid package <http://urwid.org/>`__ to use it
47 * SEQUENCE/SET fully performs default value existence validation in
48 evgen mode, by the cost of DEFAULTed value full decoding. That should
49 not be the problem, as DEFAULTs are relatively small in practice. Now
50 evgen mode has the same DER validation strictness as an ordinary one
57 * Restored workability of some command line options
58 * 2-pass DER encoding mode with very little memory footprint
71 * Fixed invalid behaviour where SET OF allowed multiple objects with the
72 same tag to be successfully decoded
73 * Fixed possibly invalid SET DER encoding where objects were not sorted
74 by tag, but by encoded representation
75 * ``Any`` does not allow empty data value now. Now it checks if it has
77 * ``SetOf`` is not treated as ready, if no value was set and minimum
78 bounds are greater than zero
79 * ``Any`` allows an ordinary ``Obj`` storing, without its forceful
80 encoded representation storage. That is required for CER encoding
81 mode, where we do not know in advance what encoding will be used
82 * ``ObjectIdentifier`` stores values as C unsigned long integer,
83 forbidding storage of huge integers, that must not be a problem in
85 * Initial support for so called ``evgen_mode``: event generation mode,
86 where no in-memory objects storing happens, giving ability to process
87 ASN.1 data without fully parsing it first. ``python -m pyderasn`` has
88 ``--evgen`` mode switcher
89 * Useful ``agg_octet_string`` that is able to streamingly decode string
90 from events of ``evgen_mode``, allowing strings retrieving without
91 copying them to memory first
92 * Initial experimental CER encoding mode, allowing streaming encoding of
93 the data directly to some writeable object
94 * Ability to use mmap-ed memoryviews to skip files loading to memory
95 * Ability to use memoryview as an input for \*Strings. If they are
96 mmap-ed, then you can encode any quantities of data streamingly
97 without copying to memory
103 * Fixed workability under Python 3.5. Previously only 2.7 and 3.6
110 * Python ``int()``'s accepts even more various non-decimal characters
111 than expected. Make validation fully strict in UTCTime and
112 GeneralizedTime, without relying on ``int()``
118 * UTCTime and GeneralizedTime allowed values to have plus sign in them,
119 passing int() check successfully. Prohibit that incorrect behaviour
120 * UTCTime and GeneralizedTime BER decoding support
121 * Faster UTCTime and GeneralizedTime decoding, and slightly better
123 * Workability under Cython
124 * Explicitly Check that all ObjectIdentifier arcs are non-negative
130 * ``.copy()`` method removed: ``copy.copy()`` is preferred way to copy
132 * Copies made previously with ``.copy()`` lacked ``.defined`` field,
134 * All objects are friendly to ``pickle`` libraries
135 * PrintableString has ``allow_asterisk`` and ``allow_ampersand``
137 * ``.hexencode()``, ``.hexdecode()`` and ``.hexdecod()`` methods
138 appeared, working with hexadecimal encoded data
144 * Convenient ``.decod()`` method, that raises if tail is not empty
145 * Control characters (like newlines) of text fields in pprinted output
147 * Ability to allow asterisk and ampersand characters
148 (``allow_asterisk``, ``allow_ampersand`` kwargs) in PrintableString,
149 that unfortunately could be met in X.509 certificates
155 * PEP-396 compatible module's ``__version__``
161 * Do not shadow underlying DecodeError during decoding of optional
168 * Forbid any later GNU GPL version autousage (project's licence now is
170 * Fix ``defines_by_path`` context option usage example
176 * Fix fallbacked ``colored()`` function workability,
177 if no ``termcolor`` is installed
183 * Fix empty ``--oids`` workability
189 * Ability to specify multiple OID mappings for pprinted output
190 (``oids`` keyword argument is renamed to ``oid_maps``)
196 * Minor decode speed improvements
197 * Much faster UTCTime/GeneralizedTime decoders
198 * Stricter UTCTime/GeneralizedTime DER encoding check: trailing zeroes
200 * Valid DER encoding of GeneralizedTime with microseconds: no trailing
207 * ObjectIdentifier has ``ber_encoded`` set to True, if non-normalized
209 * Preserve BER-related attributes during ``copy()``
215 * Added `COMPLI <https://github.com/YuryStrozhevsky/asn1-test-suite>`__
216 ASN.1:2008 test suite. PyDERASN passes it (except for REAL values),
217 but it is more strict sometimes and aimed to be compliant with X.690-201508
218 * Check for arc values normalization in ObjectIdentifier.
219 Forbid non-normalized in DER encoding
225 * ``ctx`` parameter can be safely used in .decode() and won't be muted
226 * PP nametuple contains reference to the ASN1Obj itself
227 * ``colonize_hex`` function useful for pretty printing
228 * Integer values are also pretty printed in hexadecimal form
234 * All errors are inherited from ASN1Error class
235 * NumericString/PrintableString has ``allowable_chars`` property holding
236 all allowed characters
242 * Fix NumericString: space is allowed character
243 * Strict PrintableString sanitizing
249 * Removed ``lenindef``, ``ber_encoded`` attributes from the Choice --
250 they must be taken from underlying value, as Choice does not have its
252 * Do not yield extra EOC PP for Any, having indefinite length encoding
253 and containing autodecoded DEFINED BY value
259 * ``bered`` attribute, meaning if object has BER-specific encoding, is
260 renamed to ``ber_encoded``
261 * ``bered`` attribute is replace with property showing if any of
262 underlying values are BER-encoded. If value has length indefinite
263 encoded explicit tag, value, if value contains BER-related encoding,
264 or if it contains other objects that are ``bered``, then it is ``bered``
270 * Default value is checked also for Sets, not for Sequences only
271 * **Incompatible** change: defaulted values in Sequence/Set are always
272 strictly checked, unless ``allow_default_values`` context option is
273 set. ``strict_default_existence`` option disappeared
274 * Strict Set/Set Of's values ordering check
280 * Additional encoding validness check: explicit tag must contain exactly
281 one object inside. Throw DecodeError otherwise
282 * ``allow_expl_oob`` context and command-line options allow skipping of
289 * DecodeError's decode paths are separated with ``:``, instead of ``.``,
290 because of colliding with dots in OIDs
291 * Ability to print element decode paths with ``--print-decode-path``
292 command line option (and corresponding keyword argument)
293 * Ability to print tree's branch specified with ``--decode-path-only``
299 * Fix possible uncaught TypeError in Py2 with zero bytes inside the value
300 * Fix SequenceOf/SetOf raising BoundsError instead of DecodeError
306 * Fix uncaught UTCTime/GeneralizedTime decode error when dealing with
307 non ASCII-encoded values
313 * Fix long-standing bug with explicitly tagged objects inside the
314 Choice. If Choice had explicitly tagged value, then its ``.tlvlen``
315 reports the size without taking value's explicit tag in advance
316 * Add ``.fulllen`` and ``.fulloffset`` properties for all objects
322 * SEQUENCE's values are printed with field's name. Previously there was
323 the following output::
325 AlgorithmIdentifier SEQUENCE[OBJECT IDENTIFIER 1.3.14.3.2.26, [UNIV 5] ANY 0500 OPTIONAL]
329 AlgorithmIdentifier SEQUENCE[algorithm: OBJECT IDENTIFIER 1.3.14.3.2.26; parameters: [UNIV 5] ANY 0500 OPTIONAL]
330 * Fixed EOC (Unicode character) repr printing issues under Python2
336 BER's EOC is explicitly shown during pprinting. Following notation::
338 15-2 [0,0,1576]-4 . content: [0] EXPLICIT [UNIV 16] ANY
342 15-2∞ [0,0,1576]∞ . content: [0] EXPLICIT [UNIV 16] ANY
344 1587 [1,1, 0] . content: BER EOC
345 1589 [1,1, 0] . content: EXPLICIT BER EOC
351 * BER decoding support
352 * BitString's ''H notation support
353 * ``termcolor`` package is included in the tarball
359 * Ability to set values during Sequence initialization
365 * Fix TagMismatch exception completeness during Choice and Set decoding.
366 Previously we will loose offset and decode_path information about
367 concrete TagMismatched entity
373 * Strict NumericString's value sanitation
374 * Invalid encoding in string types will raise ``DecodeError`` exception,
375 instead of ``Unicode*Error``
376 * Fixed DecodePathDefBy workability with Python 2.x
382 * Fix nasty BitString decoding bug: it could fail when data follows
383 encoded BitString value. There weren't any problems when BitString is
384 at the end of Sequence
390 * Slightly corrected colours, now visible on white background
396 * Fix bug related to DecodeError showing with DecodePathDefBy entities
397 * Respect ``NO_COLOR`` environment variable
403 * :py:func:`pyderasn.decode_path_defby` is replaced with
404 :py:class:`pyderasn.DecodePathDefBy`
405 * Ability to turn colourized terminal output by calling
406 ``pprint(..., with_colours=True)``. You will need
407 `termcolor package <https://pypi.org/project/termcolor/>`__
413 * Fixed invalid offset calculation when dealing with DEFINED BY objects
420 * BIT STRINGs can also be :ref:`DEFINED BY <definedby>`
421 * Decoding process can be governed with optional :ref:`ctx <ctx>`
422 keyword argument to ``decode()`` method
423 * :ref:`defines_by_path <defines_by_path_ctx>` option is now
424 :ref:`decode context <ctx>` option, not a keyword argument
425 * Ability to do ``strict validation``
426 of defaulted values met in sequence, raising an exception
432 Ability to skip specified number of bytes (``--skip``) in command line
439 * Generic decoder's schema and pretty printer
440 (:py:func:`pyderasn.generic_decoder`) can be used in libraries
441 * Ability to specify :ref:`defines_by_path <defines_by_path_ctx>`
442 during command line invocation
448 Ability to automatically decode :ref:`DEFINED BY <definedby>` fields
455 Removed ``__lt__``/``__eq__`` from base class, as pylint likes it.
461 Full rich comparison operators added.
468 Trivial README addition.