]> Cypherpunks.ru repositories - pyderasn.git/blob - doc/news.rst
Decode path printing
[pyderasn.git] / doc / news.rst
1 News
2 ====
3
4 .. _release3.13:
5
6 3.13
7 ----
8 * DecodeError's decode paths are separated with ``:``, instead of ``.``,
9   because of colliding with dots in OIDs
10 * Ability to print element decode paths with ``--print-decode-path``
11   command line option (and corresponding keyword argument)
12 * Ability to print tree's branch specified with ``--decode-path-only``
13
14 .. _release3.12:
15
16 3.12
17 ----
18 * Fix possible uncaught TypeError in Py2 with zero bytes inside the value
19 * Fix SequenceOf/SetOf raising BoundsError instead of DecodeError
20
21 .. _release3.11:
22
23 3.11
24 ----
25 * Fix uncaught UTCTime/GeneralizedTime decode error when dealing with
26   non ASCII-encoded values
27
28 .. _release3.10:
29
30 3.10
31 ----
32 * Fix long-standing bug with explicitly tagged objects inside the
33   Choice. If Choice had explicitly tagged value, then its ``.tlvlen``
34   reports the size without taking value's explicit tag in advance
35 * Add ``.fulllen`` and ``.fulloffset`` properties for all objects
36
37 .. _release3.9:
38
39 3.9
40 ---
41 * SEQUENCE's values are printed with field's name. Previously there was
42   the following output::
43
44     AlgorithmIdentifier SEQUENCE[OBJECT IDENTIFIER 1.3.14.3.2.26, [UNIV 5] ANY 0500 OPTIONAL]
45
46   now it is::
47
48     AlgorithmIdentifier SEQUENCE[algorithm: OBJECT IDENTIFIER 1.3.14.3.2.26; parameters: [UNIV 5] ANY 0500 OPTIONAL]
49 * Fixed EOC (Unicode character) repr printing issues under Python2
50
51 .. _release3.8:
52
53 3.8
54 ---
55 BER's EOC is explicitly shown during pprinting. Following notation::
56
57       15-2 [0,0,1576]-4  . content: [0] EXPLICIT [UNIV 16] ANY
58
59 is replaced with::
60
61       15-2∞ [0,0,1576]∞  . content: [0] EXPLICIT [UNIV 16] ANY
62     [...]
63     1587    [1,1,   0]   . content:  BER EOC
64     1589    [1,1,   0]   . content: EXPLICIT BER EOC
65
66 .. _release3.7:
67
68 3.7
69 ---
70 * BER decoding support
71 * BitString's ''H notation support
72 * ``termcolor`` package is included in the tarball
73
74 .. _release3.6:
75
76 3.6
77 ---
78 * Ability to set values during Sequence initialization
79
80 .. _release3.5:
81
82 3.5
83 ---
84 * Fix TagMismatch exception completeness during Choice and Set decoding.
85   Previously we will loose offset and decode_path information about
86   concrete TagMismatched entity
87
88 .. _release3.4:
89
90 3.4
91 ---
92 * Strict NumericString's value sanitation
93 * Invalid encoding in string types will raise ``DecodeError`` exception,
94   instead of ``Unicode*Error``
95 * Fixed DecodePathDefBy workability with Python 2.x
96
97 .. _release3.3:
98
99 3.3
100 ---
101 * Fix nasty BitString decoding bug: it could fail when data follows
102   encoded BitString value. There weren't any problems when BitString is
103   at the end of Sequence
104
105 .. _release3.2:
106
107 3.2
108 ---
109 * Slightly corrected colours, now visible on white background
110
111 .. _release3.1:
112
113 3.1
114 ---
115 * Fix bug related to DecodeError showing with DecodePathDefBy entities
116 * Respect ``NO_COLOR`` environment variable
117
118 .. _release3.0:
119
120 3.0
121 ---
122 * :py:func:`pyderasn.decode_path_defby` is replaced with
123   :py:class:`pyderasn.DecodePathDefBy`
124 * Ability to turn colourized terminal output by calling
125   ``pprint(..., with_colours=True)``. You will need
126   `termcolor package <https://pypi.org/project/termcolor/>`__
127
128 .. _release2.1:
129
130 2.1
131 ---
132 * Fixed invalid offset calculation when dealing with DEFINED BY objects
133   having explicit tags
134
135 .. _release2.0:
136
137 2.0
138 ---
139 * BIT STRINGs can also be :ref:`DEFINED BY <definedby>`
140 * Decoding process can be governed with optional :ref:`ctx <ctx>`
141   keyword argument to ``decode()`` method
142 * :ref:`defines_by_path <defines_by_path_ctx>` option is now
143   :ref:`decode context <ctx>` option, not a keyword argument
144 * Ability to do :ref:`strict validation <strict_default_existence_ctx>`
145   of defaulted values met in sequence, raising an exception
146
147 .. _release1.6:
148
149 1.6
150 ---
151 Ability to skip specified number of bytes (``--skip``) in command line
152 utility.
153
154 .. _release1.5:
155
156 1.5
157 ---
158 * Generic decoder's scheme and pretty printer
159   (:py:func:`pyderasn.generic_decoder`) can be used in libraries
160 * Ability to specify :ref:`defines_by_path <defines_by_path_ctx>`
161   during command line invocation
162
163 .. _release1.4:
164
165 1.4
166 ---
167 Ability to automatically decode :ref:`DEFINED BY <definedby>` fields
168 inside SEQUENCEs.
169
170 .. _release1.3:
171
172 1.3
173 ---
174 Removed ``__lt__``/``__eq__`` from base class, as pylint likes it.
175
176 .. _release1.2:
177
178 1.2
179 ---
180 Full rich comparison operators added.
181
182
183 .. _release1.1:
184
185 1.1
186 ---
187 Trivial README addition.
188
189 .. _release1.0:
190
191 1.0
192 ---
193 Initial release.