scitex_msword.track_changes

Track-Changes (revision) utilities for python-docx Documents.

This module surfaces the OOXML revision primitives so agents can:

  1. Toggle Word’s “Track Changes” switch (<w:trackChanges/> in word/settings.xml) via enable_track_changes().

  2. Wrap agent edits as <w:ins> / <w:del> revisions (wrap_as_tracked_insertion(), wrap_as_tracked_deletion()).

  3. Extract all tracked changes (extract_tracked_changes()).

  4. Accept / reject all changes in bulk (accept_all_tracked_changes(), reject_all_tracked_changes()).

OOXML refs: w:trackChanges (ECMA-376 §17.15.1.86), w:ins (§17.13.5.18), w:del (§17.13.5.14), w:delText (§17.13.5.15).

Functions

accept_all_tracked_changes(document)

Accept all tracked changes — equivalent to Word's "Accept All".

enable_track_changes(document[, enabled, ...])

Toggle Word's Track Changes switch on the document.

extract_tracked_changes(document)

Return every <w:ins> / <w:del> revision as a structured dict.

is_track_changes_enabled(document)

Return True iff <w:trackRevisions/> is present in settings.xml.

reject_all_tracked_changes(document)

Reject all tracked changes — equivalent to Word's "Reject All".

save_with_track_changes_on(document, path, *)

Save a Document, default-correct for Word Track Changes.

wrap_as_tracked_deletion(paragraph, runs[, ...])

Wrap the given runs of paragraph in <w:del> revision blocks.

wrap_as_tracked_insertion(paragraph, runs[, ...])

Wrap the given runs of paragraph in <w:ins> revision blocks.