Rename health_ck support binary to rmr_probe
[ric-plt/lib/rmr.git] / src / bindings / rmr-python / docs / release-notes.rst
1 Change Log
2 ==========
3
4 All notable changes to this project will be documented in this file.
5
6 The format is based on `Keep a Changelog <http://keepachangelog.com/>`__
7 and this project adheres to `Semantic
8 Versioning <http://semver.org/>`__.
9
10 [4.0.0] - 3/18/2020
11 -------------------
12
13 ::
14
15     * Switch to SI95 instead of NNG. This is a breaking change. SI95 rmr users cannot talk to NNG rmr users.
16     * The version bump from 2 to 4 is due to the "roommate" issue in the rmr repo.
17
18
19 [2.2.1] - 3/3/2020
20 --------------------
21
22 ::
23
24     * Correct the MEID unit test (broken by RMR commit 190665fe)
25     * Change rmr_init to catch init failure reported by RMR
26
27
28 [2.2.0] - 12/5/2019
29 --------------------
30
31 ::
32
33     * add ability to set a deterministic transaction id in alloc, and in the mock of alloc
34     * add ability to set meid in fake alloc; before None was always returned erroneously
35     * Fix a bug where fake_alloc was way out of date with alloc, and add a test for it
36
37
38 [2.1.0] - 12/4/2019
39 --------------------
40
41 ::
42
43     * Allow the setting of payload and message type in rts
44     * Add a new function, helpers.rmr_rcvall_msgs_raw, that also returns the sbuf alongside the summary
45     * Add a mock for free_msg
46
47
48 [2.0.0] - 12/2/2019
49 --------------------
50
51 ::
52     * This is a breaking change as it rquires that RMR version 1.10.2 or later be used.
53     * The populate and set length function will reallocate the message buffer payload if the caller attempts to insert more bytes than the currrent message supports.
54     * add ability to set subscription id when allocating a message
55     * add testing involving subscription ids
56
57
58 [1.0.0] - 10/24/2019
59 --------------------
60
61 ::
62
63     * It's been past due to bump this to 1.0.0 since people depend on it!
64     * Add the ability to set sbuf attributes in the same call that it is allocated
65     * (breaking) removes bytes2meid
66     * (breaking) rmr_set_meid now infers length
67     * (breaking) rmr_get_meid now returns bytes, to be symmetric with set_meid
68
69
70 [0.13.5] - 10/23/2019
71 --------------------
72
73 ::
74
75     * Add an exceptions module and raise a proper exception when an allocated buffer has a NULL pointer. Likely due to a bad rmr context.
76
77 [0.13.4] - 10/21/2019
78 --------------------
79
80 ::
81
82     * Correct cause of nil pointer exception in message summary.
83
84
85 [0.13.3] - 10/10/2019
86 --------------------
87
88 ::
89
90     * Add missing unit test for receive all.
91     * Correct bug in summary function.
92
93 [0.13.2] - 10/2/2019
94 --------------------
95
96 ::
97
98     * Fix a constant name (RMRFL_MT_CALL)
99
100 [0.13.1] - 10/1/2019
101 --------------------
102
103 ::
104
105     * Correct unit test bug in rmr-python. With RMR 1.8.x connections are forced to be asynch by default to prevent kubernetes blocking the attempt for minutes. However, the asynch nature of connections makes unit tests concerned with the ability to send and receive messages non-deterministic as some connections are established before the first message is sent, and others are not. This change ensures that unit tests establish connections in a synchronous manner which ensures that the first send will not be rejected by NNG due to a pending connection.
106
107 [0.13.0] - 9/27/2019
108 --------------------
109
110 ::
111    * Add a helpers module to provide extensions and helper functions such as receive all queued messages.
112    * Enhance unit test to check only for RMR constants which are needed.
113    * Correct unprintable characters in documentation.
114
115
116 [0.12.0] - 8/23/2019
117 --------------------
118
119 ::
120    * Add final unit tests for rmr.py; unit test coverage for rmr python is about 95%. The remaining functions are dangerous to unit test directly, e.g., rcv which may block forever
121    * Fix a bug where meid was being intepreted as bytes (but then cast into a string); the correct interpretation is a string, so now it will truncate after a null byte.
122    * Removes access to the raw function rmr_get_meid(ptr, dest) in favor of just rmr_get_meid(ptr). Also get_meid is now rmr_get_meid since it wasn't consistent with the naming.
123
124
125 [0.11.0] - 8/21/2019
126 --------------------
127
128 ::
129    * Overhaul unit tests to remove mocking from the rmr tests, which gives much greater confidence in changing the code. More is still needed however, specifically test sends and test receives.
130    * Adds an alias rmr_set_meid to rmr_bytes2meid for naming consistency.
131    * Found a possible inconsistency/bug that requires further investigation later; setting meid takes bytes, but getting it returns a string.
132
133
134 [0.10.8] - 8/20/2019
135 --------------------
136
137 ::
138    * Fix invocation of _rmr_alloc function
139
140
141 [0.10.7] - 8/14/2019
142 --------------------
143
144 ::
145    * Finish sphinx documentation
146    * Make public functions that wrap ctype declarions, allowing for docstrings
147    * Fix a bug where rmr_set_stimeout was pointing to the wrong function
148
149
150 [0.10.6] - 8/13/2019
151 --------------------
152
153 ::
154    * Moves Changelog.md to this file, to be consistent with rst-ification
155    * Sets up a Dockerfile to generate documentation for rmr-python using sphinx
156
157
158 [0.10.5] - 8/13/2019
159 --------------------
160
161 ::
162
163    * Make the PYPI page for rmr look nicer.
164
165 .. _section-1:
166
167 [0.10.4] - 8/08/2019
168 --------------------
169
170 ::
171
172    * Fix underlying problem getting errno from some environments; now references new RMR message field to get errno value.
173    * Add /usr/local/lib64 to tox environment variable to support systems where libraries natually install in lib64 rather than lib.
174
175 .. _section-2:
176
177 [0.10.3] - 7/31/2019
178 --------------------
179
180 ::
181
182    * (Correctly) Include license here per Jira RICPLT-1855
183
184 .. _section-3:
185
186 [0.10.2] - 7/31/2019
187 --------------------
188
189 ::
190
191    * Include license here per Jira RICPLT-1855
192
193 .. _section-4:
194
195 [0.10.0] - 5/15/2019
196 --------------------
197
198 ::
199
200    * Fix a bug in rmr mock that prevented it for being used for rmr_rcv (was only usable for rmr_torcv)
201    * Add more unit tests, esp for message summary
202    * Remove meid truncation in the case where a nil is present mid string
203    * Change the defaul mock of meid and get_src to something more useful
204
205 .. _section-5:
206
207 [0.9.0] - 5/13/2019
208 -------------------
209
210 ::
211
212    * Add a new module for mocking out rmr-python, useful for other packages that depend on rmr-python
213
214 .. _section-6:
215
216 [0.8.4] - 5/10/2019
217 -------------------
218
219 ::
220
221    * Add some unit tests; more to come
222
223 .. _section-7:
224
225 [0.8.3] - 5/8/2019
226 ------------------
227
228 ::
229
230    * Better loop indexing in meid string handling
231
232 .. _section-8:
233
234 [0.8.2] - 5/8/2019
235 ------------------
236
237 ::
238
239    * Fix examples bug
240    * add liscneses for LF push
241
242 .. _section-9:
243
244 [0.8.1] - 5/7/2019
245 ------------------
246
247 ::
248
249    * Better andling of meid in message summary
250
251 .. _section-10:
252
253 [0.8.0] - 5/7/2019
254 ------------------
255
256 ::
257
258    * Refactor some code to be more functional
259    * Put back RMR_MAX_RCV_BYTES as a constant
260    * Add tox.ini, although right now it only LINTs
261
262 .. _section-11:
263
264 [0.7.0] - 5/6/2019
265 ------------------
266
267 ::
268
269    * Add constant fetching from RMr library
270
271 .. _section-12:
272
273 [0.6.0] - 5/6/2019
274 ------------------
275
276 ::
277
278    * Add a new field to rmr_mbuf_t: sub_id
279    * Fix prior commits lint-ailing python style
280
281 .. _section-13:
282
283 [0.5.0] - 5/3/2019
284 ------------------
285
286 ::
287
288    * Add errno access via new function: rmr.errno()
289    * Add new functions to access new RMr header fields: get_src, get_meid, rmr_bytes2meid
290    * Add new RMr constants for error states
291
292 .. _section-14:
293
294 [0.4.1] - 4/8/2019
295 ------------------
296
297 ::
298
299    * Fix a non-ascii encoding issue
300
301 .. _section-15:
302
303 [0.4.0] - 3/28/2019
304 -------------------
305
306 ::
307
308    * Greatly imroved test sender/receiver
309    * Three new functions implemented (rmr_close, rmr_set_stimeout, rmr_payload_size)
310
311 .. _section-16:
312
313 [0.3.0] - 3/26/2019
314 -------------------
315
316 ::
317
318    * Support a new receive function that (hurray!) has a timeout
319
320 .. _section-17:
321
322 [0.2.1] - 3/25/2019
323 -------------------
324
325 ::
326
327    * Add two new MR states
328
329 .. _section-18:
330
331 [0.2.0] - 3/25/2019
332 -------------------
333
334 ::
335
336    * Switch to NNG from nanomessage
337
338 .. _section-19:
339
340 [0.1.0] - 3/14/2019
341 -------------------
342
343 ::
344
345    * Initial Creation