Skip to main content

Calling routines in Windows DLLs from Python scripts running under Linux, MacOS or BSD

Project description

zugbruecke

zugbruecke

Calling routines in Windows DLLs from Python scripts running under Linux, MacOS or BSD

/ˈt͡suːkˌbʁʏkə/ (German, noun, feminine: drawbridge)

build_master docs_master license status pypi_version pypi_versions chat mailing_list

Synopsis

zugbruecke is an EXPERIMENTAL Python package (currently in development status 3/alpha). It allows to call routines in Windows DLLs from Python code running on Unices / Unix-like systems such as Linux, MacOS or BSD. zugbruecke is designed as a drop-in replacement for Python's standard library's ctypes module. zugbruecke is built on top of Wine. A stand-alone Windows Python interpreter launched in the background is used to execute the called DLL routines. Communication between the Unix-side and the Windows/Wine-side is based on Python's build-in multiprocessing connection capability. zugbruecke has (limited) support for pointers, struct types and call-back functions. zugbruecke comes with extensive logging features allowing to debug problems associated with both itself and with Wine. zugbruecke is written using Python 3 syntax and primarily targets the CPython implementation of Python.

About Wine (from winehq.org): Wine (originally an acronym for "Wine Is Not an Emulator") is a compatibility layer capable of running Windows applications on several POSIX-compliant operating systems, such as Linux, MacOS and BSD. Instead of simulating internal Windows logic like a virtual machine or emulator, Wine translates Windows API calls into POSIX calls on-the-fly, eliminating the performance and memory penalties of other methods and allowing you to cleanly integrate Windows applications into your desktop.

This project is NEITHER associated NOR affiliated in any way or form with the Wine project.

Prerequisites

type prerequisite version
user CPython 3.x (tested with 3.{7,8,9,10})
user Wine >= 6.x (tested with regular & staging) - expected to be in the user's PATH
developer mingw cross-compiler For building DLLs against which examples and tests can be run. Latest stable release.

Installation

branch status installation documentation
master (release) build_master pip install zugbruecke docs_master
develop build_develop pip install git+https://github.com/pleiszenburg/zugbruecke.git@develop docs_develop

After installing the package with pip, you may choose to manually initialize the Wine Python environment by running wenv init. If you choose not to do this, zugbruecke will take care of it during its first use.

Example

Start an interactive Python session on your favorite Unix(-like) operating system and try the following:

import zugbruecke.ctypes as ctypes
dll_pow = ctypes.cdll.msvcrt.pow
dll_pow.argtypes = (ctypes.c_double, ctypes.c_double)
dll_pow.restype = ctypes.c_double
print(f'You should expect "1024.0" to show up here: "{dll_pow(2.0, 10.0):.1f}".')

You have just witnessed msvcrt.dll, Microsoft's C standard library (or Wine's implementation of it), in action on Unix.

Interested in more?

A lot of code, which was written with ctypes' cdll, windll or oledll in mind and which runs under Windows, should run just fine with zugbruecke on Unix (assuming it does not use Windows features not supported by Wine). For more complex calls, memory synchronization is potentially necessary.

Speed

zugbruecke performs reasonably well given its complexity with less than 0.2 µs overhead per call in average on modern hardware. It is not (yet) optimized for speed. Check the latest benchmarks for more details.

Security

zugbruecke is notoriously insecure. Never, ever, run it with root / super users privileges! Do not use it where security matters! For details, check the section on security in the documentation.

Need help?

See section on Getting Help on zugbruecke's documentation.

Bugs & Issues

See section on Bugs and Issues on zugbruecke's documentation.

Miscellaneous

For production environments

DO NOT run this code (as-is) in production environments unless you feel that you really know what you are doing (or unless you are absolutely desperate)! Being experimental in nature and of alpha quality, it is prone to fail in a number of unpredictable ways, some of which might not be obvious or might not even show any (intermediately) recognizable symptoms at all! You might end up with plain wrong, nonsensical results without noticing it! Verify and cross-check your results!

zugbruecke is using semantic versioning. Breaking changes are indicated by increasing the second version number, the minor version. Going for example from 0.0.x to 0.1.y or going from 0.1.x to 0.2.y therefore indicates a breaking change. For as long as zugbruecke has development status "alpha", please expect more breaking changes to come.

If you are relying on zugbruecke in one way or another, please consider monitoring the project: its repository on Github, its mailing list and its chatroom.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

zugbruecke-0.1.0.tar.gz (138.4 kB view details)

Uploaded Source

Built Distribution

zugbruecke-0.1.0-py3-none-any.whl (78.4 kB view details)

Uploaded Python 3

File details

Details for the file zugbruecke-0.1.0.tar.gz.

File metadata

  • Download URL: zugbruecke-0.1.0.tar.gz
  • Upload date:
  • Size: 138.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.10.6

File hashes

Hashes for zugbruecke-0.1.0.tar.gz
Algorithm Hash digest
SHA256 b741514b46ad438aa3b0dd666418875e93bbb108a3b435cb290a55827ea1e4da
MD5 b508b570bfcb5323708e0de34b74e6d3
BLAKE2b-256 29f984b83aaf89041689ad3da07ac4b8eb131a939fed6e75efd3b27cc631c67d

See more details on using hashes here.

File details

Details for the file zugbruecke-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: zugbruecke-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 78.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.10.6

File hashes

Hashes for zugbruecke-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e5b2f80b0204b9d2f8abed5d3ec47e4759e57f52118004d1cab8e5857cbd863c
MD5 986c7701d9b1039a279f6f0b94b25b34
BLAKE2b-256 668325f38cd404cca71e1b3a45f145f5c33379fa0092aab7f7eae35eb2d8e024

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page