What’s New

What’s New#

The format is based on Keep a Changelog, and this project adheres to Intended Effort Versioning (EffVer for short). Release notes are automatically recovered from GitHub by sphinx-github-changelog.

v0.3.1#

Released on 2026-10-15 - GitHub - PyPI

What's Changed

Documentation

  • Explain value over numpy.fromfile and add project origin by @fschuch in #48

Other Changes

Full Changelog: v0.3.0...v0.3.1

v0.3.0#

Released on 2026-10-08 - GitHub - PyPI

What's Changed

Added

  • Conventions for solver integrations: memory order, stacked variables, composites, Convention base class by @fschuch in #46

Full Changelog: v0.2.0...v0.3.0

v0.2.0#

Released on 2026-10-07 - GitHub - PyPI

What's Changed

Added

  • New xarray_binfile.conventions module with ready-to-use implementations of the read and write spec getter protocols:
    • FilenamePattern builds both the writer's formatter and the reader's regular expression from a single str.format template such as "{name}-{step:04d}.bin". Matching is anchored to the whole filename, zero-fill is a minimum width, and formatting verifies that the result parses back, so write and read conventions can no longer drift apart.
    • Layout declares the on-disk dimension order, coordinates and dtype, and validates arrays strictly before writing (dimensions, sizes and, by default, coordinate values).
    • StepIndexedFiles for files numbered by an integer step, with optional time_step to map steps to physical time on read and back on write. Values that do not land on an integer step raise instead of being truncated.
    • TimeStampedFiles for files named with the physical time (for example ux-0.250.bin), rejecting values that collide at the pattern precision.
    • StaticFiles for fields without a time dimension, one file per variable.
    • FolderConventions to dispatch on the parent folder when different folders hold arrays of different shapes. Writes require exactly one convention to accept the array and raise LayoutMismatchError otherwise.
  • WriteSpecs.filename may include sub-folders, created on demand, or be an absolute path, so one to_file call can target several locations.

Changed

  • to_file stages each file in a temporary sibling next to its destination and moves it into place atomically, instead of using one temporary directory inside the output directory. Relative filenames that escape the output directory through .. are rejected; the output directory itself must exist.
  • to_file no longer copies the array when the on-disk dtype equals the in-memory dtype.

Documentation

  • The spec getter protocols page is rewritten around the shipped conventions, with examples for step-indexed, time-stamped, static and folder-dependent layouts. All tutorials use the new conventions, and the API reference gains a Conventions section.
  • Added CONTRIBUTING, CODE_OF_CONDUCT, and CITATION.cff by @fschuch in #45

Deprecated

  • xarray_binfile.tutorial.FileSpecsGetter is deprecated in favour of xarray_binfile.conventions.StepIndexedFiles. It is kept unchanged and emits a DeprecationWarning. Replace FileSpecsGetter(base_coords=coords, dtype=dtype) with StepIndexedFiles(Layout(coords, dtype=dtype)); the default pattern produces the same filenames.

Internals

  • Build(deps-dev): bump pytest-rerunfailures from 16.3 to 16.4 in the pip-dependencies group by @dependabot[bot] in #32
  • Build(deps): bump SonarSource/sonarqube-scan-action from 8.2.0 to 8.2.1 in the actions group by @dependabot[bot] in #35
  • Build(deps-dev): bump pytest-rerunfailures from 16.4 to 16.5 in the pip-dependencies group by @dependabot[bot] in #37
  • Build(deps): bump the actions group across 1 directory with 4 updates by @dependabot[bot] in #38
  • Build(deps-dev): bump pytest-rerunfailures from 16.5 to 16.6 in the pip-dependencies group by @dependabot[bot] in #39
  • Build(deps-dev): bump the pip-dependencies group with 2 updates by @dependabot[bot] in #40
  • Build(deps): bump SonarSource/sonarqube-scan-action from 8.2.1 to 8.2.2 in the actions group by @dependabot[bot] in #41
  • Build(deps-dev): bump pytest-rerunfailures from 16.6.1 to 16.7 in the pip-dependencies group by @dependabot[bot] in #42

Other Changes

Full Changelog: v0.1.0...v0.2.0

v0.1.0#

Released on 2026-07-07 - GitHub - PyPI

What's Changed

  • No new features or bug fixes since the previous pre-release.

Full Changelog: v0.1.0b2...v0.1.0

v0.1.0b2#

Released on 2026-07-07 - GitHub - PyPI

What's Changed

Fixed

  • Write accessor couldn't handle dask array due to: AttributeError: 'Array' object has no attribute 'tofile' by @fschuch in #31

Full Changelog: v0.1.0b1...v0.1.0b2

v0.1.0b1#

Released on 2026-07-07 - GitHub - PyPI

What's Changed

Added

Fixed

  • Improved binfile reading robustness with stricter on-disk size validation and enhanced indexing (including integer-based indexing) by @fschuch in #29
  • Made binary writes atomic and added optional output dtype casting for safer, predictable round-trips by @fschuch in #29

Documentation

Full Changelog: v0.1.0b0...v0.1.0b1

v0.1.0b0#

Released on 2025-07-18 - GitHub - PyPI

Added

  • Implement binary file backend for xarray by @fschuch in #2

Other Changes

  • Initialize project from wizard by @fschuch in #1

New Contributors

Full Changelog: https://github.com/fschuch/xarray-binfile/commits/v0.1.0b0