winmd2py 0.1.0__tar.gz

winmd2py-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mahmoud Komaiha
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

winmd2py-0.1.0/PKG-INFO

@@ -0,0 +1,67 @@
+Metadata-Version: 2.4
+Name: winmd2py
+Version: 0.1.0
+Summary: Generate ctypes bindings for classic COM interfaces from .winmd metadata, in pure Python
+Author-email: Mahmoud Komaiha <mkomaiha@umich.edu>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/mkomaiha/portacom
+Project-URL: Repository, https://github.com/mkomaiha/portacom
+Project-URL: Issues, https://github.com/mkomaiha/portacom/issues
+Project-URL: Changelog, https://github.com/mkomaiha/portacom/blob/main/CHANGELOG.md
+Keywords: com,ctypes,winmd,win32metadata,bindings,code generator
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: runtime
+Requires-Dist: portacom<0.2,>=0.1; extra == "runtime"
+Dynamic: license-file
+
+# winmd2py
+
+Generates [portacom](https://pypi.org/project/portacom/) ctypes bindings from
+a `.winmd` file in the Win32 metadata format, in pure Python (no .NET).
+
+```bash
+pip install "winmd2py[runtime]"  # the generator, and portacom, which the bindings import
+winmd2py Windows.Win32.winmd -n Windows.Win32.Graphics.Direct3D.Dxc -o bindings
+winmd2py Microsoft.Direct3D.D3D12.winmd --ref Windows.Win32.winmd -o d3d12
+```
+
+or from Python:
+
+```python
+import winmd2py
+
+winmd2py.generate("Microsoft.Direct3D.D3D12.winmd", "d3d12", refs=["Windows.Win32.winmd"])
+```
+
+- `--ref OTHER.winmd` (repeatable) is a file whose types the input uses. Since
+  Win32Metadata 71, D3D12 is in `Microsoft.Direct3D.D3D12.winmd` and uses
+  `Windows.Win32.winmd`'s types. What is used from a reference file is
+  generated too, into partial modules, so the output needs nothing else.
+- Without the file that declares a type, a struct that holds it by value, or an
+  interface derived from it, still imports but raises `TypeError` when used,
+  and the generator says which file to pass with `--ref`.
+- Types and functions that the metadata declares once per architecture (x86,
+  x64, ARM64) are declared once; what differs is chosen on import by
+  `portacom.ARCH`.
+- Delegates become classes with their signatures, so callbacks take Python
+  callables; one whose signature can't be described is passed as `void*`, and
+  reported.
+
+The bindings follow the Windows ABI that the metadata describes. For a library
+built differently off Windows, declare how with `portacom.use_abi()` before
+importing them. See the
+[project README](https://github.com/mkomaiha/portacom#readme), which also says
+what a `.winmd` for your own IDL needs.

winmd2py-0.1.0/README.md

@@ -0,0 +1,38 @@
+# winmd2py
+
+Generates [portacom](https://pypi.org/project/portacom/) ctypes bindings from
+a `.winmd` file in the Win32 metadata format, in pure Python (no .NET).
+
+```bash
+pip install "winmd2py[runtime]"  # the generator, and portacom, which the bindings import
+winmd2py Windows.Win32.winmd -n Windows.Win32.Graphics.Direct3D.Dxc -o bindings
+winmd2py Microsoft.Direct3D.D3D12.winmd --ref Windows.Win32.winmd -o d3d12
+```
+
+or from Python:
+
+```python
+import winmd2py
+
+winmd2py.generate("Microsoft.Direct3D.D3D12.winmd", "d3d12", refs=["Windows.Win32.winmd"])
+```
+
+- `--ref OTHER.winmd` (repeatable) is a file whose types the input uses. Since
+  Win32Metadata 71, D3D12 is in `Microsoft.Direct3D.D3D12.winmd` and uses
+  `Windows.Win32.winmd`'s types. What is used from a reference file is
+  generated too, into partial modules, so the output needs nothing else.
+- Without the file that declares a type, a struct that holds it by value, or an
+  interface derived from it, still imports but raises `TypeError` when used,
+  and the generator says which file to pass with `--ref`.
+- Types and functions that the metadata declares once per architecture (x86,
+  x64, ARM64) are declared once; what differs is chosen on import by
+  `portacom.ARCH`.
+- Delegates become classes with their signatures, so callbacks take Python
+  callables; one whose signature can't be described is passed as `void*`, and
+  reported.
+
+The bindings follow the Windows ABI that the metadata describes. For a library
+built differently off Windows, declare how with `portacom.use_abi()` before
+importing them. See the
+[project README](https://github.com/mkomaiha/portacom#readme), which also says
+what a `.winmd` for your own IDL needs.

winmd2py-0.1.0/pyproject.toml

@@ -0,0 +1,43 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "winmd2py"
+version = "0.1.0"
+description = "Generate ctypes bindings for classic COM interfaces from .winmd metadata, in pure Python"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Mahmoud Komaiha", email = "mkomaiha@umich.edu" }]
+requires-python = ">=3.10"
+dependencies = []
+keywords = ["com", "ctypes", "winmd", "win32metadata", "bindings", "code generator"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: MacOS",
+    "Topic :: Software Development :: Code Generators",
+]
+
+[project.optional-dependencies]
+runtime = ["portacom>=0.1,<0.2"]
+
+[project.urls]
+Homepage = "https://github.com/mkomaiha/portacom"
+Repository = "https://github.com/mkomaiha/portacom"
+Issues = "https://github.com/mkomaiha/portacom/issues"
+Changelog = "https://github.com/mkomaiha/portacom/blob/main/CHANGELOG.md"
+
+[project.scripts]
+winmd2py = "winmd2py.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

winmd2py-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

winmd2py-0.1.0/src/winmd2py/__init__.py

@@ -0,0 +1,11 @@
+"""winmd2py: generate portacom ctypes bindings from a .winmd file, in pure Python.
+
+winmd2py.generate("Windows.Win32.winmd", "bindings", ["Windows.Win32.Graphics.Direct3D.Dxc"])
+writes the bindings of that namespace, and of what it uses, as the package "bindings".
+"""
+
+__version__ = "0.1.0"
+
+from .emit import Generator, generate  # noqa: E402  (emit reads __version__)
+
+__all__ = ["generate", "Generator", "__version__"]

winmd2py-0.1.0/src/winmd2py/__main__.py

@@ -0,0 +1,3 @@
+from .cli import main
+
+raise SystemExit(main())

winmd2py-0.1.0/src/winmd2py/cli.py

@@ -0,0 +1,58 @@
+"""winmd2py FILE.winmd [-n NAMESPACE ...] [--ref OTHER.winmd ...] -o OUTDIR"""
+
+import argparse
+import sys
+import time
+
+from . import __version__
+from .emit import Generator
+from .model import WinMD
+
+
+def main(argv=None):
+    parser = argparse.ArgumentParser(
+        prog="winmd2py",
+        description="Generate portacom ctypes bindings for classic COM interfaces from a .winmd file. "
+        "The bindings follow the Windows ABI the metadata describes; for a library built differently, "
+        "call portacom.use_abi() before importing them.",
+    )
+    parser.add_argument("winmd", help="the .winmd file (Win32 metadata format)")
+    parser.add_argument(
+        "-n",
+        "--namespace",
+        action="append",
+        dest="namespaces",
+        help="namespace to generate (repeatable; default: all namespaces in the file)",
+    )
+    parser.add_argument(
+        "--ref",
+        action="append",
+        default=[],
+        metavar="OTHER.winmd",
+        help="a .winmd whose types the file uses, such as Windows.Win32.winmd for "
+        "Microsoft.Direct3D.D3D12.winmd (repeatable); what is used from it is generated too",
+    )
+    parser.add_argument("-o", "--outdir", help="output package directory")
+    parser.add_argument("--list", action="store_true", help="list the namespaces in the file and exit")
+    parser.add_argument("-q", "--quiet", action="store_true", help="do not print what was left out or simplified")
+    parser.add_argument("--version", action="version", version=f"winmd2py {__version__}")
+    args = parser.parse_args(argv)
+    if not args.list and not args.outdir:
+        parser.error("-o/--outdir is required")
+
+    start = time.time()
+    try:
+        if args.list:
+            for ns in WinMD(args.winmd).namespaces():
+                print(ns)
+            return 0
+        generator = Generator(args.winmd, args.namespaces, refs=args.ref)
+        written = generator.generate(args.outdir)
+    except (OSError, ValueError) as error:
+        print(f"winmd2py: error: {error}", file=sys.stderr)
+        return 1
+    if not args.quiet:
+        for note in generator.notes:
+            print(f"winmd2py: {note}", file=sys.stderr)
+    print(f"winmd2py: wrote {len(written)} modules to {args.outdir} in {time.time() - start:.1f}s")
+    return 0