pyOpenVBA 6.1.3__tar.gz → 6.2.0__tar.gz

{pyopenvba-6.1.3 → pyopenvba-6.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: pyOpenVBA
-Version: 6.1.3
+Version: 6.2.0
 Summary: Read and write VBA macros and Excel Power Query in pure Python, no dependencies.
 Project-URL: Homepage, https://github.com/WilliamSmithEdward/pyOpenVBA
 Project-URL: Repository, https://github.com/WilliamSmithEdward/pyOpenVBA
@@ -746,7 +746,9 @@ it, and a save adds only the stylesheet entries the file lacks, spelled
 as Excel spells them. Formatting whole rows, whole columns or the whole
 sheet keeps the row, column and sheet formats Excel keeps, with the
 cells Excel makes where they cross, and saves them as Excel does. Named
-cell styles and conditional formats are not implemented yet.
+cell styles (`Range.Style`, `Workbook.Styles` and the `Style` object)
+and hyperlinks (`Hyperlinks.Add` and the `Hyperlink` object) behave and
+save as Excel's do. Conditional formats are not implemented yet.
 
 Row heights, column widths and hidden rows and columns behave as they do
 in Excel on a 96-DPI display, the one the model emulates: `RowHeight = 20`

{pyopenvba-6.1.3 → pyopenvba-6.2.0}/README.md

@@ -709,7 +709,9 @@ it, and a save adds only the stylesheet entries the file lacks, spelled
 as Excel spells them. Formatting whole rows, whole columns or the whole
 sheet keeps the row, column and sheet formats Excel keeps, with the
 cells Excel makes where they cross, and saves them as Excel does. Named
-cell styles and conditional formats are not implemented yet.
+cell styles (`Range.Style`, `Workbook.Styles` and the `Style` object)
+and hyperlinks (`Hyperlinks.Add` and the `Hyperlink` object) behave and
+save as Excel's do. Conditional formats are not implemented yet.
 
 Row heights, column widths and hidden rows and columns behave as they do
 in Excel on a 96-DPI display, the one the model emulates: `RowHeight = 20`

{pyopenvba-6.1.3 → pyopenvba-6.2.0}/docs/excel_checklist.csv

@@ -432,7 +432,7 @@ Font,Strikethrough,property,As Variant,,VERIFIED,tests/fixtures/range_format.jso
 Font,Subscript,property,As Variant,,VERIFIED,tests/fixtures/range_format.json; tests/fixtures/format/formats_answers.json; tests/test_live_excel_model_gate.py,
 Font,Superscript,property,As Variant,,VERIFIED,tests/fixtures/range_format.json; tests/fixtures/format/formats_answers.json; tests/test_live_excel_model_gate.py,
 Font,ThemeColor,property,As Variant,,VERIFIED,tests/fixtures/range_format.json; tests/fixtures/format/formats_answers.json; tests/test_live_excel_model_gate.py,
-Font,ThemeFont,property,As XlThemeFont,,MISSING,,
+Font,ThemeFont,property,As XlThemeFont,,PARTIAL,tests/fixtures/cell_styles/style_changes.json,Read; setting it on a range reports unsupported.
 Font,TintAndShade,property,As Variant,,VERIFIED,tests/fixtures/range_format.json; tests/fixtures/format/formats_answers.json; tests/test_live_excel_model_gate.py,
 Font,Underline,property,As Variant,,PARTIAL,tests/fixtures/range_format.json; tests/fixtures/format/formats_answers.json; tests/test_live_excel_model_gate.py,"Values other than the five styles, True, False and 3 report unsupported."
 GroupShapes,_Default,method,_Default(Index As Variant) As Shape,,MISSING,,
@@ -443,6 +443,31 @@ GroupShapes,Creator,"property, read-only",As XlCreator,,MISSING,,
 GroupShapes,Item,method,Item(Index As Variant) As Shape,,UNASSESSED,,
 GroupShapes,Parent,"property, read-only",As Object,,MISSING,,
 GroupShapes,Range,"property, read-only",As ShapeRange,,MISSING,,
+Hyperlink,Address,property,As String,,PARTIAL,tests/fixtures/hyperlinks/hyperlinks.json; tests/test_live_excel_model_gate.py,"Kept as Excel tidies it -- an http, https or ftp address's scheme and host in lower case, its path resolved, a # splitting off the subaddress -- for the kinds of address measured; saved with a DOS path relative to the workbook's folder. Setting it keeps the subaddress unless the new address has a # of its own."
+Hyperlink,AddToFavorites,method,AddToFavorites(),,EXCLUDED,,Adds the address to the browser's favourites.
+Hyperlink,Application,"property, read-only",As Application,,VERIFIED,tests/fixtures/hyperlinks/hyperlinks.json,
+Hyperlink,CreateNewDocument,method,"CreateNewDocument(Filename As String, EditNow As Boolean, Overwrite As Boolean)",,EXCLUDED,,Creates and opens a document of another application.
+Hyperlink,Creator,"property, read-only",As XlCreator,,VERIFIED,tests/fixtures/hyperlinks/hyperlinks.json,
+Hyperlink,Delete,method,Delete(),,VERIFIED,tests/fixtures/hyperlinks/hyperlinks.json,"Its cells go back to the default format, merges kept. On a protected sheet a locked cell keeps its link, error 1004."
+Hyperlink,EmailSubject,property,As String,,PARTIAL,tests/fixtures/hyperlinks/hyperlinks.json,"The subject of a mailto address, which setting it writes in, in place of one it names, or takes out; """" for no address; another address fails. Set on a link with no address, which leaves Excel refusing every change after it, it reports unsupported."
+Hyperlink,Follow,method,"Follow([NewWindow As Variant], [AddHistory As Variant], [ExtraInfo As Variant], [Method As Variant], [HeaderInfo As Variant])",,EXCLUDED,,Opens the address in another application.
+Hyperlink,Name,"property, read-only",As String,,VERIFIED,tests/fixtures/hyperlinks/hyperlinks.json,"The text to show it was given, or ""address - subaddress"", which follows a new address; read from a file without a display, its cell's text. Setting it is error 450."
+Hyperlink,Parent,"property, read-only",As Object,,VERIFIED,tests/fixtures/hyperlinks/hyperlinks.json,Its cells.
+Hyperlink,Range,"property, read-only",As Range,,VERIFIED,tests/fixtures/hyperlinks/hyperlinks.json,
+Hyperlink,ScreenTip,property,As String,,VERIFIED,tests/fixtures/hyperlinks/hyperlinks.json; tests/test_live_excel_model_gate.py,
+Hyperlink,Shape,"property, read-only",As Shape,,PARTIAL,tests/fixtures/hyperlinks/hyperlinks.json,Error 1004 for a link on cells; a link on a shape is not implemented.
+Hyperlink,SubAddress,property,As String,,VERIFIED,tests/fixtures/hyperlinks/hyperlinks.json; tests/test_live_excel_model_gate.py,Setting it takes the address away.
+Hyperlink,TextToDisplay,property,As String,,VERIFIED,tests/fixtures/hyperlinks/hyperlinks.json; tests/test_live_excel_model_gate.py,"The text the first cell holds, """" for a number or a formula; setting it writes the first cell and names the link, """" doing nothing."
+Hyperlink,Type,"property, read-only",As Long,,PARTIAL,tests/fixtures/hyperlinks/hyperlinks.json,0 for a link on cells; a link on a shape is not implemented.
+Hyperlinks,_Default,"property, read-only",As Hyperlink,,MISSING,,
+Hyperlinks,_NewEnum,"property, read-only",As IUnknown,,MISSING,,
+Hyperlinks,Add,method,"Add(Anchor As Object, Address As String, [SubAddress As Variant], [ScreenTip As Variant], [TextToDisplay As Variant]) As Object",,PARTIAL,tests/fixtures/hyperlinks/hyperlinks.json; tests/test_live_excel_model_gate.py,"A link on each area of the anchor, the last answered; over the very cells of a link it takes that link's place. The cells take the Hyperlink style, and the first the text to show or, when empty, the address. SubAddress, ScreenTip and TextToDisplay not strings are error 5. A protected sheet needs AllowInsertingHyperlinks and unlocked cells. A shape anchor reports unsupported."
+Hyperlinks,Application,"property, read-only",As Application,,VERIFIED,tests/fixtures/hyperlinks/hyperlinks.json,
+Hyperlinks,Count,"property, read-only",As Long,,VERIFIED,tests/fixtures/hyperlinks/hyperlinks.json,
+Hyperlinks,Creator,"property, read-only",As XlCreator,,VERIFIED,tests/fixtures/hyperlinks/hyperlinks.json,
+Hyperlinks,Delete,method,Delete(),,VERIFIED,tests/fixtures/hyperlinks/hyperlinks.json,"Every link the collection holds goes, its cells back to the default format."
+Hyperlinks,Item,"property, read-only",As Hyperlink,,VERIFIED,tests/fixtures/hyperlinks/hyperlinks.json,"By place in the sheet's order or by name; 0, past the last and an unknown name are error 9."
+Hyperlinks,Parent,"property, read-only",As Object,,VERIFIED,tests/fixtures/hyperlinks/hyperlinks.json,"The worksheet, a range's collection's too."
 Interior,Application,"property, read-only",As Application,,UNASSESSED,,
 Interior,Color,property,As Variant,,PARTIAL,tests/fixtures/range_format.json; tests/fixtures/format/formats_answers.json; tests/test_live_excel_model_gate.py,A gradient fill reports unsupported.
 Interior,ColorIndex,property,As Variant,,PARTIAL,tests/fixtures/range_format.json; tests/fixtures/format/formats_answers.json; tests/test_live_excel_model_gate.py,A gradient fill reports unsupported.
@@ -631,7 +656,7 @@ Range,Clear,method,Clear() As Variant,,PARTIAL,tests/fixtures/excel_model/probes
 Range,ClearComments,method,ClearComments(),,VERIFIED,tests/fixtures/excel_model/probes.txt,
 Range,ClearContents,method,ClearContents([RemoveControls As Variant]) As Variant,no RemoveControls,PARTIAL,tests/fixtures/excel_model/probes.txt; tests/fixtures/row_formats/row_formats.json; tests/fixtures/autofilter_edits.json,"An emptied cell in the format its row or column gives it goes. On a filtered sheet only the visible cells clear, and clearing a filter's whole header row turns the filter off."
 Range,ClearFormats,method,ClearFormats() As Variant,,VERIFIED,tests/fixtures/range_format.json; tests/fixtures/format/formats_answers.json; tests/test_live_excel_model_gate.py; tests/fixtures/row_formats/row_formats.json; tests/fixtures/autofilter_edits.json,"Whole rows and columns lose their own formats, and positions a column's or row's format still reaches get a cell in the default format. On a filtered sheet only the visible cells, and clearing a filter's whole header row turns the filter off."
-Range,ClearHyperlinks,method,ClearHyperlinks(),,MISSING,,
+Range,ClearHyperlinks,method,ClearHyperlinks(),,VERIFIED,tests/fixtures/hyperlinks/hyperlinks.json,The links the range holds go; their cells keep their formats.
 Range,ClearNotes,method,ClearNotes() As Variant,,VERIFIED,tests/fixtures/excel_model/probes.txt,The same as ClearComments.
 Range,ClearOutline,method,ClearOutline() As Variant,,MISSING,,
 Range,Column,"property, read-only",As Long,,PARTIAL,tests/fixtures/excel_model/probes.txt,
@@ -697,7 +722,7 @@ Range,HasSpill,"property, read-only",As Variant,,VERIFIED,tests/fixtures/dynamic
 Range,Height,"property, read-only",As Variant,,PARTIAL,tests/fixtures/dimensions.json; tests/fixtures/dimensions/dimensions_answers.json; tests/fixtures/font_rows.json,"A row grows with its fonts from a measured table of eleven families; one resting on another font, a mix of tables, super- or subscript, or wrapped or turned text keeps its file's height until it changes, then reports unsupported."
 Range,Hidden,property,As Variant,,PARTIAL,tests/fixtures/dimensions.json; tests/fixtures/dimensions/dimensions_answers.json; tests/fixtures/autofilter_edits.json,"Hiding every row, or rows down to the last one, makes hidden the sheet's default as Excel does; a block that stops short of the last row is hidden row by row, and whether Excel switches over for a large one was not measured. On a filtered sheet a block with shown rows reaches only those, so showing it does nothing; showing columns there over hidden ones reports itself unsupported."
 Range,HorizontalAlignment,property,As Variant,,VERIFIED,tests/fixtures/range_format.json; tests/fixtures/format/formats_answers.json; tests/test_live_excel_model_gate.py,
-Range,Hyperlinks,"property, read-only",As Hyperlinks,,MISSING,,
+Range,Hyperlinks,"property, read-only",As Hyperlinks,,VERIFIED,tests/fixtures/hyperlinks/hyperlinks.json,"The links inside one of its areas, and for one area the link it lies in."
 Range,ID,property,As String,,MISSING,,
 Range,IndentLevel,property,As Variant,,VERIFIED,tests/fixtures/range_format.json; tests/fixtures/format/formats_answers.json; tests/test_live_excel_model_gate.py,
 Range,Insert,method,"Insert([Shift As Variant], [CopyOrigin As Variant]) As Variant",,PARTIAL,tests/fixtures/range_edit.json; tests/fixtures/excel_model/probes.txt; tests/fixtures/row_formats/row_formats.json; tests/fixtures/autofilter_edits.json; tests/fixtures/cell_shifts.json,"Whole rows and columns rewrite references, and a new row or column takes the formats beside it. Cells shifted down or right rewrite references as Excel does and take the formats above or to the left; with no Shift a range taller than it is wide shifts right. Sheets with merges or shapes and several areas of cells report unsupported. Shifting cells on a sheet whose rows or columns carry formats, and CopyOrigin:=xlFormatFromRightOrBelow, report unsupported. On a filtered sheet whole rows go in as many as the range shows, at its top, and inserting cells is error 1004."
@@ -778,13 +803,13 @@ Range,Speak,method,"Speak([SpeakDirection As Variant], [SpeakFormulas As Variant
 Range,SpecialCells,method,"SpecialCells(Type As XlCellType, [Value As Variant]) As Range",,PARTIAL,tests/fixtures/special_cells.json; tests/fixtures/excel_model/probes.txt,"Constants and formulas by kind, blanks, the last cell, visible cells and the cells with notes, split into areas as Excel splits them; validation and conditional formats report themselves unsupported."
 Range,SpillingToRange,"property, read-only",As Range,,VERIFIED,tests/fixtures/dynamic_arrays.json,The block a dynamic-array formula in the first cell spilled into; Nothing for any other cell.
 Range,SpillParent,"property, read-only",As Range,,VERIFIED,tests/fixtures/dynamic_arrays.json,The cell of the dynamic-array formula whose answer spilled over the first cell; Nothing where none did.
-Range,Style,property,As Variant,,MISSING,,
+Range,Style,property,As Variant,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json,"The cells' style, Nothing where they differ; set by name in any case or by Style object, the parts the style includes replaced and the rest kept. Error 450 for any other name or value, and on a protected sheet unless AllowFormattingCells."
 Range,SubscribeTo,method,"SubscribeTo(Edition As String, [Format As XlSubscribeToFormat]) As Variant",,MISSING,,
 Range,Subtotal,method,"Subtotal(GroupBy As Long, Function As XlConsolidationFunction, TotalList As Variant, [Replace As Variant], [PageBreaks As Variant], [SummaryBelowData As XlSummaryRow]) As Variant",,MISSING,,
 Range,Summary,"property, read-only",As Variant,,MISSING,,
 Range,Table,method,"Table([RowInput As Variant], [ColumnInput As Variant]) As Variant",,MISSING,,
 Range,Text,"property, read-only",As Variant,,PARTIAL,tests/fixtures/excel_model/probes.txt; tests/fixtures/number_formats.json; tests/fixtures/number_spelling.json; tests/fixtures/value_typing.json,"Excel's number formats on a US English system, in a column wide enough for the value; a value a format cannot show fills the column with #. A * fill reports itself unsupported, and a value too wide for its column, which Excel cuts to # or fewer digits, is not modelled."
-Range,TextToColumns,method,"TextToColumns([Destination As Variant], [DataType As XlTextParsingType], [TextQualifier As XlTextQualifier], [ConsecutiveDelimiter As Variant], [Tab As Variant], [Semicolon As Variant], [Comma As Variant], [Space As Variant], [Other As Variant], [OtherChar As Variant], [FieldInfo As Variant], [DecimalSeparator As Variant], [ThousandsSeparator As Variant], [TrailingMinusNumbers As Variant]) As Variant",,MISSING,,
+Range,TextToColumns,method,"TextToColumns([Destination As Variant], [DataType As XlTextParsingType], [TextQualifier As XlTextQualifier], [ConsecutiveDelimiter As Variant], [Tab As Variant], [Semicolon As Variant], [Comma As Variant], [Space As Variant], [Other As Variant], [OtherChar As Variant], [FieldInfo As Variant], [DecimalSeparator As Variant], [ThousandsSeparator As Variant], [TrailingMinusNumbers As Variant]) As Variant",,PARTIAL,tests/fixtures/text_to_columns.json,"Delimited and fixed width, every delimiter, runs of them, qualifiers, typing, FieldInfo's kinds and how each date order reads a field, separators, a trailing minus and a destination as Excel does them. FieldInfo pairs that do not number the columns 1, 2, 3 in order, a column of formulas and a sheet with merged cells report themselves unsupported; an omitted argument takes its default, whether Excel carries one over from an earlier call not being measured."
 Range,TogglePythonMarshalMode,method,TogglePythonMarshalMode([MarshalMode As Variant]),,MISSING,,
 Range,Top,"property, read-only",As Variant,,PARTIAL,tests/fixtures/dimensions.json; tests/fixtures/dimensions/dimensions_answers.json; tests/fixtures/font_rows.json,"A row grows with its fonts from a measured table of eleven families; one resting on another font, a mix of tables, super- or subscript, or wrapped or turned text keeps its file's height until it changes, then reports unsupported."
 Range,Ungroup,method,Ungroup() As Variant,,MISSING,,
@@ -1031,6 +1056,46 @@ SortFields,Count,"property, read-only",As Long,,VERIFIED,tests/fixtures/sort.jso
 SortFields,Creator,"property, read-only",As XlCreator,,MISSING,,
 SortFields,Item,"property, read-only",As SortField,,UNASSESSED,,
 SortFields,Parent,"property, read-only",As Object,,MISSING,,
+Style,_Default,"property, read-only",As String,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json,
+Style,AddIndent,property,As Boolean,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json; tests/fixtures/cell_styles/style_changes.json,Read and set; each cell that follows the style follows it while the style includes the part.
+Style,Application,"property, read-only",As Application,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json,
+Style,Borders,"property, read-only",As Borders,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json; tests/fixtures/cell_styles/style_changes.json,"xlLeft, xlRight, xlTop and xlBottom, and 1 to 4, are its edges and 5 and 6 its diagonals, set as a range's are; Borders(7) to Borders(12) read -4142 and 2 where edge 1 to 6 has a line in the automatic colour, else Null, and setting one does nothing. A property set on the collection sets all six; one read reports unsupported."
+Style,BuiltIn,"property, read-only",As Boolean,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json; tests/fixtures/cell_styles/style_changes.json,"Setting it is error 450, as in Excel."
+Style,Creator,"property, read-only",As XlCreator,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json,
+Style,Delete,method,Delete() As Variant,,PARTIAL,tests/fixtures/cell_styles/style_changes.json,"Its cells go to Normal, every part they did not set themselves following Normal from then on; a built-in style stays in the file, hidden. Normal is error 1004, as is a workbook with a protected sheet."
+Style,Font,"property, read-only",As Font,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json; tests/fixtures/cell_styles/style_changes.json,"Read and set as a range's are; Superscript and Subscript read False while the style leaves its font out. Normal's font takes colours and strikethrough; its size, face, bold, italic and underline, which the sheets' geometry rests on, report unsupported."
+Style,FormulaHidden,property,As Boolean,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json; tests/fixtures/cell_styles/style_changes.json,Read and set; each cell that follows the style follows it while the style includes the part.
+Style,HorizontalAlignment,property,As XlHAlign,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json; tests/fixtures/cell_styles/style_changes.json,Read and set; each cell that follows the style follows it while the style includes the part.
+Style,IncludeAlignment,property,As Boolean,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json; tests/fixtures/cell_styles/style_changes.json,Read and set: a part included again reaches the cells that took it from the style; one left out stays with them as it is.
+Style,IncludeBorder,property,As Boolean,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json; tests/fixtures/cell_styles/style_changes.json,Read and set: a part included again reaches the cells that took it from the style; one left out stays with them as it is.
+Style,IncludeFont,property,As Boolean,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json; tests/fixtures/cell_styles/style_changes.json,Read and set: a part included again reaches the cells that took it from the style; one left out stays with them as it is.
+Style,IncludeNumber,property,As Boolean,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json; tests/fixtures/cell_styles/style_changes.json,Read and set: a part included again reaches the cells that took it from the style; one left out stays with them as it is.
+Style,IncludePatterns,property,As Boolean,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json; tests/fixtures/cell_styles/style_changes.json,Read and set: a part included again reaches the cells that took it from the style; one left out stays with them as it is.
+Style,IncludeProtection,property,As Boolean,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json; tests/fixtures/cell_styles/style_changes.json,Read and set: a part included again reaches the cells that took it from the style; one left out stays with them as it is.
+Style,IndentLevel,property,As Long,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json; tests/fixtures/cell_styles/style_changes.json,"Null unless aligned left, right or distributed and not turned. Read and set; each cell that follows the style follows it while the style includes the part."
+Style,Interior,"property, read-only",As Interior,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json; tests/fixtures/cell_styles/style_changes.json,"Read and set as a range's are, but its automatic pattern colour stays white or black, as it is, where a cell's turns black."
+Style,Locked,property,As Boolean,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json; tests/fixtures/cell_styles/style_changes.json,Read and set; each cell that follows the style follows it while the style includes the part.
+Style,MergeCells,property,As Variant,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json,"Error 1004, as Excel's is."
+Style,Name,"property, read-only",As String,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json; tests/fixtures/cell_styles/style_changes.json,"Setting it is error 450, as in Excel."
+Style,NameLocal,"property, read-only",As String,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json; tests/fixtures/cell_styles/style_changes.json,"Setting it is error 1004, as in Excel."
+Style,NumberFormat,property,As String,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json; tests/fixtures/cell_styles/style_changes.json,Read and set; each cell that follows the style follows it while the style includes the part.
+Style,NumberFormatLocal,property,As String,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json; tests/fixtures/cell_styles/style_changes.json,Read and set; each cell that follows the style follows it while the style includes the part.
+Style,Orientation,property,As XlOrientation,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json; tests/fixtures/cell_styles/style_changes.json,Read and set; each cell that follows the style follows it while the style includes the part.
+Style,Parent,"property, read-only",As Object,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json,
+Style,ReadingOrder,property,As Long,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json; tests/fixtures/cell_styles/style_changes.json,Read and set; each cell that follows the style follows it while the style includes the part.
+Style,ShrinkToFit,property,As Boolean,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json; tests/fixtures/cell_styles/style_changes.json,Read and set; each cell that follows the style follows it while the style includes the part.
+Style,Value,"property, read-only",As String,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json; tests/fixtures/cell_styles/style_changes.json,"Setting it is error 450, as in Excel."
+Style,VerticalAlignment,property,As XlVAlign,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json; tests/fixtures/cell_styles/style_changes.json,Read and set; each cell that follows the style follows it while the style includes the part.
+Style,WrapText,property,As Boolean,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json; tests/fixtures/cell_styles/style_changes.json,Read and set; each cell that follows the style follows it while the style includes the part.
+Styles,_Default,"property, read-only",As Style,,MISSING,,
+Styles,_NewEnum,"property, read-only",As IUnknown,,MISSING,,
+Styles,Add,method,"Add(Name As String, [BasedOn As Variant]) As Style",,PARTIAL,tests/fixtures/cell_styles/cell_styles.json; tests/fixtures/cell_styles/style_changes.json,"A copy of Normal, or of the first cell of BasedOn without the parts its cells do not share. A name with no characters (Excel's Style 1) reports unsupported."
+Styles,Application,"property, read-only",As Application,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json,
+Styles,Count,"property, read-only",As Long,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json,
+Styles,Creator,"property, read-only",As XlCreator,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json,
+Styles,Item,"property, read-only",As Style,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json,By name in any case or by place in the sorted list.
+Styles,Merge,method,Merge(Workbook As Variant) As Variant,,PARTIAL,tests/fixtures/cell_styles/style_changes.json,"A style named as one here takes its place, keeping this workbook's spelling, and reaches the cells that follow it; the rest come in the order their names sort. A workbook with another theme, a Normal that differs and a built-in style this workbook deleted report unsupported."
+Styles,Parent,"property, read-only",As Object,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json,
 TextFrame,Application,"property, read-only",As Application,,MISSING,,
 TextFrame,AutoMargins,property,As Boolean,,MISSING,,
 TextFrame,AutoSize,property,As Boolean,no setter,UNASSESSED,,
@@ -1366,7 +1431,7 @@ Workbook,ShowPivotTableFieldList,property,As Boolean,,MISSING,,
 Workbook,Signatures,"property, read-only",As SignatureSet,,MISSING,,
 Workbook,SlicerCaches,"property, read-only",As SlicerCaches,,MISSING,,
 Workbook,SmartDocument,"property, read-only",As SmartDocument,,MISSING,,
-Workbook,Styles,"property, read-only",As Styles,,MISSING,,
+Workbook,Styles,"property, read-only",As Styles,,PARTIAL,tests/fixtures/cell_styles/cell_styles.json,"Excel's 47 built-in styles and every one the file or a macro adds, in the order Windows word sort puts their names."
 Workbook,Sync,event,Sync(SyncEventType As MsoSyncEventType),,MISSING,,
 Workbook,TableStyles,"property, read-only",As TableStyles,,MISSING,,
 Workbook,TemplateRemoveExtData,property,As Boolean,,MISSING,,
@@ -1466,7 +1531,7 @@ Worksheet,ExportAsFixedFormat,method,"ExportAsFixedFormat(Type As XlFixedFormatT
 Worksheet,FilterMode,"property, read-only",As Boolean,,PARTIAL,tests/fixtures/autofilter.json; tests/fixtures/autofilter_file/autofilter_file.json; tests/test_live_excel_model_gate.py,
 Worksheet,FollowHyperlink,event,FollowHyperlink(Target As Hyperlink),,MISSING,,
 Worksheet,HPageBreaks,"property, read-only",As HPageBreaks,,MISSING,,
-Worksheet,Hyperlinks,"property, read-only",As Hyperlinks,,MISSING,,
+Worksheet,Hyperlinks,"property, read-only",As Hyperlinks,,VERIFIED,tests/fixtures/hyperlinks/hyperlinks.json; tests/test_live_excel_model_gate.py,"In the order they were added, a link replaced keeping its place."
 Worksheet,Index,"property, read-only",As Long,,PARTIAL,tests/fixtures/excel_model/probes.txt,
 Worksheet,LensGalleryRenderComplete,event,LensGalleryRenderComplete(),,MISSING,,
 Worksheet,ListObjects,"property, read-only",As ListObjects,,PARTIAL,tests/fixtures/tables/tables.json,"The sheet's tables, read from a file or made by ListObjects.Add."

{pyopenvba-6.1.3 → pyopenvba-6.2.0}/docs/host_completeness.md

@@ -138,12 +138,12 @@ entry tracked explicitly.
 | VBA projects and forms | In-scope MS-OVBA gates, designer round trips and live file gates exist; shared library-reference add/remove operations pass native Excel/Word/PowerPoint checks and Access persistence tests | Reconcile every operation with its format and protection/signing limits; distinguish form design from form runtime; linked VBA-project creation and arbitrary library runtime resolution remain separate gaps |
 | VBA language and runtime | Measured semantics, classes, errors and control flow exist; every constant of VBA's own type library, the colour, key-code and system-colour modules included, typed as declared; Scripting.Dictionary in memory, its key matching measured | Audit complete syntax, type system, lifetime, references and intrinsics; track file I/O, external calls and known typing gaps explicitly |
 | Application, workbooks and sheets | Core collections, cells, names and queries exist; sheet protection -- Protect, Unprotect, the Protection object and every edit a protected sheet refuses a macro, with Excel's own errors -- follows 168 live cases, and is saved and read as Excel saves and reads it, SHA-512 and legacy passwords included, over 13 files and a live gate; workbook protection -- Protect, Unprotect and the sheet changes a protected structure refuses -- follows 41 cases and 5 files, with a live gate; windows -- ActiveWindow, Windows, Goto, each sheet's zoom, view, display settings, scrolling, frozen panes and selection, the tabs and the window order -- follow 113 live workbooks, saved and read as Excel saves and reads them | Map all reference members; identify stubs, missing collections and incomplete arguments; allowed edit ranges and copying or moving sheets between workbooks while one is protected; a split that is not frozen, which Excel keeps in twips of the window; NewWindow, hidden windows and a window's size and state |
-| Ranges and editing | Values, formulas, areas and basic movement exist; written values are typed as Excel types them, with the formats typing brings, prefix characters, Text cells and Value/Value2 types, pinned by 3,947 live writes and a saved workbook; formulas a macro writes are spelled as Excel spells them over 120 live formulas; NumberFormat codes round-trip Excel's spelling on both sides; Range.Text, TEXT and WorksheetFunction.Text follow Excel's number-format engine over 156 live codes and 28 values, and round times as Excel does over 152 times on the half second; CurrentRegion and End pass 34 live layouts, FillDown/Up/Right/Left 16 and SpecialCells 18; single-area Find/FindNext/FindPrevious pass 48 native cases; Replace passes 80 live layouts and the formula-bar text of 20 numbers in 26 formats; the clipboard's Copy, Cut, Paste and PasteSpecial pass 49; Range.Sort and the Sort object pass 58, in Excel's order for ASCII text over 583 values; AutoFill passes 208 layouts and 520 columns, its series of numbers, dates, times, text and names to the last digit; RemoveDuplicates passes 98; AutoFilter passes 113 layouts, reads and writes 41 filters as Excel saves them, and passes a live gate; edits on a filtered sheet -- writes, formats, clears, fills, copies, sorts, deletes and inserts, and the filter following rows and columns -- match 190 of 195 live layouts, the other 5 reporting themselves unsupported (two-dimensional arrays over several areas); SUBTOTAL passes 31 live layouts over hidden, filtered and nested rows and references that functions and operators give; every edit above meets sheet protection as Excel's does; Cut moves the references that overlap it as Excel does over 24 live layouts; cell shifts -- Insert and Delete with a Shift or none -- move references, names, the filter's range and formats as Excel does over 47 live layouts; merged-range geometry/value operations pass 21 native cases and four persistence gates; FormulaR1C1 scalar and array writes/reads pass 27 native cases and five persistence gates; A1 Formula array writes share the implementation and pass 15 native cases plus four persistence gates | Complete multi-area/comment/format/MatchByte searches, complex across/multi-area merges and merge formatting; Range.Text with a `*` fill and in columns too narrow for a value (both need text widths in pixels); audit insertion, deletion, copying, sorting and filtering |
+| Ranges and editing | Values, formulas, areas and basic movement exist; written values are typed as Excel types them, with the formats typing brings, prefix characters, Text cells and Value/Value2 types, pinned by 4,902 live writes and a saved workbook; formulas a macro writes are spelled as Excel spells them over 120 live formulas; NumberFormat codes round-trip Excel's spelling on both sides; Range.Text, TEXT and WorksheetFunction.Text follow Excel's number-format engine over 156 live codes and 28 values, and round times as Excel does over 152 times on the half second; CurrentRegion and End pass 34 live layouts, FillDown/Up/Right/Left 16 and SpecialCells 18; single-area Find/FindNext/FindPrevious pass 48 native cases; Replace passes 80 live layouts and the formula-bar text of 20 numbers in 26 formats; the clipboard's Copy, Cut, Paste and PasteSpecial pass 49; Range.Sort and the Sort object pass 58, in Excel's order for ASCII text over 583 values; AutoFill passes 208 layouts and 520 columns, its series of numbers, dates, times, text and names to the last digit; RemoveDuplicates passes 98; TextToColumns passes 54 of 57 live cases of delimiters, qualifiers, typing, FieldInfo and its six date orders, separators and fixed widths, the other 3, FieldInfo pairs out of order, reporting themselves unsupported; Range.Range passes 29 live probes and a space-separated intersection 5; AutoFilter passes 113 layouts, reads and writes 41 filters as Excel saves them, and passes a live gate; edits on a filtered sheet -- writes, formats, clears, fills, copies, sorts, deletes and inserts, and the filter following rows and columns -- match 190 of 195 live layouts, the other 5 reporting themselves unsupported (two-dimensional arrays over several areas); SUBTOTAL passes 31 live layouts over hidden, filtered and nested rows and references that functions and operators give; every edit above meets sheet protection as Excel's does; Cut moves the references that overlap it as Excel does over 24 live layouts; cell shifts -- Insert and Delete with a Shift or none -- move references, names, the filter's range and formats as Excel does over 47 live layouts; merged-range geometry/value operations pass 21 native cases and four persistence gates; FormulaR1C1 scalar and array writes/reads pass 27 native cases and five persistence gates; A1 Formula array writes share the implementation and pass 15 native cases plus four persistence gates | Complete multi-area/comment/format/MatchByte searches, complex across/multi-area merges and merge formatting; Range.Text with a `*` fill and in columns too narrow for a value (both need text widths in pixels); typing a space before a month's name and a time, or digits after AM or PM and a point, which Excel misreads into numbers; audit insertion, deletion, copying, sorting and filtering |
 | Named ranges | Workbook/worksheet CRUD, validation, scope precedence, rename/retarget/delete, visibility/comments and Python snapshots share one implementation; 19 native cases and three persistence gates | Active-cell-relative name semantics, locale translation, Excel 4 macro metadata and arbitrary named-formula evaluation remain incomplete |
 | Multiple workbooks and sheet copying | Add/open/activate/close; VBA sheet Copy/Move before/after or into a new book, matching native held-object invalidation on cross-book moves; inter-book range copies import used names and aliases with reuse/rename/error policies, backed by native probes and persistence gates | External workbook links, independent VBA projects, sheet-copy/move name conflicts, relative/other-sheet name imports, transferred drawings/controls, sheet modules and advanced worksheet metadata remain incomplete |
 | Structural edits | Whole-row/column insertion/deletion and formula/name reference updates pass 12 native cases and four persistence gates; occupied-edge insertion is atomic | Partial-cell reference rewriting, relative name context, merges/shapes, formatting inheritance/CopyOrigin and table/validation/chart metadata updates remain incomplete |
 | Range copying | Explicit-destination copies pass 17 native cases and five persistence gates: overlap, blanks, repeated blocks, formulas, cross-sheet copying and measured formatting | Merged-cell and multi-area copies, destinations larger than 1,048,576 cells, clipboard/paste behavior and full formatting fidelity remain incomplete |
-| Formatting and layout | Cell formats are complete for Font, Interior, Borders, alignment, protection, NumberFormat and ClearFormats: 161 live probes, an Excel-authored workbook read back value for value, the border storage rules, a live gate for model-written formats, and a stylesheet Excel's for the same edits except one font-order quirk. Row heights, column widths and hidden rows and columns follow Excel on a 96-DPI display: 185 live probes, Excel-authored and foreign files read back, the saved XML Excel's, and a live gate. Rows grow with their fonts from a 25,662-row table measured for eleven font families in four styles, beside the Normal font and alone on a row. Row, column and sheet-wide formats follow Excel: 149 live probes, Excel's saved workbook read back, 16 foreign files read and written back as Excel does, the model's saved XML Excel's, and a live gate. Medium, thick and double borders make rows taller as Excel's do, 39 more probes in the same fixture. Data validation reads, adds, changes, deletes and checks rules as Excel does, each rule moving with inserts and deletes, splitting round a delete or a Clear and carried by a copy, over 39 live workbooks and the dataValidations element Excel saves | Named cell styles (`Range.Style`, `Styles`), conditional formatting and page setup; a validation list read from another sheet, which Excel keeps in the worksheet's x14 extension; cell shifts (`Insert`/`Delete` with `Shift`) on sheets with row or column formats; rows mixing fonts from different tables, unmeasured fonts, super/subscript and wrapped or turned text; a thick border along a hidden row; column AutoFit; Normal fonts other than Aptos Narrow 11 and Calibri 11 |
+| Formatting and layout | Cell formats are complete for Font, Interior, Borders, alignment, protection, NumberFormat and ClearFormats: 161 live probes, an Excel-authored workbook read back value for value, the border storage rules, a live gate for model-written formats, and the stylesheet Excel writes for the same edits, entry for entry. Row heights, column widths and hidden rows and columns follow Excel on a 96-DPI display: 185 live probes, Excel-authored and foreign files read back, the saved XML Excel's, and a live gate. Rows grow with their fonts from a 25,662-row table measured for eleven font families in four styles, beside the Normal font and alone on a row. Row, column and sheet-wide formats follow Excel: 149 live probes, Excel's saved workbook read back, 16 foreign files read and written back as Excel does, the model's saved XML Excel's, and a live gate. Medium, thick and double borders make rows taller as Excel's do, 39 more probes in the same fixture. Data validation reads, adds, changes, deletes and checks rules as Excel does, each rule moving with inserts and deletes, splitting round a delete or a Clear and carried by a copy, over 39 live workbooks and the dataValidations element Excel saves. Named cell styles -- `Range.Style`, `Styles` with `Add` and `Merge`, and the `Style` object's properties, read, set and deleted -- answer as Excel's do over 11,147 live reads and 6,459 more of styles a macro changes, deletes and merges: the 47 built-in styles given to cells in both orders, styles over formats and formats over styles, which cells follow a changed style, Normal's font, protected sheets; the stylesheet Excel writes for them, in the order its tables hold what a session made, under two themes and after a reopen, over 45 saved workbooks, files holding entries nothing uses, entries twice and custom formats out of order among them, and a live gate opens ten of the model's in Excel, which reads them as its own; an edge two cells' styles both draw reads as Excel reads it over 415 pairs | Normal's font size, face, bold, italic and underline, which the sheets' geometry rests on; a style of a workbook that is not the active one, which Excel changes in the active workbook; conditional formatting and page setup; a validation list read from another sheet, which Excel keeps in the worksheet's x14 extension; cell shifts (`Insert`/`Delete` with `Shift`) on sheets with row or column formats; rows mixing fonts from different tables, unmeasured fonts, super/subscript and wrapped or turned text; a thick border along a hidden row; column AutoFit; Normal fonts other than Aptos Narrow 11 and Calibri 11 |
 | Tables and structured references | Power Query reads workbook tables and writes load targets; ListObjects reads a file's tables and makes new ones as Excel does -- headers, generated column names, the header row put in, the name and style -- with ListObject, ListColumns and ListRows answering, and saves them in the parts Excel writes, over 8 live workbooks and 15 live questions; a table read from a file keeps its part until it changes, and whole rows inserted or deleted through it carry it. Structured references are read, spelled, saved and worked out as Excel does over 80 live formulas and a 50-name character sweep: this row, special items, spans, escapes, the table's name left out inside it, a column read as this row's cell where one value is wanted, Range and Evaluate, AutoFill along the columns, and renaming a table or its columns through every formula. The totals row shows and hides as Excel does over 20 live workbooks, with its default label and function, every TotalsCalculation, and labels, SUBTOTALs and formulas written into it. ListRows.Add and Delete, ListColumns.Add and Delete, Resize and Delete, calculated columns, and a table growing over what a macro writes beside it, with the references it stretches, match 28 live workbooks and 21 live writes | Unlist, which turns the table style into cell formats; a copy or fill beside a table, which puts a table row in first; whole columns inserted or deleted through a table; the dxf a calculated column made from one cell brings; and a header holding a carriage return, which VBA reads as a line feed |
 | Formulas and calculation | Cells are worked out by pyOfficeEditor's engine, 493 of Excel's 525 functions, which comes to what Excel cached for all 10,958 formulas of its corpus over the model's workbook; formula parser, dependency invalidation and manual mode exist; a formula's last sum set to zero when it cancels, comparisons to fifteen digits and lookups to the bit follow Excel over 1,788 live pairs of doubles; defined names that stand for a formula work out where they are used, as array formulas; a range or array where one value is wanted is cut to the formula's row or column or run item by item, SUMPRODUCT, INDEX, ROWS and COLUMNS work their arguments out as arrays, and a value where a function reads cells is refused, as 232 live formulas show and as each of the engine's 493 functions measured there does, 15 of them taken; a call with too few or too many arguments, a LET's or a LAMBDA's name that is none, and a formula past Excel's limits on text, brackets, calls, signs and length are refused, over 14,377 live formulas, every function with 25 counts of arguments; a running total 3000 rows down and the deepest formulas Excel takes work out as Excel does; a formula written in the other notation, `Formula = "=R[-1]C+1"` or `FormulaR1C1 = "=A1"`, reads as Excel reads it, over 79 live formulas; LET's and LAMBDA's names, those looking like cells among them, and LAMBDA's optional parameters read, work out and save as Excel's do, over 24 live formulas; a formula written to a General cell takes the number format Excel gives it, over 111 live cases; `FormulaArray`, `HasArray` and `CurrentArray` follow Excel over 78 live cases, array formulas saved and read as Excel does; the range operator, intersections, unions and INDEX, OFFSET, INDIRECT, CHOOSE, IF, IFS, SWITCH and XLOOKUP as references follow Excel over 45 live formulas, and INDEX with one index into rows and columns and a `+` before a reference over 26 more; `Formula2` and `Formula2R1C1` read a legacy formula with Excel's `@` over 2100 live formulas, every function in every way it takes an argument; an `@` or a call of SINGLE written through `Formula`, `Formula2`, `FormulaR1C1` or `Value` is kept, left out, read back and saved as Excel does, over 274 live writes and a saved workbook; dynamic arrays spill, grow, shrink and are #SPILL! where something is in the way, with `HasSpill`, `SpillParent`, `SpillingToRange`, `A1#` and their file format, over 42 live cases, 18 expressions and two saved workbooks | Complete function and argument coverage, spills and structural edits (sort, insert and delete through a spill), copying part of an array formula, relative R1C1 in INDIRECT and unions for functions beyond the aggregates, errors, circular/iterative calculation, cached-value persistence and names with relative references |
 | VBA WorksheetFunction and Evaluate | WorksheetFunction.X and the late-bound Application.X call the cell formula engine for the 388 WorksheetFunction members it has, with arguments, answers and errors converted as 160 live calls made both ways show; Evaluate, `[...]` and Worksheet.Evaluate work out expressions through the same engine as Excel does over 91 live cases: a Range for cells, blocks whole, error values, ROW() as an array of one | The WorksheetFunction members the engine lacks: the cube functions, WEBSERVICE, STOCKHISTORY and the like; the members registered with the engine checked through VBA one by one |
@@ -152,7 +152,7 @@ entry tracked explicitly.
 | Charts | Existing chart parts can be preserved and shapes identified | Audit chart objects, creation, series, axes, formatting, data links and round trips |
 | Pivots, caches and data model | Unmodelled content is preserved in existing files | Inventory and implement headless operations; preservation alone is not runtime support |
 | Power Query | Packaging, M evaluation, local refresh and sheet load targets exist | Complete language/library conformance, data types, errors, query dependency behavior, connectors and refresh settings |
-| Other workbook features | Coverage varies and needs classification; notes, which VBA calls comments, are added, read, edited, moved with their cells, copied and saved as Excel does, over 89 live probes and a saved workbook of every kind of note, its parts written byte for byte | Inventory names, links, threaded comments, hyperlinks, protection, metadata, embedded objects, connections and remaining reference/file features; a note's box a macro moves or resizes, and notes under Sort and RemoveDuplicates |
+| Other workbook features | Coverage varies and needs classification; notes, which VBA calls comments, are added, read, edited, moved with their cells, copied and saved as Excel does, over 89 live probes and a saved workbook of every kind of note, its parts written byte for byte. Hyperlinks are added, read, set, taken away, moved, copied, pasted, cut, sorted and saved as Excel does, with the Hyperlink style and the HYPERLINK function's, over 26 sections of live Excel and 21 workbooks it saved, their links, relationships, cell styles and stylesheets matched, and a live gate opens the model's in Excel, which reads them as its own; a part's relationships come in Excel's order, from the hash Office places their ids by, over every count to 160 and 17 larger ones up to 65,530 | Inventory names, links, threaded comments, protection, metadata, embedded objects, connections and remaining reference/file features; a note's box a macro moves or resizes, and notes under Sort and RemoveDuplicates; a hyperlink on a shape, EmailSubject on a link with no address, Follow, a paste of links turned or from several areas, and the relationship order of a part with more than 65,536 |
 | Fidelity and release verification | Offline tests, live gates, language matrix and cross-platform CI exist | Add real-world mixed-feature cases, malformed/foreign-author packages and scale tests; require live evidence for new persisted behavior |
 
 ## Execution order within Excel

{pyopenvba-6.1.3 → pyopenvba-6.2.0}/docs/vba_runtime.md

@@ -572,6 +572,49 @@ does (`tests/fixtures/remove_duplicates.json`, 98 layouts).
   merged cells, row and column formats, and a destination that runs on
   in two directions at once report themselves unsupported.
 
+**Text to columns.** `Range.TextToColumns` splits a column of text as
+Excel does (`tests/fixtures/text_to_columns.json`, 57 cases).
+
+* Only a range of one column splits; more is error 1004. Each line splits
+  at any of the delimiters asked for, OtherChar giving only its first
+  character, and with none asked for it stays whole. ConsecutiveDelimiter
+  reads a run of them as one, though a field in quotes, `""` included, is
+  a field of its own. A field in the text qualifier, a double quote
+  unless TextQualifier asks for a single one or none, keeps the
+  delimiters in it and reads a doubled qualifier as one.
+* Every row of the block is written across the widest line: a field that
+  is empty, or that a shorter line lacks, clears its cell and leaves its
+  format. A number or a blank in the source column stays as it is. A
+  Destination moves the block's corner, on the source's sheet whichever
+  sheet it names.
+* A field is typed as typing a cell types it, into a number, a date, a
+  time, TRUE or an error, with the format typing brings where the cell's
+  own is General. A format of the cell's own stays, and a cell formatted
+  Text still takes the number. A field starting with `=` is a formula.
+  `5-` is text unless TrailingMinusNumbers is True, `-0` is 0, and a
+  number past Excel's largest stays text. DecimalSeparator and
+  ThousandsSeparator read numbers written with other separators.
+* FieldInfo gives the columns, in order, a kind: xlTextFormat keeps the
+  field as it is and formats the cell Text, a date order reads the field
+  as that order's date, and xlSkipColumn drops the column. With DataType
+  xlFixedWidth each line is cut where the pairs start, counted from 0.
+* A date column fills its day, month and year in its order from runs of
+  digits split at `/`, `-`, `.` or a space, a run of separators counting
+  as one: two digits to a day or a month and four to a year, the rest
+  spilling into the next part, so `5/2020` in an MDY column is 20 May
+  2020. A month's name fills a month. A run of digits with no separator
+  is cut by its length: four digits two and two, five with one for the
+  month, six two each, eight at the parts' widths. Three parts make an
+  m/d/yyyy date if they are one. Two go by a fixed table, not the
+  letters' order: DMY, YMD and YDM read a day and its month, else a year
+  and its month; MDY, MYD and DYM a month and its day, else a month and
+  its year; a day read so falls in the current year. A field the column
+  reads no date in is typed as a General column types it.
+* FieldInfo pairs that do not number the columns 1, 2, 3 in order, a
+  column holding formulas and a sheet with merged cells report
+  themselves unsupported. An omitted argument takes its default; whether
+  Excel carries one over from an earlier call is not measured.
+
 **The clipboard.** `Range.Copy` and `Range.Cut` with no destination put
 the range on the clipboard, and `Application.CutCopyMode` reads 1 after
 a copy, 2 after a cut and 0 once it is cleared; setting it to False
@@ -740,10 +783,9 @@ protection properties, `NumberFormat` and `ClearFormats` read and write a
 cell's format the way Excel does; 161 probes of live Excel pin the
 answers (`tests/fixtures/range_format.json`). A workbook's `styles.xml`
 is read into one format per cell, so a file Excel formatted reads back
-exactly as Excel reads it, and a save appends only the entries the file
-lacks, spelled as Excel spells them: for the same edits the stylesheet
-comes out byte for byte as Excel's, except that Excel writes a red font
-first whenever one is used.
+exactly as Excel reads it, and a save writes the stylesheet the way Excel
+writes it (see **The stylesheet** below): for the same edits it comes out
+byte for byte as Excel's (`tests/fixtures/format/formats.xlsx`).
 
 * A property read over several cells answers the shared value or Null.
   Colours compare as colours, and a mixed `Interior.Color` or
@@ -763,6 +805,12 @@ first whenever one is used.
   neighbour's copy. An inside border is written on both cells, and one
   that only one of them stored comes out in the automatic colour, which
   the file writes `auto="1"`.
+* Cell styles can leave both cells drawing the edge between them, and
+  then the stronger line style shows -- double, thick, medium, the
+  medium dashes, slanted dash-dot, thin, dashed, dotted, dash-dot,
+  dash-dot-dot, hair -- and between two of one style the darker colour,
+  by 2R + 5G + B, as 415 pairs of cells in live Excel show
+  (`tests/fixtures/cell_styles/shared_edges.json`).
 * `LineStyle` and `Weight` pair into the thirteen line styles the file
   has; a style keeps the current weight when the pair exists and takes
   its own default otherwise.
@@ -770,22 +818,103 @@ first whenever one is used.
   left-aligned, and choosing an alignment that cannot be indented drops
   the indent. `ClearFormats` unmerges.
 
-`Range.Style`, the `Styles` collection and conditional formats are not
-implemented yet; the operation checklist, `docs/excel_checklist.csv`,
-records each member's status.
+**Cell styles.** `Range.Style`, the `Styles` collection and the `Style`
+object answer as Excel's do over 11,147 reads in live Excel
+(`tests/fixtures/cell_styles/cell_styles.json`), and styles a macro
+changes, deletes and merges over 6,459 more (`style_changes.json`, made
+by `scripts/measure_style_changes.py`). The 45 workbooks Excel saved on
+the way are written the same by the model, entry for entry.
+
+* A new workbook lists Excel's 47 built-in styles, and its file holds
+  only Normal until a cell uses another. Styles are listed in the order
+  Windows word sort puts their names, and a name finds its style in any
+  case.
+* Giving a range a style replaces the parts of its cells' formats the
+  style includes -- `IncludeNumber`, `IncludeFont`, `IncludeAlignment`,
+  `IncludeBorder`, `IncludePatterns`, `IncludeProtection` -- and keeps
+  the rest; a border the style includes replaces all four sides. A range
+  whose cells have different styles answers Nothing. Anything but the
+  name of a style or a `Style` is error 450, and so is a protected sheet
+  that does not allow formatting cells.
+* `Styles.Add` copies Normal, or the first cell of `BasedOn`, leaving out
+  the parts the range's cells do not share.
+* A style's properties set as a range's do. The style changes, and each
+  cell, row and column format that did not set the part itself follows,
+  while the style includes the part; including a part again brings the
+  style's part back to them. A built-in style a macro touches, even to
+  set what it was, is written `customBuiltin`.
+* Normal's font is the file's first font, which every format in it points
+  at, so a change to it reaches cells of any style that did not set their
+  font. The model takes its colours and strikethrough, and reports its
+  size, face, bold, italic and underline unsupported: the sheets' column
+  widths and row heights rest on them.
+* A style's `Borders` are its edges by `xlLeft`, `xlRight`, `xlTop` and
+  `xlBottom` and its diagonals by 5 and 6; `Borders(7)` to `Borders(12)`
+  read -4142 and 2 where the edge in that turn has a line in the
+  automatic colour, else Null, and setting one does nothing. A style's
+  automatic pattern colour stays white or black, where a cell's turns
+  black. `Superscript` and `Subscript` read False while the style leaves
+  its font out, and `IndentLevel` is Null unless the style aligns left,
+  right or distributed and does not turn its text.
+* `Style.Delete` moves its cells to Normal, each part they did not set
+  themselves following Normal from then on; a built-in style stays in
+  the file, hidden, a held `Style` of it is error 424, and Normal is
+  error 1004. `Styles.Merge` brings another workbook's styles in: one
+  named as one here takes its place and reaches the cells that follow
+  it, keeping this workbook's spelling, and the rest come in the order
+  their names sort.
+* A protected sheet in the workbook makes a change or a delete error
+  1004, whatever the protection allows. A macro that changes a style of
+  a workbook that is not the active one changes the active workbook's
+  style of that name in Excel; the model reports that unsupported.
+* A save writes a built-in style while a cell uses it, a macro changed
+  it or deleted it, and every style a macro added: after the file's own,
+  the built-in ones in Excel's order and then the rest in the order they
+  were made, each in the theme's fonts.
+
+**The stylesheet.** Excel keeps a workbook's number formats, fonts,
+fills, borders, cell styles and cell xfs as tables in the order they
+came -- the file's own, then the parts of its built-in styles, then what
+the session made -- and a save writes the ones in use in that order and
+leaves the rest out. The model keeps the same tables
+(`tests/fixtures/cell_styles/order.xlsx`).
+
+* A new part equal to a built-in style's takes that style's place: a red
+  font, which Warning Text has, comes ahead of the fonts a macro made
+  before it.
+* A custom number format takes its id when it is made, and a save leaves
+  a gap where one was made and then dropped. Opening a file numbers its
+  custom formats from 164 in the order it lists them.
+* A cell xf changes in place when its style changes, and two that come
+  to say the same stay apart. Opening a file, Excel works each xf's apply
+  flags out afresh and takes an xf that then points at what an earlier
+  one points at as that one; a font the file holds twice stays two.
+* A save that follows no change to a format leaves the stylesheet as the
+  file had it, as it leaves a sheet no macro wrote to.
+
+Conditional formats are not implemented yet; the operation checklist,
+`docs/excel_checklist.csv`, records each member's status.
 
 **Typing.** A string written through `Value`, `Value2`, `Formula` or an
 array is typed the way Excel types what someone enters in a cell, and a
 Date or Currency a macro computes brings a format of its own. 3,723
 writes in live Excel pin the rules (`tests/fixtures/value_typing.json`,
 `tests/fixtures/typing_formats.json`), with 49 more in a workbook Excel
-saved (`tests/fixtures/typing/`).
+saved (`tests/fixtures/typing/`) and 911 dates and times in
+`tests/fixtures/typed_dates.json`.
 
 * `"5%"` is 0.05 in the 0% format, `"$1,000.50"` a dollar amount,
   `"1e3"` scientific, `"1 3/16"` a fraction, `"12:30:45.5"` a time to the
   tenth of a second, and `"1/2"` the second of January this year. Dates
   run month first on Excel's own calendar, which has a 29 February 1900,
   from 1900 to 9999; a date that does not exist stays text.
+* A month's name may stand before or after its day, parted from it by a
+  slash, a dash, a space or nothing, and a date and a time may come
+  either way round, with numbers after them read past. A space before a
+  date or a time keeps it text, except before a day and a month's name.
+  Excel misreads a space before a month's name and a time, and digits
+  after AM or PM and a point, into numbers; those report themselves
+  unsupported.
 * A cell keeps its own format unless it is General, or one of Excel's
   built-in currency, accounting, percent, scientific, fraction, date and
   time formats and the typed value is of another kind; a number with
@@ -1209,6 +1338,48 @@ a workbook Excel saved opens with its notes and saves them back as they
 came. Sorting or removing duplicates over a note, and threaded comments,
 report themselves unsupported.
 
+**Hyperlinks.** `Worksheet.Hyperlinks`, `Range.Hyperlinks`,
+`Range.ClearHyperlinks` and the `Hyperlink` object answer as Excel's do
+(`tests/fixtures/hyperlinks/`, 26 sections of live Excel and the 21
+workbooks it saved along the way; `_hyperlinks`, `_hyperlinks_file`).
+`Hyperlinks.Add` puts a link on each area of its anchor and answers the
+last; one over the very cells of a link takes that link's place in the
+list, one over any other cells goes at the end, overlapping or not. The
+anchor's cells take the style named Hyperlink, the built-in one made the
+first time among the styles a session makes, and the first cell the
+text to show or, when it is empty, the address, a number staying a
+number. An address is kept as Excel tidies it: spaces round it and tabs
+in it dropped, a `#` splitting off the subaddress, an http, https or ftp
+address's scheme and host in lower case, its path's `.` and `..`
+resolved and its escapes of letters, digits and spaces undone; `file:///C:/x`
+becomes `C:\x`. A link is named by the text to show it was given, or by
+"address - subaddress", which follows a new address; one read from a
+file without a display is named by its cell's text until a new address
+names it. `TextToDisplay` reads the first cell's text, "" for a number or
+a formula. Setting `SubAddress` takes the address away, and `Address`
+keeps the subaddress unless the new one has a `#` of its own.
+`EmailSubject` is a mailto address's subject, which setting it writes in.
+A range's collection holds the links inside one of its areas, and for a
+range of one area the link it lies in; `Clear`, `ClearContents`, an empty
+value, `ClearHyperlinks` and a copy landing on them take those links
+away, and `Delete` takes them with their cells' formats, merges kept. A
+copy or a paste of everything brings the links it meets over the cells it
+copies, a cut moves them in place, inserts and deletes move them as they
+move a reference, a sort moves a link one line high with its line, and a
+copy of the sheet has them all. On a protected sheet a link needs
+AllowInsertingHyperlinks and unlocked cells. A formula whose first
+function is HYPERLINK gives its cells the Hyperlink style. A save writes
+the hyperlinks element as Excel does, with a display where the name is
+not the text the cell holds, and each address as a relationship's
+target, escaped as Excel escapes it, a DOS path relative to the
+workbook's folder; the relationships number the links first, and a
+part's relationships come in the order Office lists them, a table
+placing each id by its characters in base 101 through a step of C's
+`rand()` (`pyopenvba._relationships`, measured to 65,530). A link on a shape,
+`EmailSubject` set on a link with no address -- which leaves Excel
+refusing every change after it -- and `Follow` report themselves
+unsupported.
+
 **Windows and sheet views.** `ActiveWindow`, `Windows`,
 `Workbook.Windows` and `Goto` behave as Excel does with its window shown
 (`tests/fixtures/windows/`, 113 workbooks). Each sheet has its own view,
@@ -1418,6 +1589,9 @@ macros, which the model does not write.
 | `apps/excel/_dimensions.py` | Row heights, column widths and hidden rows and columns, on a 96-DPI display |
 | `apps/excel/_row_formats.py` | Formats a whole row, a whole column or the whole sheet carries, and how a change spreads |
 | `apps/excel/_font_rows.py` | How tall each measured font makes a row, baked from `tests/fixtures/font_rows.json` |
+| `apps/excel/_hyperlinks.py` | A sheet's hyperlinks, as a macro reaches them, and what edits do to them |
+| `apps/excel/_hyperlinks_file.py` | Hyperlink addresses as Excel keeps and saves them, and the sheet's hyperlinks element |
+| `_relationships.py` | The order Office writes a part's relationships in |
 | `apps/word/` | Word's object model, its bridge and its file |
 | `apps/powerpoint/` | PowerPoint's, the same three |
 | `shapes/_values.py` | What a shape is, in all three hosts' words |

{pyopenvba-6.1.3 → pyopenvba-6.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pyOpenVBA"
-version = "6.1.3"
+version = "6.2.0"
 description = "Read and write VBA macros and Excel Power Query in pure Python, no dependencies."
 readme = "README.md"
 license = { text = "MIT" }

{pyopenvba-6.1.3 → pyopenvba-6.2.0}/src/pyopenvba/__init__.py

@@ -293,4 +293,4 @@ def push_power_query(
     """
     return _push_queries(src_dir, workbook, out=out, encoding=encoding, remove_missing=remove_missing)
 
-__version__ = "6.1.3"
+__version__ = "6.2.0"

pyopenvba-6.2.0/src/pyopenvba/_relationships.py

@@ -0,0 +1,90 @@
+"""The order Office writes a part's relationships in.
+
+Excel, and PowerPoint with it, writes each ``.rels`` part in the order a
+linear-hashing table keyed by the relationship ids iterates. Measured by
+saving sheets holding every count of hyperlinks from 1 to 160 and larger
+counts up to 65,530, the most a sheet holds, one relationship each
+(scripts/measure_relationship_order.py):
+
+- An id's hash is its characters read as a number in base 101, the
+  textbook string hash, put through one step of C's rand() generator:
+  (h * 1103515245 + 12345) >> 16, in 32 bits.
+- The table starts with 8 buckets. Before an insert that would put more
+  than 4 ids per bucket it splits one bucket, p, the next in turn, into p
+  and p + L (L the buckets before this round of splits began), the ids
+  whose next hash bit is set moving to the new bucket, in their order. An
+  id's bucket is its hash mod L, or mod 2L while that is below the split
+  pointer.
+- It is read bucket by bucket, each bucket's ids in the order they went
+  in; Office puts them in as rId1, rId2 and so on.
+
+This reproduces all 177 measured orders, and each part Office wrote in the
+tests' fixtures. They reach 16,384 buckets, the hash's low 14 bits; a
+part of more than 65,536 relationships, whose order they cannot vouch
+for, keeps the order it has, as does one whose ids are not all rId and a
+number.
+"""
+
+from __future__ import annotations
+
+import math
+import re
+from typing import Final
+
+#: The buckets the table starts with, and the ids per bucket past which it splits one.
+_START: Final = 8
+_LOAD: Final = 4
+#: The most relationships a part can hold for the order to be the measured one: 16,384 buckets.
+_MOST: Final = 65536
+_RELATIONSHIP = re.compile(r"<Relationship\b[^>]*?(?:/>|>\s*</Relationship>)")
+#: An id Office numbers: rId and a number, written as a number is, with no leading zero.
+_ID = re.compile(r'\bId="rId(0|[1-9]\d*)"')
+
+
+def id_hash(identifier: str) -> int:
+    """The hash Office's table places a relationship id by: base 101, then a step of C's rand() generator."""
+    h = 0
+    for character in identifier:
+        h = (h * 101 + ord(character)) & 0xFFFFFFFF
+    return ((h * 1103515245 + 12345) & 0xFFFFFFFF) >> 16
+
+
+def bucket_order(numbers: list[int]) -> list[int] | None:
+    """The ids rId<number>, by their numbers, in the order Office writes them; None where the order is not
+    known."""
+    if not numbers or len(numbers) > _MOST or any(number < 0 for number in numbers):
+        return None
+    buckets = max(_START, math.ceil(len(numbers) / _LOAD))
+    level = _START
+    while level * 2 <= buckets:
+        level *= 2
+    split = buckets - level
+
+    def bucket(number: int) -> int:
+        hashed = id_hash(f"rId{number}")
+        home = hashed % level
+        return hashed % (2 * level) if home < split else home
+
+    return sorted(numbers, key=lambda number: (bucket(number), number))
+
+
+def in_office_order(text: str) -> str:
+    """A ``.rels`` part with its relationships in the order Office writes them, where the order is known."""
+    elements = _RELATIONSHIP.findall(text)
+    numbers: list[int] = []
+    for element in elements:
+        found = _ID.search(element)
+        if found is None:
+            return text
+        numbers.append(int(found.group(1)))
+    if len(set(numbers)) != len(numbers):
+        return text
+    order = bucket_order(numbers)
+    if order is None:
+        return text
+    by_number = dict(zip(numbers, elements, strict=True))
+    start = text.find(elements[0])
+    end = text.rfind(elements[-1]) + len(elements[-1])
+    if start < 0 or "".join(elements) != text[start:end]:
+        return text
+    return text[:start] + "".join(by_number[number] for number in order) + text[end:]