Skip to content

Release v0.13.2: Fix v0 superblock files showing 0 children#10

Merged
kolkov merged 12 commits intomainfrom
release/v0.13.2
Jan 17, 2026
Merged

Release v0.13.2: Fix v0 superblock files showing 0 children#10
kolkov merged 12 commits intomainfrom
release/v0.13.2

Conversation

@kolkov
Copy link
Contributor

@kolkov kolkov commented Jan 17, 2026

Summary

Fix for Issue #9: V0 superblock HDF5 files were incorrectly showing 0 children in groups.

Changes

  • Fix B-tree address parsing to use file's endianness
  • Fix local heap to read data segment from actual address in header
  • Fix symbol table entry size (40 bytes with scratch-pad)
  • Add cycle detection for shared symbol tables
  • Use superblock cached B-tree/Heap addresses for root group

Result

  • group_old.h5 now correctly shows 2 objects (was showing 0)
  • Big-endian files parse correctly
  • No infinite recursion on shared symbol tables

Known Limitation

Files with data layout message versions 1-2 (HDF5 1.6 era) are now detected but skipped in tests. These require older layout format parsing which is not yet implemented.

Quality

  • ✅ All tests pass
  • ✅ 0 linter issues
  • ✅ Documentation updated (CHANGELOG.md, ROADMAP.md)

Closes #9

🤖 Generated with Claude Code

- Updated README.md Support section with v0.13.0 forum post
- Updated README.md footer recognition link
- Added CHANGELOG.md announcement link to v0.13.0 section

Forum post: https://forum.hdfgroup.org/t/pure-go-hdf5-library-production-release-with-hdf5-2-0-0-compatibility/13584
- Project target: 70% minimum coverage (with 1% threshold)
- Patch coverage: informational mode (don't fail PRs)
- Ignore: examples, cmd, testdata, test utilities
- Validated: https://codecov.io/validate

This prevents false failures on documentation-only changes
like the v0.13.1 hotfix (comment updates).
- Updated current version to v0.13.1 (hotfix)
- Added v0.13.1 hotfix section (documentation correction)
- Fixed HDF5 2.0.0 Format Spec v4.0 description (v0-v3 superblocks only)
- Added v0.13.x Stable Maintenance Phase details
- Added v0.14.0+ Future Enhancements (community-driven planning)
- Updated footer to v5.1
- QUICKSTART.md: Update compression filters to v0.14.0+ (was v1.x)
- QUICKSTART.md: Update thread-safety to v0.14.0+ (was v2.0)
- FAQ.md: Update HDF5 2.0.0 support status (now supported)
- FAQ.md: Update versioning strategy to v0.14.0+ (was v1.x.x/v2.0.0)

Aligns documentation with current ROADMAP.md versioning scheme.
- Track HDF5 C library version and sync status
- Document Format Specification v4.0 (HDF5 2.0.0) support
- Feature parity table (Go vs C implementation)
- CVE tracking and security sync workflow
- Sync process documentation for future updates
- Updated to commit bc8f6bb02a (2025-12-19)
- Identified 2 new CVEs (CVE-2025-2308, CVE-2025-2309)
- CVE-2025-2308: Not affected (scale-offset filter not implemented)
- CVE-2025-2309: Review needed (TASK-034 created)
- Added sync history with GitHub commit links
- Updated feature parity table
- Fix B-tree address parsing to use file's endianness
- Fix local heap to read data from actual address in header
- Fix symbol table entry size (40 bytes with scratch-pad)
- Add cycle detection for shared symbol tables
- Use superblock cached B-tree/Heap addresses for root group
- Skip files requiring unsupported data layout versions 1-2

Closes #9
@codecov
Copy link

codecov bot commented Jan 17, 2026

Welcome to Codecov 🎉

Once you merge this PR into your default branch, you're all set! Codecov will compare coverage reports and display results in all future pull requests.

ℹ️ You can also turn on project coverage checks and project coverage reporting on Pull Request comment

Thanks for integrating Codecov - We've got you covered ☂️

- Update CI triggers: remove develop, add fix/** branch
- Update CONTRIBUTING.md: GitHub Flow workflow
- Update README.md: CI badge uses main branch
@kolkov kolkov merged commit da207ac into main Jan 17, 2026
11 checks passed
@kolkov kolkov deleted the release/v0.13.2 branch January 17, 2026 20:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

HDF5 files show up with no content

1 participant