pyOpenVBA 2.0.0__tar.gz → 2.0.1__tar.gz

{pyopenvba-2.0.0 → pyopenvba-2.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyOpenVBA
-Version: 2.0.0
+Version: 2.0.1
 Summary: Read and write VBA macros inside Excel, Word, and PowerPoint files in pure Python, no dependencies.
 Project-URL: Homepage, https://github.com/WilliamSmithEdward/pyOpenVBA
 Project-URL: Repository, https://github.com/WilliamSmithEdward/pyOpenVBA
@@ -39,7 +39,7 @@ Description-Content-Type: text/markdown
 [![PyPI version](https://img.shields.io/pypi/v/pyOpenVBA.svg)](https://pypi.org/project/pyOpenVBA/)
 [![Python versions](https://img.shields.io/pypi/pyversions/pyOpenVBA.svg)](https://pypi.org/project/pyOpenVBA/)
 [![CI](https://github.com/WilliamSmithEdward/pyOpenVBA/actions/workflows/ci.yml/badge.svg)](https://github.com/WilliamSmithEdward/pyOpenVBA/actions/workflows/ci.yml)
-[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE.md)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/WilliamSmithEdward/pyOpenVBA/blob/main/LICENSE.md)
 [![Downloads](https://img.shields.io/pypi/dm/pyOpenVBA.svg)](https://pypi.org/project/pyOpenVBA/)
 
 **Read and write VBA macros inside Excel, Word, and PowerPoint files, in pure Python.**
@@ -226,18 +226,9 @@ with ExcelFile("workbook.xlsm") as wb:
         kind=VBAModuleKind.standard,
     )
 
-    # Add a class module (VB_Base attribute is required)
-    _CLASS_VB_BASE = "0{FCFB3D2A-A0FA-1068-A738-08002B3371B5}"
+    # Add a class module (header is synthesized automatically)
     project.add_module(
         "MyClass",
-        f'Attribute VB_Name = "MyClass"\r\n'
-        f'Attribute VB_Base = "{_CLASS_VB_BASE}"\r\n'
-        "Attribute VB_GlobalNameSpace = False\r\n"
-        "Attribute VB_Creatable = False\r\n"
-        "Attribute VB_PredeclaredId = False\r\n"
-        "Attribute VB_Exposed = False\r\n"
-        "Attribute VB_TemplateDerived = False\r\n"
-        "Attribute VB_Customizable = False\r\n"
         "Option Explicit\r\n",
         kind=VBAModuleKind.other,
     )
@@ -385,7 +376,7 @@ following are preserved byte-for-byte but not interpreted:
 - Re-signing digitally signed projects.
 - ActiveX license editing.
 
-See [docs/roadmap.md](docs/roadmap.md) for the full feature matrix.
+See [docs/roadmap.md](https://github.com/WilliamSmithEdward/pyOpenVBA/blob/main/docs/roadmap.md) for the full feature matrix.
 
 ---
 
@@ -395,7 +386,7 @@ See [docs/roadmap.md](docs/roadmap.md) for the full feature matrix.
 src/pyopenvba/
   __init__.py     public API (ExcelFile, WordFile, PowerPointFile,
                               pull/push, pull_word/push_word, pull_ppt/push_ppt,
-                              VBAModuleKind, exceptions)
+                              VBAModuleKind, synthesize_class_header, exceptions)
   excel.py        ExcelFile facade (ZIP / CFB dispatch, pull/push helpers)
   word.py         WordFile facade
   powerpoint.py   PowerPointFile facade
@@ -408,10 +399,10 @@ src/pyopenvba/
 
 For deeper documentation:
 
-- [docs/architecture.md](docs/architecture.md) - internal module layout.
-- [docs/ms-ovba-implementation-guide_v2.md](docs/ms-ovba-implementation-guide_v2.md) -
+- [docs/architecture.md](https://github.com/WilliamSmithEdward/pyOpenVBA/blob/main/docs/architecture.md) - internal module layout.
+- [docs/ms-ovba-implementation-guide_v2.md](https://github.com/WilliamSmithEdward/pyOpenVBA/blob/main/docs/ms-ovba-implementation-guide_v2.md) -
   language-agnostic guide for re-implementing MS-OVBA in another language.
-- [docs/roadmap.md](docs/roadmap.md) - per-feature implementation status.
+- [docs/roadmap.md](https://github.com/WilliamSmithEdward/pyOpenVBA/blob/main/docs/roadmap.md) - per-feature implementation status.
 
 ---
 
@@ -438,4 +429,4 @@ pushed.
 
 ## License
 
-[MIT](LICENSE.md).
+[MIT](https://github.com/WilliamSmithEdward/pyOpenVBA/blob/main/LICENSE.md).

{pyopenvba-2.0.0 → pyopenvba-2.0.1}/README.md

@@ -3,7 +3,7 @@
 [![PyPI version](https://img.shields.io/pypi/v/pyOpenVBA.svg)](https://pypi.org/project/pyOpenVBA/)
 [![Python versions](https://img.shields.io/pypi/pyversions/pyOpenVBA.svg)](https://pypi.org/project/pyOpenVBA/)
 [![CI](https://github.com/WilliamSmithEdward/pyOpenVBA/actions/workflows/ci.yml/badge.svg)](https://github.com/WilliamSmithEdward/pyOpenVBA/actions/workflows/ci.yml)
-[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE.md)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/WilliamSmithEdward/pyOpenVBA/blob/main/LICENSE.md)
 [![Downloads](https://img.shields.io/pypi/dm/pyOpenVBA.svg)](https://pypi.org/project/pyOpenVBA/)
 
 **Read and write VBA macros inside Excel, Word, and PowerPoint files, in pure Python.**
@@ -190,18 +190,9 @@ with ExcelFile("workbook.xlsm") as wb:
         kind=VBAModuleKind.standard,
     )
 
-    # Add a class module (VB_Base attribute is required)
-    _CLASS_VB_BASE = "0{FCFB3D2A-A0FA-1068-A738-08002B3371B5}"
+    # Add a class module (header is synthesized automatically)
     project.add_module(
         "MyClass",
-        f'Attribute VB_Name = "MyClass"\r\n'
-        f'Attribute VB_Base = "{_CLASS_VB_BASE}"\r\n'
-        "Attribute VB_GlobalNameSpace = False\r\n"
-        "Attribute VB_Creatable = False\r\n"
-        "Attribute VB_PredeclaredId = False\r\n"
-        "Attribute VB_Exposed = False\r\n"
-        "Attribute VB_TemplateDerived = False\r\n"
-        "Attribute VB_Customizable = False\r\n"
         "Option Explicit\r\n",
         kind=VBAModuleKind.other,
     )
@@ -349,7 +340,7 @@ following are preserved byte-for-byte but not interpreted:
 - Re-signing digitally signed projects.
 - ActiveX license editing.
 
-See [docs/roadmap.md](docs/roadmap.md) for the full feature matrix.
+See [docs/roadmap.md](https://github.com/WilliamSmithEdward/pyOpenVBA/blob/main/docs/roadmap.md) for the full feature matrix.
 
 ---
 
@@ -359,7 +350,7 @@ See [docs/roadmap.md](docs/roadmap.md) for the full feature matrix.
 src/pyopenvba/
   __init__.py     public API (ExcelFile, WordFile, PowerPointFile,
                               pull/push, pull_word/push_word, pull_ppt/push_ppt,
-                              VBAModuleKind, exceptions)
+                              VBAModuleKind, synthesize_class_header, exceptions)
   excel.py        ExcelFile facade (ZIP / CFB dispatch, pull/push helpers)
   word.py         WordFile facade
   powerpoint.py   PowerPointFile facade
@@ -372,10 +363,10 @@ src/pyopenvba/
 
 For deeper documentation:
 
-- [docs/architecture.md](docs/architecture.md) - internal module layout.
-- [docs/ms-ovba-implementation-guide_v2.md](docs/ms-ovba-implementation-guide_v2.md) -
+- [docs/architecture.md](https://github.com/WilliamSmithEdward/pyOpenVBA/blob/main/docs/architecture.md) - internal module layout.
+- [docs/ms-ovba-implementation-guide_v2.md](https://github.com/WilliamSmithEdward/pyOpenVBA/blob/main/docs/ms-ovba-implementation-guide_v2.md) -
   language-agnostic guide for re-implementing MS-OVBA in another language.
-- [docs/roadmap.md](docs/roadmap.md) - per-feature implementation status.
+- [docs/roadmap.md](https://github.com/WilliamSmithEdward/pyOpenVBA/blob/main/docs/roadmap.md) - per-feature implementation status.
 
 ---
 
@@ -402,4 +393,4 @@ pushed.
 
 ## License
 
-[MIT](LICENSE.md).
+[MIT](https://github.com/WilliamSmithEdward/pyOpenVBA/blob/main/LICENSE.md).

{pyopenvba-2.0.0 → pyopenvba-2.0.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pyOpenVBA"
-version = "2.0.0"
+version = "2.0.1"
 description = "Read and write VBA macros inside Excel, Word, and PowerPoint files in pure Python, no dependencies."
 readme = "README.md"
 license = { text = "MIT" }

{pyopenvba-2.0.0 → pyopenvba-2.0.1}/src/pyopenvba/__init__.py

@@ -58,7 +58,7 @@ from pyopenvba.exceptions import (
     VBAProjectError,
     UnsupportedFormatError,
 )
-from pyopenvba.vba import VBAModuleKind
+from pyopenvba.vba import VBAModuleKind, synthesize_class_header
 
 
 def pull(

{pyopenvba-2.0.0 → pyopenvba-2.0.1}/src/pyopenvba/vba.py

@@ -755,12 +755,14 @@ class VBAProject:
         elif kind == VBAModuleKind.standard:
             header = synthesize_standard_header(name)
             full_source = header + source
+        elif kind == VBAModuleKind.other:
+            header = synthesize_class_header(name)
+            full_source = header + source
         else:
             raise ValueError(
                 f"add_module(kind={kind.name}) requires the source to start "
-                "with its own attribute header (e.g. 'VERSION 1.0 CLASS' "
-                "for a class module).  pyOpenVBA does not invent class or "
-                "document module headers."
+                "with its own attribute header.  pyOpenVBA does not invent "
+                "document or designer module headers."
             )
 
         module = VBAModule(
@@ -981,6 +983,33 @@ def synthesize_standard_header(name: str) -> str:
     return f'Attribute VB_Name = "{name}"\r\n'
 
 
+# Universal CLSID for plain VBA class modules (not document/designer modules).
+_CLASS_MODULE_CLSID = "0{FCFB3D2A-A0FA-1068-A738-08002B3371B5}"
+
+
+def synthesize_class_header(name: str) -> str:
+    """Return the standard attribute header for a new plain class module.
+
+    Uses the universal VBA class CLSID as ``VB_Base`` and the conventional
+    default values for all other class attributes.  This header is equivalent
+    to what VBE emits when you insert a new Class Module.
+
+    Only suitable for plain class modules.  Document modules (ThisWorkbook,
+    Sheet1, ThisDocument, etc.) and designer modules (UserForms) carry host-
+    specific CLSIDs and must be provided with an explicit attribute header.
+    """
+    return (
+        f'Attribute VB_Name = "{name}"\r\n'
+        f'Attribute VB_Base = "{_CLASS_MODULE_CLSID}"\r\n'
+        'Attribute VB_GlobalNameSpace = False\r\n'
+        'Attribute VB_Creatable = False\r\n'
+        'Attribute VB_PredeclaredId = False\r\n'
+        'Attribute VB_Exposed = False\r\n'
+        'Attribute VB_TemplateDerived = False\r\n'
+        'Attribute VB_Customizable = False\r\n'
+    )
+
+
 def rebuild_module_stream(module: VBAModule, code_page: int) -> bytes:
     """
     Rebuild a module stream by preserving the original ``[0:text_offset]``