add read_buffer_context and write_read_buffer_context

[braingram]

closes #873

Changes

Add read_buffer_context and write_read_buffer_context to weldx.asdf.util.

Update previous uses of read_buffer and write_read_buffer that inspect the result to use the context.

read_buffer and write_read_buffer were updated to use the new context to avoid code duplication. These were not removed to preserve the API and to leave them available for uses where the result is not inspected. Such as this test:

weldx/weldx/tests/asdf_tests/test_asdf_base_types.py

Lines 15 to 20 in c2ee9b1

	def test_uuid():
	"""Test uuid serialization and version 4 pattern."""
	write_read_buffer({"id": uuid.uuid4()})
	with pytest.raises(ValidationError):
	write_read_buffer({"id": uuid.uuid1()})

Related Issues

Closes #873

Checks

• updated CHANGELOG.md
• updated tests/
• updated doc/
• update example/tutorial notebooks
• update manifest file

[github-actions]

Test Results

2 188 tests   - 1   2 187 ✔️  - 1   2m 41s ⏱️ +7s
       1 suites ±0          1 💤 ±0 
       1 files   ±0          0 ❌ ±0 

Results for commit 04ef802. ± Comparison against base commit 7b5c0c1.

This pull request removes 1 test.

weldx.tests.asdf_tests.test_asdf_util ‑ test_write_buffer_dummy_inline_arrays

♻️ This comment has been updated with latest results.

[CagtayFabry]

thank you very much for you contribution here @braingram

[marscher]

Thanks! The utility functions are not meant to be used directly by users, as dealing with file handle life times can be tedious. This is mainly why we introduced a wrapper class around the file handle (also using the context manager protocol).

[codecov]

Codecov Report

Merging #875 (04ef802) into master (7b5c0c1) will decrease coverage by 0.04%.
The diff coverage is 87.50%.

@@            Coverage Diff             @@
##           master     #875      +/-   ##
==========================================
- Coverage   96.51%   96.48%   -0.04%     
==========================================
  Files          94       94              
  Lines        6283     6284       +1     
==========================================
- Hits         6064     6063       -1     
- Misses        219      221       +2     

Impacted Files	Coverage Δ
weldx/asdf/util.py	90.28% <87.50%> (-0.60%)	⬇️