Engineers: Jeremy Mikola, Jérôme Tamarelle

2025-04-11: moving target date to 2025-04-25

• Completed in the last two weeks
  • Implemented all prose tests
  • Started documentation for PHPC API
• Focus for the next two weeks
  • Jérôme to implement remainder of unit tests for PHPC API while Jeremy is on PTO
  • Finish PHPC documentation
  • Review and merge pull requests
• Impediments encountered over the last two weeks
  • N/A

2025-03-28:

• Completed in the last two weeks
  • clientBulkWrite spec tests passing in PHPLIB
  • Started implementing clientBulkWrite prose tests
• Focus for the next two weeks
  • Implementing remaining ten clientBulkWrite prose tests
  • Get consensus on API names for PHPLIB classes
• Impediments encountered over the last two weeks
  • Only one week of progress due to spec fest and caring for sick child

2025-03-14:

• Completed in the last two weeks
  • Implemented a BulkWriteCommandBuilder class in PHPLIB
  • Started on unified test runner changes in PHPLIB
  • Relocated error fields to BulkWriteCommandException in PHPC, which differs from the design of the collection-level bulk write API but was ultimately necessary for spec tests
• Focus for the next two weeks
  • Updating test runner for writeError and writeConcernError assertions (new schema version) and getting to a point where all spec tests run successfully
  • New CRUD prose tests for clientBulkWrite
  • Any necessary PHPC fixes for spec tests
• Impediments encountered over the last two weeks
  • Needed to learn how to debug PHPC segfaults on ARM MacBook (GDB is unavailable, and core dumps are not easily produced).
  • Distractions from more changes in drivers-evergreen-tools

2025-02-28:

• Completed in the last two weeks
  • Prototyped an idiomatic API for building bulk writes in PHPLIB
  • Rebased work on v2.x as we won't be releasing this in a 1.x release
• Focus for the next two weeks
  • Finalise PHPLIB API
• Impediments encountered over the last two weeks
  • Docs updates and last-minute work for 1.21 release took time away from the project

2025-01-31:

• What was completed over the last two weeks?
  • There was very little attention given to this project over the past week.
• What's the focus over the next week?
  • PHPLIB prototyping remains the highest priority task.
• Impediments encountered over the last week
  • Nothing related to this project directly, but Jeremy's workflow has been interrupted by migrating to a new MacBook.

2025-01-20:

• What was completed over the last two weeks?
  • Designing the flow for error handling (mapping libmongoc errors to our own exceptions)
  • Writing tests for BulkWriteCommand constructor options helped with error handling
  • Early round of code review, with some items addressed.
• What's the focus over the next week?
  • Test coverage for operation methods and their options
  • Prototyping in PHPLIB, particularly with result modeling
• Impediments encountered over the last week
  • This entire project has been a reminder of the perils of not POC-ing features dependent on libmongoc while the underlying implementation was in progress.

2024-12-20:

• What was completed over the last two weeks?
  • Operation append methods and option parsing for BulkWriteCommand class
• What's the focus over the next week?
  • BulkWriteCommand execution and result modeling
• Impediments encountered over the last week
  • libmongoc's use of separate options structs for each operation lead to more code duplication, especially compared to the bson_t API of the legacy bulk write API.

2024-12-6:

• What was completed over the last two weeks?
  • Resolved several libmongoc tickets required for the PHPC implementation
  • Began implementing BulkWriteCommand class to abstract mongoc_bulkwrite_t
• What's the focus over the next week?
  • Continuing implementation of BulkWriteCommand
• Impediments encountered over the last week
  • Uncertainty over how much of PHPC's existing bulk write API can be leveraged for this project

2024-11-22:

• What was completed over the last two weeks?
  • Started implementing the bulk write API in PHPC, leveraging the libmongoc API
• What's the focus over the next week?
  • Wrap up the PHPC implementation and begin implementing API in PHPLIB
• Impediments encountered over the last week
  • Minor issues with the libmongoc API require attention and fixing in the C driver

DRIVERS-716:
Summary of necessary driver changes

• Implement the new bulk write API and tests defined in the specification.

Commits for syncing spec/prose tests

• Sync spec tests and implement prose tests from this commit.
  • 2024-08-28 include skips on serverless from 0984b09
  • 2024-08-29 include missing skip on serverless from e9f02f3
• Sync the unacknowledged-client-bulkWrite command monitoring test files from this commit. The outdated version of this test in the commit from the previous bullet has a potential race.
• See DRIVERS-2993 for a fix to unacknowledged write handling.

Reference implementations

• Rust
• C