8 * **Incompatible** change: explicitly check that only naive datetime
9 objects are used for UTCTime and GeneralizedTime, raise an error
10 otherwise. Previously they silently ignored ``tzinfo``
16 * Strictly check that tag's long encoded form does not contain leading zero
18 * Strictly check that tag's long form is used in expected way for small values
25 * Proper strict alphabet validation of VisibleString
26 * VisibleString and IA5String also have ``allowable_chars`` property
27 * Fixed TeletexString, T61String use ``iso-8859-1`` encoding (instead of
28 ``ascii``), because they are 8-bit encodings
34 * Also print full TLVlen in ASN.1 browser
41 * Fix DEFINED BY pprinting when invoking as __main__ module
42 * Integer has ``tohex()`` for getting hexadecimal representation of its value
43 * ``hexdump()`` (``hexdump -C`` like output) and ``ascii_visualize()``
44 (visualize ASCII printable characters, like in ``hexdump -C``) pretty
45 printing functions appeared
46 * Experimental ASN.1 interactive terminal browser (``--browse`` and
48 You will need `urwid package <http://urwid.org/>`__ to use it
55 * SEQUENCE/SET fully performs default value existence validation in
56 evgen mode, by the cost of DEFAULTed value full decoding. That should
57 not be the problem, as DEFAULTs are relatively small in practice. Now
58 evgen mode has the same DER validation strictness as an ordinary one
65 * Restored workability of some command line options
66 * 2-pass DER encoding mode with very little memory footprint
79 * Fixed invalid behaviour where SET OF allowed multiple objects with the
80 same tag to be successfully decoded
81 * Fixed possibly invalid SET DER encoding where objects were not sorted
82 by tag, but by encoded representation
83 * ``Any`` does not allow empty data value now. Now it checks if it has
85 * ``SetOf`` is not treated as ready, if no value was set and minimum
86 bounds are greater than zero
87 * ``Any`` allows an ordinary ``Obj`` storing, without its forceful
88 encoded representation storage. That is required for CER encoding
89 mode, where we do not know in advance what encoding will be used
90 * ``ObjectIdentifier`` stores values as C unsigned long integer,
91 forbidding storage of huge integers, that must not be a problem in
93 * Initial support for so called ``evgen_mode``: event generation mode,
94 where no in-memory objects storing happens, giving ability to process
95 ASN.1 data without fully parsing it first. ``python -m pyderasn`` has
96 ``--evgen`` mode switcher
97 * Useful ``agg_octet_string`` that is able to streamingly decode string
98 from events of ``evgen_mode``, allowing strings retrieving without
99 copying them to memory first
100 * Initial experimental CER encoding mode, allowing streaming encoding of
101 the data directly to some writeable object
102 * Ability to use mmap-ed memoryviews to skip files loading to memory
103 * Ability to use memoryview as an input for \*Strings. If they are
104 mmap-ed, then you can encode any quantities of data streamingly
105 without copying to memory
111 * Fixed workability under Python 3.5. Previously only 2.7 and 3.6
118 * Python ``int()``'s accepts even more various non-decimal characters
119 than expected. Make validation fully strict in UTCTime and
120 GeneralizedTime, without relying on ``int()``
126 * UTCTime and GeneralizedTime allowed values to have plus sign in them,
127 passing int() check successfully. Prohibit that incorrect behaviour
128 * UTCTime and GeneralizedTime BER decoding support
129 * Faster UTCTime and GeneralizedTime decoding, and slightly better
131 * Workability under Cython
132 * Explicitly Check that all ObjectIdentifier arcs are non-negative
138 * ``.copy()`` method removed: ``copy.copy()`` is preferred way to copy
140 * Copies made previously with ``.copy()`` lacked ``.defined`` field,
142 * All objects are friendly to ``pickle`` libraries
143 * PrintableString has ``allow_asterisk`` and ``allow_ampersand``
145 * ``.hexencode()``, ``.hexdecode()`` and ``.hexdecod()`` methods
146 appeared, working with hexadecimal encoded data
152 * Convenient ``.decod()`` method, that raises if tail is not empty
153 * Control characters (like newlines) of text fields in pprinted output
155 * Ability to allow asterisk and ampersand characters
156 (``allow_asterisk``, ``allow_ampersand`` kwargs) in PrintableString,
157 that unfortunately could be met in X.509 certificates
163 * PEP-396 compatible module's ``__version__``
169 * Do not shadow underlying DecodeError during decoding of optional
176 * Forbid any later GNU GPL version autousage (project's licence now is
178 * Fix ``defines_by_path`` context option usage example
184 * Fix fallbacked ``colored()`` function workability,
185 if no ``termcolor`` is installed
191 * Fix empty ``--oids`` workability
197 * Ability to specify multiple OID mappings for pprinted output
198 (``oids`` keyword argument is renamed to ``oid_maps``)
204 * Minor decode speed improvements
205 * Much faster UTCTime/GeneralizedTime decoders
206 * Stricter UTCTime/GeneralizedTime DER encoding check: trailing zeroes
208 * Valid DER encoding of GeneralizedTime with microseconds: no trailing
215 * ObjectIdentifier has ``ber_encoded`` set to True, if non-normalized
217 * Preserve BER-related attributes during ``copy()``
223 * Added `COMPLI <https://github.com/YuryStrozhevsky/asn1-test-suite>`__
224 ASN.1:2008 test suite. PyDERASN passes it (except for REAL values),
225 but it is more strict sometimes and aimed to be compliant with X.690-201508
226 * Check for arc values normalization in ObjectIdentifier.
227 Forbid non-normalized in DER encoding
233 * ``ctx`` parameter can be safely used in .decode() and won't be muted
234 * PP nametuple contains reference to the ASN1Obj itself
235 * ``colonize_hex`` function useful for pretty printing
236 * Integer values are also pretty printed in hexadecimal form
242 * All errors are inherited from ASN1Error class
243 * NumericString/PrintableString has ``allowable_chars`` property holding
244 all allowed characters
250 * Fix NumericString: space is allowed character
251 * Strict PrintableString sanitizing
257 * Removed ``lenindef``, ``ber_encoded`` attributes from the Choice --
258 they must be taken from underlying value, as Choice does not have its
260 * Do not yield extra EOC PP for Any, having indefinite length encoding
261 and containing autodecoded DEFINED BY value
267 * ``bered`` attribute, meaning if object has BER-specific encoding, is
268 renamed to ``ber_encoded``
269 * ``bered`` attribute is replace with property showing if any of
270 underlying values are BER-encoded. If value has length indefinite
271 encoded explicit tag, value, if value contains BER-related encoding,
272 or if it contains other objects that are ``bered``, then it is ``bered``
278 * Default value is checked also for Sets, not for Sequences only
279 * **Incompatible** change: defaulted values in Sequence/Set are always
280 strictly checked, unless ``allow_default_values`` context option is
281 set. ``strict_default_existence`` option disappeared
282 * Strict Set/Set Of's values ordering check
288 * Additional encoding validness check: explicit tag must contain exactly
289 one object inside. Throw DecodeError otherwise
290 * ``allow_expl_oob`` context and command-line options allow skipping of
297 * DecodeError's decode paths are separated with ``:``, instead of ``.``,
298 because of colliding with dots in OIDs
299 * Ability to print element decode paths with ``--print-decode-path``
300 command line option (and corresponding keyword argument)
301 * Ability to print tree's branch specified with ``--decode-path-only``
307 * Fix possible uncaught TypeError in Py2 with zero bytes inside the value
308 * Fix SequenceOf/SetOf raising BoundsError instead of DecodeError
314 * Fix uncaught UTCTime/GeneralizedTime decode error when dealing with
315 non ASCII-encoded values
321 * Fix long-standing bug with explicitly tagged objects inside the
322 Choice. If Choice had explicitly tagged value, then its ``.tlvlen``
323 reports the size without taking value's explicit tag in advance
324 * Add ``.fulllen`` and ``.fulloffset`` properties for all objects
330 * SEQUENCE's values are printed with field's name. Previously there was
331 the following output::
333 AlgorithmIdentifier SEQUENCE[OBJECT IDENTIFIER 1.3.14.3.2.26, [UNIV 5] ANY 0500 OPTIONAL]
337 AlgorithmIdentifier SEQUENCE[algorithm: OBJECT IDENTIFIER 1.3.14.3.2.26; parameters: [UNIV 5] ANY 0500 OPTIONAL]
338 * Fixed EOC (Unicode character) repr printing issues under Python2
344 BER's EOC is explicitly shown during pprinting. Following notation::
346 15-2 [0,0,1576]-4 . content: [0] EXPLICIT [UNIV 16] ANY
350 15-2∞ [0,0,1576]∞ . content: [0] EXPLICIT [UNIV 16] ANY
352 1587 [1,1, 0] . content: BER EOC
353 1589 [1,1, 0] . content: EXPLICIT BER EOC
359 * BER decoding support
360 * BitString's ''H notation support
361 * ``termcolor`` package is included in the tarball
367 * Ability to set values during Sequence initialization
373 * Fix TagMismatch exception completeness during Choice and Set decoding.
374 Previously we will loose offset and decode_path information about
375 concrete TagMismatched entity
381 * Strict NumericString's value sanitation
382 * Invalid encoding in string types will raise ``DecodeError`` exception,
383 instead of ``Unicode*Error``
384 * Fixed DecodePathDefBy workability with Python 2.x
390 * Fix nasty BitString decoding bug: it could fail when data follows
391 encoded BitString value. There weren't any problems when BitString is
392 at the end of Sequence
398 * Slightly corrected colours, now visible on white background
404 * Fix bug related to DecodeError showing with DecodePathDefBy entities
405 * Respect ``NO_COLOR`` environment variable
411 * :py:func:`pyderasn.decode_path_defby` is replaced with
412 :py:class:`pyderasn.DecodePathDefBy`
413 * Ability to turn colourized terminal output by calling
414 ``pprint(..., with_colours=True)``. You will need
415 `termcolor package <https://pypi.org/project/termcolor/>`__
421 * Fixed invalid offset calculation when dealing with DEFINED BY objects
428 * BIT STRINGs can also be :ref:`DEFINED BY <definedby>`
429 * Decoding process can be governed with optional :ref:`ctx <ctx>`
430 keyword argument to ``decode()`` method
431 * :ref:`defines_by_path <defines_by_path_ctx>` option is now
432 :ref:`decode context <ctx>` option, not a keyword argument
433 * Ability to do ``strict validation``
434 of defaulted values met in sequence, raising an exception
440 Ability to skip specified number of bytes (``--skip``) in command line
447 * Generic decoder's schema and pretty printer
448 (:py:func:`pyderasn.generic_decoder`) can be used in libraries
449 * Ability to specify :ref:`defines_by_path <defines_by_path_ctx>`
450 during command line invocation
456 Ability to automatically decode :ref:`DEFINED BY <definedby>` fields
463 Removed ``__lt__``/``__eq__`` from base class, as pylint likes it.
469 Full rich comparison operators added.
476 Trivial README addition.