Skip to content

2026-08-28 vxData multipart feedback audit and version bump

Audited Felix's original PR feedback after branch integration and synchronized vxData package versions.

Work Done

  • Rechecked all ten Felix inline comments from mono PR #356 against the merged alex.leake/feat/vxdata-multipart-upload branch.
  • Confirmed that all five API comments remain applicable: the generated-style upload spec remains, explanatory blocks and constants remain mid-file, and the storage service still puts private helpers before later public functions.
  • Confirmed that the SDK S3 package split, upload/download newspaper ordering, and original private wire-policy boundary issue are resolved. The concise upload documentation regressed and the transfer keyword remains ambiguous.
  • Removed the now-unnecessary _WirePolicy test seam. Upload and download engines read the fixed S3 platform-policy constants directly, while tests monkeypatch those module constants for small fixtures. Pushed mono commit dc4e20dd (refactor: use constants for s3 wire policy).
  • Resolved the three previously completed Felix review threads on PR #356 individually: private wire-policy import, S3 package split, and newspaper ordering.
  • Addressed each of the remaining seven threads in its own pushed commit: removed the generated upload spec, moved route rationale to the module docstring, moved the upload-key constant to the constants section, condensed the multipart service rationale, reordered the API storage service by public interface, simplified the SDK upload documentation, and renamed the public transfer keyword to transfer_config throughout the SDK surface. Resolved each thread after its push; all ten Felix threads are now resolved at mono head 3c3aae62.
  • Bumped vxdata-api, vxdata-sdk, and vxdata-schemas from 3.0.0 to 3.1.0. The schema bump is required because the feature adds multipart wire models and the SDK recipe pins its schema output exactly.
  • Committed and pushed mono commit 0a4052d5 (chore(release): bump vxdata projects to 3.1.0).

Lessons Learned: Pitfalls

  • Reviewing the refactor commit alone was insufficient. Follow-up commits restored verbose documentation and public wire-policy constants, so the feedback had to be assessed against the latest merged branch.
  • Treating the requested API and SDK bump in isolation would have left changed schema code at the old version and created inconsistent SDK package metadata.

Lessons Learned: Improvements

  • For vxData releases, check changed files across API, SDK, and schemas before deciding the version set. The SDK conda recipe builds and exactly pins the schema subpackage to the SDK version.
  • Preserve a short mapping from review-comment URL to current file and line so feedback can be re-audited after branch merges without relying on stale diff positions. Assess the original architectural boundary rather than treating every internal private import as the same issue.
Navigation

Type to search…

↑↓ navigate↵ selectEsc close